Connect your AI

Morphy doesn't come with its own AI subscription. It runs on the accounts you already have, signed in on your own computer. Your messages go straight from your computer to the AI you pick, never through a Morphy server.

Connect as many as you like. Every chat picks its own AI, so you can run Claude and Codex side by side on the same canvas.

At a glanceCopy Anchor Link

Where to connectCopy Anchor Link

Open Settings (Ctrl + ,, or the gear at the bottom of the sidebar) and click Account. Under Connections there's a card for every AI with its status:

• Not installed: its command-line tool isn't on your computer yet. The card tells you how to install it.
• Not connected: click Connect. A browser tab or a small terminal window opens for you to sign in. The card updates by itself when you're done.
• Connected: ready to use. Reconnect signs in again, for example with another account. Sign out disconnects Claude, Codex and Grok; OpenRouter's button is called Disconnect. Copilot and Antigravity sign out in their own tools (see below), and Ollama has nothing to sign out of.

Installed a tool while Morphy was open? Click Check again. You don't need to restart Morphy.

If a chat's AI isn't ready, the chat tells you what's missing, with a link straight to Settings → Account.

ClaudeCopy Anchor Link

Claude Code comes built into Morphy, so there's nothing to install.

1. In Settings → Account, click Connect on Claude Code.
2. A terminal window called "Claude login" opens and sends you to your browser.
3. Sign in with your Claude account. The card shows your email and plan.

Plan or API key. By default Claude chats use your Claude plan. To pay per use with an Anthropic API key instead, add ANTHROPIC_API_KEY to your workspace keys and click Use an API key instead on the Claude card. Use my Claude plan switches back.

When you sign in with a different account, Morphy restarts its Claude chats on the new account. A chat that's busy finishes its answer first.

CodexCopy Anchor Link

Codex is OpenAI's coding agent and signs in with your ChatGPT account.

1. Install the Codex CLI in a terminal (needs Node.js):

   Copy Text

   npm install -g @openai/codex

2. In Settings → Account, click Check again, then Connect on Codex.

3. Your browser opens. Sign in with your ChatGPT account.

GitHub CopilotCopy Anchor Link

Uses the models of your Copilot plan. Copilot Free works too; on Free and Student plans Copilot picks the model for each request (Auto), while paid plans list their models in the model picker.

1. Install the Copilot CLI, with either of these:

   Copy Text

   npm install -g @github/copilot

   Copy Text

   winget install GitHub.Copilot

2. In Settings → Account, click Check again, then Connect on GitHub Copilot.

3. A terminal window opens. Follow its steps to sign in to GitHub.

To sign out of Copilot, run copilot in a terminal and type /logout.

AntigravityCopy Anchor Link

Google's Antigravity runs Gemini on your Google account. It's free with a Google account; Google AI Pro and Ultra get more.

1. Install the Antigravity CLI, in PowerShell:

   Copy Text

   irm https://antigravity.google/cli/install.ps1 | iex

   or with winget install Google.AntigravityCLI.

2. In Settings → Account, click Check again, then Connect on Antigravity.

3. A terminal window opens. Pick Google sign-in, open the link it shows, and paste the code back into the terminal.

To sign out, run agy in a terminal and sign out there.

GrokCopy Anchor Link

Uses your xAI account.

1. Install xAI's Grok CLI, in PowerShell:

   Copy Text

   irm https://x.ai/cli/install.ps1 | iex

   Using it needs an xAI plan that includes the Grok CLI.

2. In Settings → Account, click Check again, then Connect on Grok.

3. A terminal window called "Grok login" opens. Follow its steps.

Instead of signing in, you can also add an XAI_API_KEY to your workspace keys.

OpenRouterCopy Anchor Link

OpenRouter gives you hundreds of models from many labs through one account, including free ones and paid models like Gemini, GPT and Claude.

1. In Settings → Account, click Connect on OpenRouter.
2. Your browser opens. Sign in to OpenRouter and click Authorize.
3. Morphy saves the key for you. The card shows whether you're on the free tier and how much credit you've used.

OpenRouter chats run through the Codex CLI, so install that too:

npm install -g @openai/codex

In an OpenRouter chat, the model picker lists the free models first, and the newest free model is the default, so nothing costs money unless you pick a paid model. Paid models show their price per million tokens and use your OpenRouter credits.

Disconnect removes the key from Morphy. To use another OpenRouter account, click Disconnect first, then Connect: Reconnect keeps the key you have.

If the card says Key rejected, the saved key no longer works and Connect won't replace it. Open your workspace keys, delete the OPENROUTER_API_KEY line, click save, then Connect again.

OllamaCopy Anchor Link

Ollama runs open models on your own computer: no account, and with local models your messages never leave your machine. (Ollama's cloud models, also in the model picker, need an Ollama account and run on Ollama's servers.)

1. Install Ollama (version 0.13 or newer) and start it.

2. Pull a model that can use tools, in a terminal:

   Copy Text

   ollama pull gpt-oss:20b

3. Install the Codex CLI, which Ollama chats run on:

   Copy Text

   npm install -g @openai/codex

4. In Settings → Account, click Check again. The Ollama card says Ready.

Morphy looks for Ollama at http://127.0.0.1:11434. If you run it somewhere else, set OLLAMA_HOST in your workspace keys. The model picker shows the models on your computer first, then Ollama's cloud models.

Which AI runs whatCopy Anchor Link

• Morphy's own chat runs on Claude by default. Change it in Settings → General → Morphy runs on; any connected AI can run it (not while Morphy is working). If Claude isn't connected and you've never chosen, Morphy switches to one you have connected, other than Ollama.
• Double-click on the canvas makes a Claude chat and double right-click a Codex chat. Change both in Settings → General. Until you do, a gesture whose AI isn't connected uses one you have connected (again, not Ollama).
• Any other chat can switch AI: click the AI's name in the chat's title bar. Switching starts a fresh conversation.

Workspace keysCopy Anchor Link

Some AIs can also use an API key: ANTHROPIC_API_KEY, OPENROUTER_API_KEY, XAI_API_KEY, or your own keys for the tools your agents use. Add them in Settings → Account → Workspace keys (.env) → Open. It opens as a card on the canvas: edit, then click save.

The keys are stored in a file on your computer (%APPDATA%\Morphy\assistant\.env), never on a Morphy server.