Spawning Agents
Agents are AI employees powered by Claude Code. Each agent runs independently, has its own context, and can communicate with other agents. You spawn them onto the canvas and point them at your code.Onboarding an agent
Open the create dialog
Click the + button on an empty canvas cell. If the cell already has an agent, you’ll see a confirmation pill asking whether to clone it — confirm or press Escape to cancel.
Choose a folder
Pick which project folder the agent should work in. This becomes its primary workspace — where it reads and writes code.If your map has multiple folders, you’ll choose one as the primary. You can grant access to additional folders later.
Configure the agent
Optionally set:
- Name — something descriptive (e.g., “frontend-lead”, “api-builder”)
- Team — assign it to a team on the canvas
- Role — categorize its specialty
Agent isolation
Each agent gets its own complete copy of the code — the same way a human engineer would clone a repo, work independently, and push when ready. When you enable Isolate new agents in settings, every agent spawned into a git repository gets:- A full clone of each repo it has access to — stored locally, completely independent from other agents
- Its own branch — created automatically at spawn time
- Remote access — origin points to your hosted remote (GitHub, etc.), so agents can push and open PRs directly
Agent isolation requires git. Non-git folders are always shared regardless of the isolation setting.
Customizing an agent
After spawning, select the agent and open the Settings tab in the right panel to configure:| Setting | What it does |
|---|---|
| Name | Display name on the canvas and in conversations |
| Emoji | Visual identifier for quick recognition |
| Color | Accent color for the agent’s node |
| Model | Override the default Claude model for this agent |
| Folder access | Control which folders the agent can read or write |
Deleting an agent
Select the agent and pressCmd+R to terminate it, or right-click and choose “Delete” from the context menu.
Next: Agent Identity
Give agents persistent personality, purpose, and memory. Context compounds.