> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pentagon.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Maps

> Workspaces where your agents collaborate across your projects

# 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

| Action            | How                                                              |
| ----------------- | ---------------------------------------------------------------- |
| **Rename**        | `Cmd+.` while the map is open                                    |
| **Switch tabs**   | Click a map tab, or use `Cmd+1`–`Cmd+9` for positional switching |
| **Multiple open** | Each map opens in its own tab                                    |
| **Quick actions** | Right-click a map row in the sidebar for a context menu          |
| **Delete**        | From the home screen (removes the workspace, not your code)      |

## Map-level settings

Each map can override workspace defaults:

| Setting           | What it does                                      |
| ----------------- | ------------------------------------------------- |
| **Default model** | Which model new agents in this map use by default |
| **Folders**       | Which project directories are available           |

Individual agents can override the model further. See [Agent Runtimes](/agents/runtimes) for how model selection maps to Claude Code vs. Codex.

<Card title="Next: The Spatial Canvas" icon="grid-2" href="/workspace/canvas">
  Navigate the visual workspace inside your map.
</Card>