​

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 (Today) screen, click Create Map:

1. Name your map — something descriptive like “Backend Rewrite” or “Mobile App v2”
2. Add folders — point at one or more local directories, or clone from a URL

Pentagon’s default location for new folders is ~/Pentagon/<map-name>/, but you can pick any folder on your machine. 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 — useful when your work spans several repositories or a monorepo with distinct areas. To add a folder to an existing map:

• Open the map
• Open Workspace Settings (the gear at the top of the sidebar, or Cmd+,)
• Add a folder under the Folders section — choose 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

​

Map-level settings

Each map can override workspace defaults: Individual agents can override the model further. See Agent Runtimes for how model selection maps to Claude Code vs. Codex.