Projects and canvases
Keep every project in its own group on one canvas, with its own folder and terminal.
A project keeps one piece of your work together: its chats and cards, its own folder on your computer and its own terminals.
All your projects share one canvas, Home's Main canvas. Each project is a group on it: a frame with the project's name, holding its chats and cards. Anything outside every group belongs to Home.
Only want to keep a few chats together under a name? A frame does that without a project.
Create a project
- Click the New project button at the top of the sidebar (a folder with a +), right-click Home, or press Ctrl + K and choose New project. "Untitled project" appears in the sidebar straight away, with a group on your canvas and two chats in it (what a double-click makes, Claude unless you changed that, and Codex). On the canvas, Morphy takes you to the group; on another tab you stay where you are.
- Its name is already selected: type the name you want and press Enter (Esc keeps "Untitled project"). The group's name on the canvas follows as you type.
- Optionally click Add folder on the project's row in the sidebar and pick a folder. That can be a code repository, a client folder or anything else on your computer. The two new chats move into it, as long as you haven't used them yet.
The two chats also get a focus view called Agents, under the project in the sidebar: click it to see them side by side.
Or right-click an empty spot on the canvas and choose New project here: the group starts right there and you type its name on the group itself.
Freemium has 2 projects (Home doesn't count); Pro has as many as you like. See Freemium and Pro.
With a folder, every new chat in the project works in that folder (one made in its group, or in one of its focus views), and the project's terminals open there. Without one, a project is just a way to group things.
Already have a folder?
"Opening a folder" in Morphy means creating a project and choosing that folder for it. Your files stay exactly where they are.
A project without a folder says Add folder on its sidebar row. To change the folder later, right-click the project in the sidebar and choose Change folder… (it opens your computer's folder picker; Remove folder is next to it), or use Folder in the group's toolbar.
Groups on the canvas
- Go to a project: press Alt + 1–9, pick it in Ctrl + K, or right-click it in the sidebar and choose Go to project. Its group fills your screen.
- A card stays in its project wherever you drop it. Drag it a little past the group's edge and the group's outline turns dashed; drop it there and the group grows to hold it. Drag it right out, into empty canvas, and the card fades and a note beside the pointer says it will go back; let go there and it slides back to where it was. The arrow keys, Ctrl-snapping and Arrange never change a card's project either; Arrange tidies each project's cards inside their own group.
- Move a chat or card to another project: drag it into that project's group. The group lights up while you hold the card over it. Or right-click the card's title bar and pick the project under Move to. A chat you move keeps working in its own folder, and from its next message has the connections you gave its new project. A chat that already works in a project's folder but isn't in any project shows Add to project in its title bar: one click puts it in. One sitting in another project can go in from its folder in the title bar: Move into the … project.
- Move a card to Home: right-click its title bar and choose Move to → Home, or drag it onto Home in the sidebar. It moves out of the group, just below it.
- Ctrl + Z undoes any of these.
- The project's toolbar: point at a group's name (plain text above the group) and it becomes a tag with the number of chats and cards in it and a small toolbar: + (a new chat in the project), Fit to what's inside (the group shrinks or grows to hug its chats and cards; Ctrl + Z undoes it), Color (tints the group's frame), Folder (choose the project's folder), Rename (type the new name, Enter saves, Esc keeps the old one) and Delete project (the trash, see below). Click the name to keep the toolbar open; click anywhere else to close it.
- New chat in a project: double-click inside its group, or click + in its toolbar. Right-clicking inside the group gives the canvas menu for that project: a chat, a note, or a paste.
- Move a group: drag it by its name. Everything in it moves along, and the group lines up with the other groups and loose cards around it, the way a card does.
- Resize a group: drag any of its sides or corners. A side lights up when you point at it. A group never gets smaller than what's in it, and it grows by itself when something sticks out of it. Esc calls a resize off.
- Select everything in a group: drag a box around it on the canvas. Then open it in focus mode or tidy it up with the toolbar. Double-click a group's name to fit the group to your screen, or right-click it for the project's menu.
- Move several projects at once: drag a box around them (and any loose chats and cards you want to bring). The groups that fit wholly inside the box get a blue outline. Drag any selected chat or card by its title bar, or a selected group by its name, and they all move together. Each chat and card stays in its own project; Ctrl + Z puts everything back in one step.
The project names stay readable however far you zoom out. A project starts with something in it: one made with nothing in it gets two chats and an Agents focus view, once. A project you empty yourself later stays empty.
The sidebar
The sidebar on the left (the project explorer) has two tabs under its title: Projects and Files (see See a project's files). Projects shows Home, then your projects as folders, each with its initials in its colour (pick one with Color… in its menu, or Color in its group's toolbar). Click one to show or hide what's inside:
- its own canvases, if you made any,
- its saved focus views (see Focus mode).
Point at a canvas or focus view to see how many chats and cards it holds. Every row in the sidebar has a ⋯ when you point at it: it opens the same menu as a right-click.
Pin the ones you use most. Right-click a canvas or focus view (or click its ⋯, or right-click its tab) and choose Pin to top. It shows under Pinned at the top of the sidebar, whatever project it's in, with the project's name beside it; it also stays in its project. Drag pinned rows up or down to put them in order. A pinned canvas or focus view moved to another project stays pinned. Unpin is in the same menu.
A project tells you what its agents are doing, the same way the tabs do:
- A blue number: that many of its agents finished, or stopped to ask you something, while you weren't looking. It goes away once you've seen them.
- A pulsing dot: an agent there is working, or a brighter one is waiting for you.
With Home folded, Home's row counts every project.
The last line of the tree says what wants a look right now, for example 1 needs you · 1 finished · 2 working. Click a part to go to that chat the way Continue does: back to the focus view you last wrote to it from, or else to the canvas, with the cursor in its message box. Click again for the next one. When nothing is going on, it counts your projects and agents instead.
Continue where you left off
At the bottom of the sidebar, just above your name, sits Continue. It starts folded: click it to open the list of your chats by what they're about. A chat whose bell is ringing comes first, with a little swinging bell until the bell stops. Then the ones working right now (Needs you when one is waiting for your answer), then the ones that finished most recently, with how long ago (10m, 2h, 4d). A blue dot means it finished while you weren't looking. Show more lists up to 20.
- Point at a chat to see its project, its model and where it stopped: what it shipped, or else the last thing it said. While it works, you see what it's doing. If you last wrote to it in a focus view, the card says which one ("Opens in Agents").
- Click a chat to go back to where you last wrote to it. If you sent your last message from a focus view, that focus opens again: in Stage the chat becomes the big card, and in Strip the strip scrolls to it. Otherwise the chat comes into view on the canvas. Either way it's selected, with the cursor in its message box.
- Click Continue again to fold the list away. Morphy remembers whether you leave it open or folded. While it's folded, a swinging bell says a chat's bell is ringing, and a pulsing dot says an agent is working or waiting for you.
- Click a ringing chat to go to it: its bell stops, the same as clicking in the chat.
A chat open as a terminal is listed too once you've sent it something there: each time the app finishes working, the chat moves to the top. One without a name yet shows as its AI's chat (Claude chat, Codex chat). It keeps the times after you restart Morphy.
At the very bottom is you: your picture, name and plan. Click it for Search (Ctrl + K), Account and plan, Shortcuts, Light theme (or Dark theme) and Sign out…. The gear beside it opens Settings. When a new version is ready, Restart to update sits just above you (on Freemium, Get Pro).
Press Ctrl + B to hide or show the sidebar. Drag its right edge to make it wider or narrower (double-click the edge for the usual width). Drag projects to put them in the order you like.
Right-click Home for New project, New chat, New canvas, New focus… and Find Morphy (brings Morphy's chat into view).
Right-click a project (or click its ⋯) for Go to project, New chat, New canvas, New focus… (see Focus mode), Open in VS Code and Show in File Explorer (when it has a folder), Rename…, Color…, Change folder… (Add folder… without one) and Remove folder, and Delete project….
See a project's files
The Files tab at the top of the sidebar, or Ctrl + Shift + E, shows the files of the project you're in instead of your canvases and projects. Click Projects (or press the shortcut again) to go back. It's only for looking and opening: nothing is changed, renamed or deleted from here.
- Click a folder to open or fold it. Morphy remembers which ones you left open.
- Click a file to read it in the dock's file viewer, right beside the canvas, and only there. Pictures show there too, and Markdown files (
.md) you can edit there, like ticking off a checklist. A PDF, a video or anything else Morphy can't show gets a tab with Open in its app. Programs and installers are never run from here. To open a file in VS Code, right-click it. - Drag a file onto a chat to attach it, the same as dropping a file from your computer.
- Right-click a file for Open in VS Code, Open in its app, Show in File Explorer, Attach to the chat you used last, Copy path and Copy relative path. An HTML file also has Preview in the browser: it opens as a web page in the dock's browser.
- Search with the box under the project's name: type part of a name and every file and folder in the project's folder that matches shows, wherever it sits, with the folder it's in. Only that folder is searched. Click a file to read it, or a folder to open the tree right there (a result's right-click menu has Show in the tree too). ↑ ↓ and Enter work as well, and Esc clears the box. With a
/in it, it searches paths, likesrc/app.
When the project's folder is a Git repository, the branch shows next to its name and changed files are marked: M changed since the last commit, U new, A added, R renamed. A folder that holds a change wears a dot. Files the agents create or change show up by themselves.
node_modules, .git and a few other folders nobody browses are left out.
Working on now. Above the tree, a short list shows the files your agents are writing or editing, so you can see what they're working on without scrolling through the folder or asking them.
- Files a chat is changing in the turn it's on now come first, with a pulsing dot. Then the ones changed in the last three hours, newest first, with how long ago. When no chat is at work, the list is called Changed recently.
- Each row shows the file's name with its folder after it, and the chats that changed it: the chat's own icon if you gave it one, else its AI's logo. A file two chats changed shows both.
- Click a file to read it in the file viewer, the same as in the tree. Click a chat's icon to go to that chat. Drag a file onto a chat to attach it, or right-click it for the tree's menu plus Show in the tree.
- Eight files show at first; Show N more shows the rest. Click Working on now to fold the list away, and again to open it.
- With nothing changed, the list isn't there at all. It's hidden while you search.
It works for every AI, it's made from what the chats already show as their steps (no question is sent to them), and it stays on your computer.
The project's name at the top switches to another project's files. Home has no folder of its own: there the tab shows the folder of the chat you're working with in Home (the one you selected or used last), or lets you pick a project.
Without a folder, a note at the top says Add a folder to see the files your agents work on, with Add folder. In a project, that's the project's folder. In Home, it's the folder of the chat you're working with there, when it works in Morphy's own folder. Once there's a folder, its files show instead.
Delete a project
Click the trash in the group's toolbar, or right-click the project in the sidebar and choose Delete project…. Morphy asks first, then deletes the project and everything in it: its chats and cards, its group, its canvases and its focus views. If an agent in it is still working, stop it first.
Ctrl + Z brings it all back. After that, each chat and card can still be restored for 3 days from Ctrl + K; it lands in Home. Morphy's own chat is never deleted, and a chat or card that is also in another project stays there.
Deleting a project's last chat deletes the project too. Morphy asks first, and Ctrl + Z brings back both the chat and the project.
Canvases
Home's Main canvas holds every project. When a project needs a place of its own, away from everything else, give it a canvas, for example "Design" or "Backend". What's on a project's own canvas isn't on the Main canvas. To add one:
- right-click a project in the sidebar and choose New canvas (right-click Home for one in Home), or
- press Ctrl + K and choose New canvas in ….
The canvas opens straight away as "Untitled canvas", with its name ready to type over in the sidebar: type a name and press Enter (Esc keeps "Untitled canvas"). With the sidebar hidden, Morphy asks for the name first. Right-click a canvas to rename or delete it. Deleting a canvas deletes the chats and cards on it too (Morphy asks first and says what goes), and Ctrl + Z brings it all back.
In the sidebar, drag a canvas up or down to put a project's canvases in the order you like (focus views too), or pin it to keep it at the top of the sidebar. Drag a canvas onto another project (or onto Home's own rows) to move it there: the chats and cards on it, the focus views saved on it, its card on the Main canvas and its tab all go with it. Esc cancels the drag, and Ctrl + Z moves the canvas back. Home's Main canvas stays where it is.
Show a canvas as a card on the Main canvas
To keep the overview on the Main canvas while you do the deep work on a project's own canvas, give that canvas a card in the project's group. Right-click the canvas in the sidebar, its tab, or an empty spot on the canvas itself, and choose Add card to main canvas.
The card is a live map of the canvas: every chat and card on it, where it sits. Its title bar says what the chats there are doing, like 1 needs you · 2 working. Nothing is copied: the card is a window onto the canvas, so there's nothing to keep in sync.
- Go in: zoom into the card (Ctrl + scroll, or pinch). Once the card covers most of the screen it stops growing and a bar fills as you keep zooming; when the bar is full you fly into the canvas. A double-click, Enter on the selected card, or the button in its title bar takes you in too.
- Come back out: zoom out on the canvas. Once everything on it fits in half the screen, a bar at the bottom fills the same way and you fly back up into the card. Or right-click the canvas and choose Back to its card.
- Move or resize it like any card. It stays in its project's group.
- Remove it: select it and press Delete, or right-click it and choose Remove card. The canvas itself stays, and Ctrl + Z puts the card back.
Open a project in your code editor
A project's folder opens in your code editor in one click: Open in VS Code in its right-click menu (in the sidebar, or on its group's name), in the folder menu of any chat working there, or from Ctrl + K (Open … in VS Code). Morphy finds VS Code, Cursor, Windsurf, Antigravity IDE, Zed and VSCodium on Windows, Mac and Linux, and the button names the one you have. With several installed, pick one in Settings → General → Open folders in. Show in File Explorer (Finder on a Mac, Files on Linux) opens the folder itself.
Tabs
Canvases and focus views you open appear as tabs along the top, across all projects. Home's Main canvas always has a tab, called Main canvas, which can't be closed.
- Switch: click a tab, or use the ← and → in the top-left corner of the canvas to step to the tab before or after it. Or press Alt + 1–9 to go to a project's group (Option + 1–9 on a Mac). Alt + 1 is Home, Alt + 2 your first project, and so on, in sidebar order.
- Reorder: drag a tab sideways.
- Close: middle-click it, or right-click for Close, Close others, Close tabs after and Close all.
- New tab: the + at the end of the tabs opens an empty tab with New canvas, New focus, New chat and Search (Ctrl + K). They go in the project you were in; click in … under the buttons to pick another. Whatever you open from a new tab takes its place.
Next to the arrows is where you are: the project and the canvas or focus view, like Home / Main canvas or Website / Design. The arrows and the path are in split views and extra windows too.
A pulsing dot on a focus or canvas tab means one of its agents is working, or a brighter one is waiting for you. A blue number means agents finished, or are waiting for you, while you were looking elsewhere. The Main canvas tab holds every chat, so it only shows the number.
Side by side and in more windows
Split view and extra windows are part of Pro; on Freemium these items say Pro.
To see two canvases next to each other, or give one a window of its own (handy on a second screen):
- In the sidebar, right-click a canvas or focus view and choose Open to the right or Open in new window.
- On a tab, right-click and choose Move to the right or Move to new window. The tab moves there, out of the main strip.
- Drag a tab out of the strip: drop it on the right side of the canvas, into another Morphy window, or outside Morphy for a new window.
Morphy remembers your windows and split views when you restart.
Move cards between canvases
Drag a card or chat off the canvas and drop it:
| Drop it on | What happens |
|---|---|
| Another project's group on the Main canvas | It joins that project |
| A project in the sidebar | It moves into that project's group |
| The Main canvas tab | It goes back to the Main canvas, into its own project's group |
| Another canvas tab | It moves to that canvas, in a free spot |
| A canvas in the sidebar | It moves there, keeping its position |
| A focus tab or focus view | It joins that focus view. It stays in its own project, on its own spot |
| The + at the end of the tabs, or a new tab | A new canvas is made with the card on it |
Hold the card over a tab or sidebar row for about half a second and that canvas opens, with the card still in your hand, so you can place it yourself. Esc cancels, and Ctrl + Z undoes the whole move.
A tile in focus mode can be dragged out the same way, by its title. It then leaves the focus view it was in (see Focus mode).
How projects work under the hood
A chat or card belongs to a project by carrying the project's name as a tag, which you don't see. Dropping an item into another project's group swaps its tag for that project's; Move to → Home takes it off. Project names, folders, groups, canvases and focus views are saved with your canvas, so they're all back after a restart.
Drive Morphy from your tools
Start chats, send them work and read their answers from a script, an editor or an app of your own, through Morphy's bridge.
Focus mode
Put the chats and cards you are working with on one screen: side by side, one big with the rest beside it, in columns, or every agent a tile. One click back.
