Getting started

The basics in five minutes

What each thing is

  • Project: a folder on your disk. Every agent in the project is born inside it, and each project has its own panels, agents, theme and connections. See choosing the project.
  • Canvas: the space where the panels live. It has no edges, and panels stay where you left them. See panning and zooming.
  • Panel: everything that shows up on the canvas. An agent is a panel, and so are the browser, Git, a file, tasks, notes and your camera. See panels and the desk.
  • Agent: the agent program running in a real terminal inside the panel. See what an agent is.
  • Work area: the tabs within one canvas, for separating subjects. See work areas.

Where to start

  1. Installing CanvasCode.
  2. The permissions macOS asks for.
  3. Choosing the project.
  4. The first agent.

The keys

Key What it does
⌘K Goes to any panel, agent or project, and creates what doesn't exist
⌘N A new agent
⌘T A terminal with no agent
⌘⇧E The shelf: everything open in this canvas
⌘1⌘9 Switch project
⌥C Turns the conversation with Nina on and off
⌥X Hold and tell the canvas to do something
⌥D Hold and dictate inside an agent
⌥F Flips the panels and shows each agent's summary
⌘, Settings

All of them can be changed in Settings → Shortcuts. See search and commands.

Where the settings live

  • For the whole app, at ⌘,: voice, shortcuts, interface, providers, agents, notifications, costs, licence. See alerts and sounds and agent settings.
  • For this project, in the canvas menu: the folder, the skills, the MCP servers, the browser, the appearance, the announcements and the integrations. See project settings and appearance.

The rest of the manual