morphyDocs

Your first ten minutes

A short walkthrough: your first card, your own project, two agents side by side and focus mode.

This walkthrough assumes Morphy is installed and at least one AI is connected. If not, start with Install Morphy and Connect your AI.

The Get started checklist on your Main canvas covers the first steps too, and ticks them off as you go. And Morphy can show you around itself: press Ctrl + K and choose Show me around (a new install offers it on its first run).

Prefer to watch first? This short tour is the same video as the welcome card on your canvas.

Ask Morphy for a card

Morphy's chat is the one in the middle of your canvas. Type:

Make me a card with my three priorities for this week: launch the landing page, answer support mail, plan the next release.

A card appears on your canvas. It stays there, and you can ask Morphy to change it any time: "add a checkbox to each one". Read more about cards.

Make a project for your own folder

Click the New project button at the top of the sidebar (a folder with a +). "Untitled project" appears with a group on your canvas and two chats in it; type its name over and press Enter. Its Agents focus view, under the project in the sidebar, shows the two chats side by side. Then click Add folder on its sidebar row to pick a folder you work in (a code repository, for example).

Every chat you start in the project works in that folder, and so do its two new chats. See Projects and canvases.

Made your first project when Morphy started? It's in the sidebar already, with four agents and an Agents focus. Use it for the next steps, or make another.

Start two agents

On the project's canvas:

  • Double-click an empty spot for a Claude chat.
  • Right-click another spot for the canvas menu: a chat, a note or a project right there. To make a chat a Codex chat, click the model button under its text box, point at Provider and pick Codex.

(If the AI a double-click makes isn't connected, it uses one you have connected. Only using Ollama? Pick it in Settings → General: Morphy never chooses Ollama by itself.)

Give both the same task, for example: "Read this project and suggest the three changes that would help most."

Watch them side by side

Drag a box around both chats to select them, then click Focus in the toolbar above them. They fill the screen side by side. Drag the gap between them to resize, and press Esc when you're done. The focus view is saved, so you can come back to it from its tab. See Focus mode.

Get a ping when they finish

Select a chat and click the bell in the toolbar. When the agent is done, or needs you, a chime plays. Now you can work on something else.

Let Morphy run them for you

Go back to Morphy's chat (the Main canvas tab) and try:

Which of my chats are done? Summarise what they suggested.

Morphy checks every chat and reports back. It can also start chats for you: see Morphy, your assistant.

Good to know

On a Mac, press ⌘ wherever these docs say Ctrl.

  • Ctrl + K finds any project, canvas, chat or card, and brings back chats and cards you deleted in the last 3 days.
  • Ctrl + Z undoes almost anything on the canvas.
  • Ctrl + Shift + B opens a terminal and a browser for the project.
  • New chats start in Auto-accept edits (from Morphy 0.1.22): agents change files in their folder without asking, and ask before anything else. If you'd rather approve each change, set Permissions in Settings → General → New chats to Ask first. See Permissions.
  • Every shortcut is listed under the ? button, top right, and in Settings → Shortcuts. See Keyboard shortcuts.

On this page