Install Morphy
Download Morphy for Windows, Mac or Linux, install it, sign in and connect your first AI.
What you need
- Windows 10 or 11, 64-bit, macOS 11 (Big Sur) or later on a Mac with an Apple chip (M1 or later) or an Intel processor, or 64-bit Linux on an Intel or AMD PC, like Ubuntu 20.04, Debian 11, Fedora 36 or newer.
- An account with at least one AI you want to use: Claude, ChatGPT (for Codex), GitHub Copilot, Google (for Antigravity), Grok or OpenRouter. OpenCode and OpenRouter have free models (OpenCode's need no account), and Ollama runs models on your own computer, so you can start without paying anything. Hermes Agent runs on the models you set up in it, Junie on a JetBrains AI plan or your own key, and any other OpenAI-compatible service, like LM Studio, works too. See Connect your AI.
- An internet connection for signing in, for updates and for every AI except Ollama's local models.
You don't need to install anything else to use Claude: it comes built into Morphy. Some other AIs need a small command-line tool, which Connect your AI walks you through. On Windows you don't need admin rights.
Install
Go to get.appmorphy.com and click Get Morphy. The page knows whether you're on Windows, a Mac or Linux. You can answer three short questions about what you'd like Morphy to help with, or skip them. Then:
- Download. The installer,
Morphy-Setup.exe(about 170 MB), downloads by itself. Didn't start? Click Download for Windows. - Open it. Open
Morphy-Setup.exefrom your downloads. Morphy is signed by Apers, so Windows normally opens it straight away. If your PC still shows a blue Windows protected your PC screen, click More info: it should say Publisher: Apers, the name Morphy is signed with. Then click Run anyway. If it says Unknown publisher, don't run it: that file isn't Morphy. Download it again from get.appmorphy.com. - Let it install. There's nothing to choose. Morphy installs for your Windows user in a few seconds, adds a shortcut to your desktop and Start menu, and opens by itself.
Want to make sure a download is really Morphy before you open it? Check your download shows how to check its signature and its fingerprint (SHA-256) on Windows, a Mac and Linux.
Sign in
Click Let's dive in, then Continue with Google or Continue with GitHub. Your browser opens on that sign-in page. Pick your account and come back to Morphy. Morphy only receives your account ID, name, email address and profile picture, nothing else from your Google or GitHub account. GitHub needs a verified email address on your account (GitHub → Settings → Emails).
Google and GitHub open the same Morphy account when they share a verified email address, so your plan comes with you whichever you pick.
If the browser tab closed or showed an error, click Open Google again (or Open GitHub again) after a few seconds. If no browser opens at all, Morphy says so: click Copy the sign-in link and paste it into the address bar of a browser on this computer. Morphy keeps waiting for you.
Bring your agents (optional)
Connect the AI plans you already have. Morphy shows the ones it finds on your computer first, up to three: those you're already signed in to come with a check, those installed have Connect. It looks for Claude, Codex, Antigravity, GitHub Copilot, Grok and OpenCode, and the line under the tiles says what it found. When it finds fewer than two, Claude and Codex fill in:
- Claude signs in with your Claude plan (Pro or Max). Click Connect: your browser opens on Claude's sign-in page, and the tile turns to Connected once you've signed in there. If the page didn't come up, click Open it again on the tile. If the page shows a code instead, paste it into the tile and click Sign in. If a sign-in doesn't finish, the tile says why and offers Try again.
- Codex signs in with your ChatGPT account. It needs the Codex command-line tool. On Windows, click Install Codex: Morphy installs it (this can take a few minutes, the tile says so), then your browser opens to sign in. On a Mac, Morphy shows the command to copy. If an install or a sign-in doesn't finish, the tile says why, for example when Node.js is missing or another app holds Codex's sign-in port.
- A plan that falls short shows in amber: No Claude plan when your Claude account has no Pro or Max plan (Claude Code doesn't run without one), and ChatGPT Free when Codex is on a free ChatGPT account, which includes very little Codex. Morphy then starts your agents on an AI that can run, if you connected one.
- Antigravity, Copilot and Grok sign in in their own window, like in Settings. OpenCode is ready as soon as it's installed: its free models need no account.
Your first project's four agents start on what you connected here: the first two, side by side (Claude and Codex when you have both).
You can skip this and connect any AI later in Settings → Account, including OpenRouter, Ollama and your own OpenAI-compatible service. Click Continue.
Your first project
What are you working on? Give your first project a name, and if you like, pick its Folder (a code repository, for example): its agents then work in that folder. Picking a folder fills in its name for you. Click Create project, or Skip for now.
The project comes with four agents on its canvas: Claude on the left in purple and Codex on the right in green when you connected both, or four of the one you connected. They come with a saved focus view called Agents that shows all four side by side.
Your plan
Pick your plan shows Freemium and Pro side by side. Freemium is free and already yours: click Continue free. For Pro, click Get Pro: the checkout opens in your browser, and once you've paid the screen turns to You're on Pro by itself. You can also get Pro later in Settings → Account.
Joined during early access? The screen says Pro is yours, for life instead, with nothing to pay. If Morphy can't reach its server to check your plan, it skips this screen.
Your first task
With an AI connected, the last screen gives Morphy its first task: A to-do list, A focus timer or A habit tracker. Pick one and click Make it. Morphy starts on it as your canvas opens, and the card appears beside Morphy's chat in about a minute. It only makes that one card in Morphy's own cards folder, nothing else on your computer. Click Skip for now to go straight to your canvas.
Your first canvas
Morphy opens on your Main canvas with Morphy's chat, your assistant on the canvas, a Get started checklist and a Welcome to Morphy card with the tour. Your project's Agents focus waits in a tab at the top.
Morphy shows you around. As the canvas appears, Morphy's logo comes alive in a corner: "Hi, I'm Morphy. Got two minutes?" Click Show me around for a short tour where you do each step yourself: move around the canvas, zoom out to see every agent at once, delete something and bring it back, make a project, open its agents in focus, and ask Morphy for a card. Its × ends it any time. Click Not now to skip it: the Get started checklist offers it again, and so does Ctrl + K → Show me around, whenever you like.
The checklist ticks itself off as you go: connect an AI, create a project, open your agents in focus, give an agent a task, and ask Morphy for a card. Each open step has a button that does it or starts it. Close it with its × when you're done. To bring it back, press Ctrl + K and choose Get started checklist. For a longer walkthrough, read Your first ten minutes.
If you close the sign-in window before signing in, Morphy closes too. Just open it again.
On a Mac, press ⌘ wherever these docs say Ctrl. See Keyboard shortcuts.
Updates
Morphy updates itself, on Windows and on a Mac. While Morphy is open, a new version downloads in the background. Once it's ready, Restart to update appears at the bottom of the sidebar: click it and Morphy closes, installs the new version and opens again by itself (on Windows you see the installer's progress window for a few seconds). Your canvas, chats and cards stay as they are. Not now? It also installs the next time you quit Morphy, and on Windows it then opens again by itself, on the new version. If Morphy keeps running in the tray when you close its window, closing the window isn't quitting: quit from the tray icon's menu, or click Restart to update. Windows signing out or shutting down never starts an update halfway; it waits for the next time you quit.
- See that it worked: the first time a new version opens, a note at the bottom of the canvas says Updated to Morphy …, with What's new.
- See where it is: Settings → General → Updates says when you're on the latest version, shows how far a download is ("Downloading Morphy 0.1.14… 42%"), and has Restart now once it's ready. Quitting before the download is done means it starts again next time, so leave Morphy open for a few minutes.
- See your version: at the top of Settings → General.
- Opened it again right away? On Windows the update takes a few more seconds after Morphy closes. If you open Morphy meanwhile, a notification says Morphy is updating, and Morphy opens by itself, on the new version, once the update is in. Opened while it's still closing, with no update, it opens as soon as the old one is gone. If an earlier update took Morphy out of the Start menu, the next update (or running the installer from get.appmorphy.com) puts it back.
- Prefer to choose when? Turn off Install updates automatically in Settings → General. Morphy then tells you when a new version is out (Update available at the bottom of the sidebar). Click it, or Install in Settings, when it suits you: it downloads, and then Restart to update installs it.
- What changed: every version and its notes are on the Releases page.
If agents are still working when you quit or restart to update, Morphy asks first: Keep working, or Quit anyway / Restart anyway.
Uninstall
Open Windows Settings → Apps → Installed apps (on Windows 10: Settings → Apps → Apps & features), find Morphy and choose Uninstall.
Uninstalling removes the app, but keeps your data folder (%APPDATA%\Morphy on Windows, ~/Library/Application Support/Morphy on a Mac, ~/.config/Morphy on Linux): your canvases, cards, chats, notes and keys. If you reinstall later, everything is still there. To remove it all, delete that folder after uninstalling. See Your files for what's in it.
To also delete your Morphy account record (your name and email on our side), email casper.apers@gmail.com from the address you signed in with.
