Skip to main content

​
Maps

A map is your workspace. It contains your project folders and all the agents collaborating across them. Think of it like a project in your IDE — everything related to one effort lives in one map.

​
Creating a map

From the home screen, click Create Map. You’ll be prompted to:
  1. Name your map — something descriptive like “Backend Rewrite” or “Mobile App v2”
  2. Add folders — point it at one or more local directories or clone from a URL
Maps appear on your home screen as cards. Click one to open it and see its spatial canvas.

​
Adding folders

Each map can contain multiple folders. This is useful when your work spans several repositories or a monorepo with distinct areas. To add a folder to an existing map:
  • Open the map
  • Go to Settings (Cmd+,) and add a folder under the Folders section
  • Choose between a local directory or clone from a URL
When you spawn an agent, you choose which folders it can access from the ones in your map.

​
Managing maps

  • Rename a map with Cmd+. while it’s open
  • Switch between maps using tabs at the top of the window
  • Open multiple maps simultaneously in different tabs
  • Delete a map from the home screen (this removes the workspace, not your code)

​
Map-level settings

Each map can override global settings:
SettingWhat it does
Default modelWhich Claude model agents use by default
FoldersWhich project directories are available
Individual agents can further override the model setting if needed.

Next: The Spatial Canvas

Navigate the visual workspace inside your map.