morphyDocs

The canvas

Move around, add chats, and select, arrange, colour, copy and delete what's on your canvas.

The canvas is an endless surface, like a whiteboard. Everything you work with sits on it: your chats, the cards your agents build, and Morphy itself. Every project is a group on the same canvas, so you see all your work at once, each project in its own frame.

Move around

ToDo this
PanScroll, drag with the middle mouse button, or hold Space and drag
Pan sidewaysShift + scroll
ZoomCtrl + scroll, or pinch on a trackpad (zooms around the pointer)
Zoom in stepsCtrl + = and Ctrl + -, or the Zoom in and Zoom out buttons top right
Jump somewhereClick or drag in the canvas map, bottom right

On a Mac, use ⌘ where this page says Ctrl, and on a trackpad a right-click is a click with two fingers.

You can zoom from 15% to 250%. The current zoom shows under the canvas map; click it to go back to 100%. The arrow beside it folds the map away, leaving only the zoom in the corner; click it again to bring the map back. Morphy remembers which you chose.

The map also shows who's busy. A chat that's working glows on it in a light shade of your accent colour, and one waiting for you (a question, or permission to run something) glows in the full colour. A canvas's card glows the same way while a chat on that canvas works. Click the glow to jump there.

Over a canvas's card, zooming in far enough takes you into that canvas, and zooming far out of it brings you back.

Scrolling over a card or chat pans the canvas, unless it's the one thing selected: then it scrolls its own content. With several items selected, scrolling always pans, and so does scrolling over a picture, which has nothing to scroll. Shift + scroll, or a sideways swipe, pans sideways even over a selected card, unless what's under the pointer scrolls sideways itself (a wide table, a long line of code).

While you zoom. As soon as a zoom keeps going, every chat on screen shows its face. Cards stay as they are, so you can read them the whole time. When you stop the chats fill back in, nearest the middle first, each face fading as its chat comes back, and you can keep moving meanwhile. A chat off the edge of the screen keeps its face until you pan to it. That is what keeps zooming smooth on a canvas full of long chats.

Far away. Below 25%, chats turn into a simple tile: a soft blue ring while it's working, a solid blue one when it needs you, and its name in small print along the top when the tile is big enough to show it. Smaller tiles show no name. Cards keep their picture with a small caption along the top, and pictures stay just the picture. Rest the pointer on any chat or card for a moment to see its full name and what it's doing. Project names stay plain text above their groups; point at one for its count and toolbar. That makes a busy canvas easy to read at a glance, and at that distance you can drag a card by grabbing it anywhere. Zoom back in and the tiles fade into their chats a few at a time, nearest the middle first, like after any zoom.

Canvas only. Press Ctrl + Shift + F, or click the ⤢ button top right, to hide everything but the canvas: the sidebar, the tabs and the side dock. Esc brings them back (press it again if something is still selected).

Add a chat

  • Double-click an empty spot to start a new chat there. By default that's a Claude chat.
  • Shift + double-click makes it open as a terminal instead, the AI's own app in the card (or, if you've set new chats to open as terminals, as a chat).
  • Click New chat (the chat bubble with a +, top right) for one in a free spot near the middle of the screen. It makes the same kind of chat as a double-click.
  • Right-click an empty spot for the canvas menu (see below), which also makes a chat there.

A canvas with nothing on it yet, like a canvas you just added, shows these in its middle as a reminder, together with how to pan and zoom. The reminder goes away as soon as you add something.

You can choose what a double-click makes, the model and effort it starts on, and whether it opens as a chat or a terminal, in Settings → General → New chats. As long as you haven't changed it, a double-click whose AI isn't connected yet uses one you have connected instead (any but Ollama or a custom provider). An AI you picked yourself is always used, connected or not. The new chat works in the folder of the project you're looking at. See Chats and agents for everything a chat can do.

The canvas menu

Right-click an empty spot on the canvas. Everything it makes appears right where you clicked:

  • New Claude chat: the same chat a double-click makes (another AI if you changed that in Settings).
  • New note: a blank note, ready to type in. The first line is its title.
  • New frame here: a named box near that spot, to keep chats and cards together. See Frames.
  • New flow (Beta): a new flow at that spot, with Morphy beside it asking what it should do and building it with you. For a ready-made one (a team, a council, a review loop and more), use a flow template. A flow lives outside projects for now: inside a project's group, New flow is greyed out.
  • New project here: a new project whose group starts at that spot, with its two chats; type its name on the group. Only offered outside every group.
  • Find Morphy: brings Morphy's chat into view, wherever you are on the canvas, ready for you to type.
  • Undo, Redo and Paste. Paste puts the cards you copied right there, or a picture you copied since.

Right-click inside a project's group and the menu shows the project's name on top: what you make there joins that project.

Morphy also builds things on the canvas for you: ask it for a dashboard, a tracker or a tool and it appears as a card.

Notes

A note is a plain markdown file (note-….md in your cards folder), so it opens in any editor, Obsidian included, and Morphy's agents can read and write it. It saves itself as you type, and its first line is its title.

Notes format as you write, like Obsidian: the markdown fades away and only shows where your cursor is. Click outside the note (or press Esc) and it reads as a clean page.

TypeYou get
# to ###### at the start of a linea heading
**bold**, *italic*, ~~struck~~, ==highlighted==that style
`code`, or a block between ``` linescode, coloured for JavaScript, TypeScript, JSON, CSS, HTML and Python
- or 1. a list. Enter adds the next item, Tab nests it
- [ ] a task. Click the box to tick it
> a quote
[text](https://…)a link. Click it to open it in your browser
--- on its own linea dividing line

Tables written in markdown show as tables too; click one to edit its text.

Shortcuts (⌘ instead of Ctrl on a Mac): Ctrl+B bold, Ctrl+I italic, Ctrl+K link, Ctrl+L turns a line into a task or ticks it. Select text and type *, ~ or = to wrap it.

Pictures

A picture can sit on the canvas as a card of its own:

  • Drop picture files from File Explorer, Finder or your file manager onto an empty spot, or into a project's group. Several dropped together land side by side.
  • Paste with Ctrl + V (⌘ + V on a Mac): a screenshot, an image you copied from a web page, or a picture file you copied. It lands where your pointer is. Paste in the canvas menu puts it where you right-clicked. If you copied several picture files, paste puts down the first; drop them to put down all of them.

PNG, JPEG, GIF, WebP, AVIF and SVG pictures are kept as they are. BMP and ICO pictures are saved as PNG. A picture longer than 4096 pixels on its longest side is made smaller on the way in.

The picture is saved in your cards folder under its own name, so it stays on your computer. A pasted one is called picture- followed by the date and time. It lands at its real size, made smaller if it wouldn't fit on your screen.

It works like any other card: move it, put it in a project or a focus, copy it, delete it and bring it back. Resizing keeps its shape. Its name and ✕ show when you point at it. Right-click it for Open in its app, which shows the full picture in your usual viewer, and Show in File Explorer (Show in Finder on a Mac).

Pictures are free on every plan: they don't count toward Freemium's 3 cards.

Select

  • Click a chat or card to select it and bring it to the front.
  • Selecting text in a chat stays inside that chat: drag past its edge and the selection runs to its first or last line.
  • Shift + click adds to the selection.
  • Drag on empty canvas to draw a box around several items. A project's group or a frame that fits wholly inside the box is selected too: its outline turns blue.
  • Click empty canvas or press Esc to deselect.

A toolbar floats above whatever you've selected. Most of what follows starts there.

Move, resize and arrange

  • Move: drag an item by its title bar. Everything selected moves along, including the groups and frames you boxed in, with everything in them; you can also drag a selected group or frame by its name. The arrow keys nudge the selection (hold Shift for bigger steps).
  • Line up: an item you move catches on the edges and middles of the ones around it, and on the gap its neighbours already keep, so a row comes out evenly spaced. A thin line shows what it lines up with, and a small bracket marks each gap that matches. Resizing catches an edge the same way. Hold Alt (Option on a Mac) while you drag to place it freely, or turn it off in Settings → Personalization → Line up while moving.
  • Full screen: double-click a chat's or card's title bar (a picture anywhere on it) and it fills the screen. Double-click it again, or press Esc, to put it back. See Focus mode.
  • Snap beside another card: hold Ctrl (⌘ on a Mac) while you drag one card near another. It lines up next to it at the same size, with a preview of where it will land.
  • Resize: drag any edge or the bottom-right corner. With several items selected, the corner scales the whole group. A picture keeps its shape.
  • Tidy up: select two or more items and click Arrange into a tidy grid. They line up in a row or a grid and even out to one size. Items from different projects are arranged inside their own project's group. Chats and cards in a flow stay where they are (use the flow's ⋯ → Tidy up for those), and the grid keeps clear of a flow's frame.
  • Back to the original size: for chats, the toolbar has Restore this chat's original size.

Dragging an item to the edge of the screen scrolls the canvas along with it. Press Esc during a drag to cancel it and put everything back.

Move to another canvas

Drag a card or chat off the canvas and onto a tab or a canvas in the sidebar to move it there. See Projects and canvases.

Frames

A frame is a named box on the canvas for keeping things together: put a few chats in it, give it a name, and move them all at once. Unlike a project, it has no folder, no row in the sidebar and no chats of its own, and you can make as many as you like on any plan.

  • Make one: right-click an empty spot and choose New frame here, or right-click a chat's or card's title bar and choose Put in a new frame (with several selected, the frame goes around all of them). Type its name and press Enter.
  • Put things in: drag chats and cards into it. Whatever has its middle inside the frame is in it, so a card that only pokes in stays out.
  • Move it: drag its name. Everything in it comes along, frames inside it too. It lines up with the chats, cards and frames around it, and they with it.
  • Resize it: drag any edge or corner. A side you drag catches on the edges around it.
  • More: point at its name for Fit to what's inside, Color, Rename and Delete frame. Right-click the name for the same, plus Select what's inside. Double-click the name to fit the frame on your screen.
  • Select it: click its name. Its tools stay open, and Delete (⌘ + ⌫ on a Mac) deletes the frame.
  • Delete frame removes only the frame: what was in it stays where it is. Ctrl + Z brings it back, and undoes any other change to a frame.

A frame's name stays readable when you zoom out, like a project's. Frames work inside a project's group too, to split a project into parts, and move with the group. Moving a frame is like dragging everything in it together: drop it inside a project's group and the Home chats in it join that project, and a frame holding a project's chats slides back if you drop it outside every group.

Colour and size

The selection toolbar also has:

  • Card color: tint an item in one of ten colours (Teal, Mint, Sky, Cyan, Iris, Rose, Amber, Coral, Lime, Slate), or No color. For any other colour, click the last swatch, Custom color…, and choose one in the colour picker: the item shows it as you choose, and it's set when the picker closes. Your last four custom colours stay in a row under the swatches.
  • Make content smaller / larger: the text size inside the item, from 65% to 180%. The − and + buttons step 10%; click the percentage between them to type your own, then press Enter (Esc leaves it as it was).
  • Card background opacity: make the background see-through, so your wallpaper shows behind it. Even at the lowest setting it stays half opaque, so text stays readable.

Copy and paste

Select chats or cards and press Ctrl + C, then Ctrl + V. The copies land just below and to the right, already selected.

  • A copied card becomes a new card file of its own (name-copy.html, or name-copy.png for a picture).
  • A copied chat keeps its AI, folder, model, settings, colour and project, but starts a fresh conversation.

If you've highlighted text, Ctrl + C copies the text instead.

If you copy a picture somewhere else after copying cards (a screenshot, say), Ctrl + V on the canvas puts down the picture instead. Whatever you copied last is what gets pasted. See Pictures.

Copy as context. The toolbar button Copy these cards as context copies what's in the selected items so you can paste it into any chat. In a Morphy chat each item becomes a chip the agent reads with your next message. Anywhere else, like ChatGPT, claude.ai or a document, it pastes as plain text: each item's name as a heading, then its text.

Delete and bring back

Delete a card with its ✕, with the trash button in the toolbar, or by selecting it and pressing Delete (⌘ + ⌫ on a Mac). A chat goes the same way, and Morphy calls that closing, because its conversation stays with the AI. A chat can't be closed while its agent is working: stop it first.

Changed your mind?

  • Ctrl + Z (or Undo top right) brings it straight back. A restored chat picks up the same conversation. Undo also covers moves, resizes, colours and arranging, up to 40 steps. The undo history starts fresh each time Morphy starts.
  • For 3 days, anything you deleted can still be restored: press Ctrl + K and type its name, or look for Restore "…". It goes back to the same project, canvas and spot, and into the focus views it was in.

Morphy's own chat always stays on the canvas and can't be deleted.

Chats working together

To have several chats work together, put them in a flow: a frame on the canvas where arrows hand one chat's answer to the next, share a list of tasks between a team, or gather a council's answers into one. Flows replaced swarms in October 2026; a swarm you had became a flow, with its chats in a frame.

Files and images

Drop files onto a chat to attach them to your next message, or paste an image into its text box. Pictures dropped or pasted on empty canvas become picture cards. Other files don't go on the canvas: they always go to a chat.

On this page