morphyDocs

Troubleshooting

Fixes for the problems people run into most, from installing to chats that won't answer.

Can't find your problem here? Ask in the Discord or email casper.apers@gmail.com. Attaching Morphy's log file helps a lot: it's %APPDATA%\Morphy\logs\morphy.log on Windows and ~/Library/Application Support/Morphy/logs/morphy.log on a Mac.

Installing and signing in

Windows says "Windows protected your PC"

Morphy is signed, so Windows normally opens its installer straight away, but some PCs can still show this screen. Click More info and check that it says Publisher: Apers, the name Morphy is signed with, then click Run anyway. If it says Unknown publisher, don't run it: download Morphy again from get.appmorphy.com. Check your download shows other ways to check it.

macOS asks "Are you sure you want to open it?"

That's normal the first time you open any app you downloaded. Click Open. It only asks once.

My browser warns about the download

Some browsers flag files they haven't seen often. Choose to keep the file (in Edge: … → Keep; in Chrome: Keep). The installer comes straight from Morphy's GitHub releases, signed by Apers.

My antivirus blocked or removed Morphy (Windows)

Some antivirus programs are careful with apps they haven't seen often, even signed ones like Morphy. If the installer is signed by Apers (Check your download), it's a false alarm: restore Morphy from quarantine and allow it, or add an exception for %LOCALAPPDATA%\Programs\morphy, and tell us which antivirus it was, so we can report it. If Keep processor cores free is on in Settings → General, try turning it off: some antivirus programs dislike how it works.

Morphy closed while I was signing in

Closing the sign-in window before you're signed in closes Morphy. Open it again and sign in.

The sign-in doesn't come back to Morphy

  • Wait a few seconds and click Open Google again (or Open GitHub again), for example if you closed the tab or Google showed "Access blocked".
  • "Morphy couldn't open your browser", or the browser opens the wrong place: click Copy the sign-in link, paste it into the address bar of any browser on this computer and sign in there. Morphy picks it up by itself.
  • "Sign-in failed: fetch failed" means Morphy couldn't reach its sign-in server. Check your internet connection, and that a firewall, VPN or proxy isn't blocking Morphy, then Try again.
  • "Your GitHub account has no verified email address": add and verify one on GitHub (Settings → Emails), then try again, or continue with Google.
  • Any other error: click Try again with Google (or with GitHub). If it keeps failing, let us know on Discord.

I signed in and my plan is gone

You probably signed in with the other one of Google and GitHub, and their email addresses differ, so Morphy made a new account. Sign out (Settings → Account → Sign out) and sign in the way you did before. Google and GitHub open the same account only when they share a verified email address. Any address verified on your GitHub account counts, not just the main one, and so does the same address written differently (capital letters, or a Gmail address with or without its dots).

Sign-in says "This version of Morphy is out of date"

You have an older version of Morphy, and it can't sign in new accounts. Download the newest from appmorphy.com, install it over the one you have, and sign in again.

Opening Morphy again does nothing

Morphy only runs once. Opening it again brings the window you already have to the front. Look for it on your taskbar, or in the Dock on a Mac.

Connecting your AI

A chat says an AI "isn't connected" or "isn't installed"

Click Open Settings → Account in the message, then Connect or follow the install steps on that AI's card. See Connect your AI. Morphy keeps the message you sent: once that AI is connected it goes out by itself (within half an hour; after that, send it again).

Claude says it "refused this sign-in"

Claude's sign-in expired, or Claude was signed out somewhere else, for example by signing in with another account in Claude Code. Morphy has already tried once more by itself. Click Open Settings → Account in the message, then Reconnect on the Claude card, and send your message again.

Claude waits because another Claude Code process is renewing its sign-in

Claude's sign-in renews itself every few hours. On the first message after a while, several Claude Code processes can try to renew it at once: Morphy runs one for each chat, and Claude Code in a terminal or an editor shares the same sign-in. When another one is renewing it, or stopped halfway, Claude waits for it, up to a minute, then answers. Nothing is wrong with your sign-in, and there's no need to reconnect. If Claude still can't renew it after that, send your message again in a minute.

A chat you open again later may show Claude Code's own words for this, "Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh", followed by "continue". That was the same wait: Morphy sent the "continue" itself.

Claude says Morphy's copy of Claude Code is missing ("native binary not found")

Morphy brings its own copy of Claude Code. Older versions of Morphy let that copy try to update itself, and on Windows an update could move it out of place. Since 0.1.15 it never updates itself, and Morphy puts a moved copy back by itself. Quit Morphy and open it again. If Claude still can't run, install Morphy again from appmorphy.com; your canvas and chats stay.

I installed a CLI, but Settings still says "Not installed"

Click Check again on the card. You don't need to restart Morphy. If it still isn't found, open a new terminal and check that the tool runs there (for example codex --version). If it doesn't, the install didn't finish or Node.js is missing.

Settings says Antigravity or OpenCode "Can't start"

Morphy found the AI's command-line tool (agy or opencode), but your computer wouldn't run it. The card shows the file Morphy found and the error, for example spawn UNKNOWN. Windows says this when the file isn't a working program, for example after an update or install that didn't finish. Your other AIs keep working.

Open a new terminal and run agy --version or opencode --version. If it fails there too, install the tool again (see Connect your AI), then click Check again. If it works in the terminal, compare the path the card shows with where your terminal's copy is (where agy or where opencode on Windows): Morphy may have found an older copy. Tell us on Discord either way.

OpenCode installed with pnpm or bun, or with npm while install scripts were turned off (ignore-scripts), doesn't run in a terminal: those skip OpenCode's install script. Morphy finds the working copy the package manager put beside it, so it still works in Morphy.

npm isn't recognised, or "command not found"

npm comes with Node.js. Install Node.js (LTS), open a new terminal, and run the command again.

PowerShell says "running scripts is disabled on this system" (Windows)

Windows doesn't let PowerShell run scripts by default, and in PowerShell npm is one. Type npm.cmd instead of npm, for example npm.cmd install -g @openai/codex. It's the same npm and works in any terminal. The terminal in Morphy's side dock doesn't have this problem.

Settings is stuck on "Signing in…"

Click Cancel on that AI's card, then Connect to try again. On Windows, closing the sign-in window also stops waiting. On a Mac, Morphy can't tell when you close the Terminal window, so use Cancel.

Claude signs in in your browser, with no window of its own. If its page didn't come up or you closed the tab, click Open it again on the card. If the page shows a code, paste it into the box on the card and click Sign in. Morphy waits up to 10 minutes, then says the sign-in didn't finish.

OpenRouter is connected, but its chats don't work

OpenRouter, Ollama and custom-provider chats run through the Codex CLI. Install it with npm install -g @openai/codex and try again.

"This model needs OpenRouter credits"

You picked a paid model. Add credits at openrouter.ai, or pick one of the free models at the top of the model list.

"… is rate-limiting this model (429 Too Many Requests)"

Free models only take a few requests a minute (some also a few a day), and an agent sends one for every step it takes. When the service says to slow down, Morphy waits and then carries on with the same message by itself; the chat's working line says rate limited · again in 20s. Press stop to end it. This works in Codex, OpenRouter, Ollama and custom-provider chats.

If the limit still holds after a few minutes, the chat stops and says so. Send your message again later, or pick another model. On OpenRouter, buying credits raises the free models' daily limit.

Ollama: "isn't running", "too old" or "no model that can use tools"

  • Start Ollama (or install it).
  • Update Ollama to 0.13 or newer.
  • Pull a model that can use tools: ollama pull gpt-oss:20b.
  • Answers stop halfway or forget things? Set Ollama's context length to 64k or more.

Antigravity says it "skipped a step that needs your approval"

Antigravity can't ask for permission inside Morphy. Under Permissions in the chat's model menu, set it to No guardrails, or Workspace write if it only needs to edit files (in Workspace write Antigravity can't run commands). See Permissions.

Codex says its default model isn't available on this account

Some plans can't use the model Codex picks by default. Morphy then runs your message on the next model your account has and keeps using it while the chat stays open, so you don't need to do anything. To choose a model yourself, pick one in the chat's model picker.

The same goes for a model you picked that your sign-in can't use (some models aren't available with a ChatGPT sign-in): Morphy runs that message on Codex's default instead, says so in the chat, and sets the chat's model picker back to default.

I hit a usage limit

Your AI plan's limit for now is used up. For Claude, Codex, Grok and Antigravity, Settings → Plan usage shows when it resets. The chat itself offers Send when it resets and Continue with another AI you have connected (more). When OpenAI has given your Codex account a free limit reset, the chat and Plan usage offer to use it. Or:

  • switch the chat to another AI (Provider in its model menu; the conversation goes along), or
  • sign in with another Claude, Codex or Grok account: Reconnect in Settings → Account. Morphy restarts its chats on the new account.
  • On OpenRouter, add credits or pick a free model.

Chats

A chat doesn't answer

  • If it shows No response for N minutes. Stop it, or keep waiting?, the agent may be stuck on a long task. Keep waiting, or Stop and ask again.
  • Press stop and send your message again. Stop always ends the turn within a few seconds, and the conversation is kept.
  • "… stopped. Send a message to start it again." Just send your message again.
  • "Stopped: the turn hit its step limit": the agent did a lot in one go. Type "continue" and it picks up where it left off.
  • "API Error: 529 Overloaded" or another "API Error" from Claude comes from Anthropic's side, not from Morphy. What each one means and what to do: Claude Code API errors and 529 Overloaded.

Codex says the conversation is open somewhere else

Codex lets one program at a time continue a conversation. When the chat's conversation is open in another chat on your canvas, or in Codex's own app, VS Code or a terminal, the chat doesn't send your message: close the conversation there (or quit that app) and send it again. The conversation stays this chat's and nothing is lost. To start over here instead, right-click the title bar and choose New conversation. Picking such a conversation in Conversations… says the same.

I can't close a chat

A chat can't be closed while its agent is working, so you don't lose work by accident. Stop it first, then close it.

My queued message is gone

Queued messages only live while Morphy is open. If Morphy restarted, send them again. Scheduled messages (Send later) are kept across restarts.

An agent did something I didn't want

In No guardrails an agent doesn't ask before it changes files or runs commands, and in Auto-accept edits it changes files without asking. To take back what a turn changed, use its undo icon (Undo a turn). To approve every change from now on, switch the chat (or the default, under Permissions in Settings → General → New chats) to Ask first. See Permissions.

Canvas and cards

I deleted a card or chat by accident

Press Ctrl + Z. If that's too late, press Ctrl + K and type its name: deleted items can be restored for 3 days.

A card disappeared

An agent may have hidden it. Press Ctrl + K and type its name: the palette lists every card, hidden ones too. Or an agent moved it to another project: the palette finds it there too.

The sidebar, tabs or dock are gone

You may be in Canvas only: click an empty spot on the canvas and press Esc. Otherwise, Ctrl + B brings back the sidebar and Ctrl + Shift + B the terminal and browser.

A shortcut does nothing

Most shortcuts don't work while the cursor is in a text box, like a chat or the terminal. Click an empty spot on the canvas and try again. On a Mac, press ⌘ where these docs say Ctrl. Zoom, Find, the command palette, Settings and Canvas only work everywhere. See Keyboard shortcuts.

My animated wallpaper doesn't move

In Settings → Personalization, look at the line under Quality (in Animation):

  • "Motion is set to Reduced above": set Animations under Motion back to Standard.
  • "Animated backgrounds is off under Motion → Advanced above": turn Animated backgrounds back on under Motion → Advanced.
  • "your computer asks apps for less motion": on Windows, turn animation effects back on in Windows Settings → Accessibility → Visual effects. On a Mac, turn off Reduce motion in System Settings → Accessibility → Display.
  • Otherwise your computer can't keep up with that shader. Set Quality to Light, or pick a lighter shader.

Shaders are always still in extra Morphy windows.

Morphy's window keeps crashing

Click Reload. Your agents keep running in the meantime. If it keeps happening, quit Morphy, open it again, and send us the log file (where it is: see the top of this page).

Morphy Remote

See If your phone can't connect.

Updates

How do I get the newest version?

Morphy downloads updates by itself while it's open. Once one is ready, click Restart to update at the bottom of the sidebar (or Restart now in Settings → General → Updates): Morphy installs it and opens again by itself, and a note at the bottom of the canvas says Updated to Morphy …. It also installs the next time you quit. If you quit before the download is done, it starts over the next time, so leave Morphy open for a few minutes. Your version is at the top of Settings → General.

If it says Couldn't download, Morphy tries again by itself after a while, or click Try again. You can also download the newest version from appmorphy.com and install it over the one you have; your canvas, chats and settings stay.

On this page

Installing and signing inWindows says "Windows protected your PC"macOS asks "Are you sure you want to open it?"My browser warns about the downloadMy antivirus blocked or removed Morphy (Windows)Morphy closed while I was signing inThe sign-in doesn't come back to MorphyI signed in and my plan is goneSign-in says "This version of Morphy is out of date"Opening Morphy again does nothingConnecting your AIA chat says an AI "isn't connected" or "isn't installed"Claude says it "refused this sign-in"Claude waits because another Claude Code process is renewing its sign-inClaude says Morphy's copy of Claude Code is missing ("native binary not found")I installed a CLI, but Settings still says "Not installed"Settings says Antigravity or OpenCode "Can't start"npm isn't recognised, or "command not found"PowerShell says "running scripts is disabled on this system" (Windows)Settings is stuck on "Signing in…"OpenRouter is connected, but its chats don't work"This model needs OpenRouter credits""… is rate-limiting this model (429 Too Many Requests)"Ollama: "isn't running", "too old" or "no model that can use tools"Antigravity says it "skipped a step that needs your approval"Codex says its default model isn't available on this accountI hit a usage limitChatsA chat doesn't answerCodex says the conversation is open somewhere elseI can't close a chatMy queued message is goneAn agent did something I didn't wantCanvas and cardsI deleted a card or chat by accidentA card disappearedThe sidebar, tabs or dock are goneA shortcut does nothingMy animated wallpaper doesn't moveMorphy's window keeps crashingMorphy RemoteUpdatesHow do I get the newest version?