Pentagon offers configuration at two levels: per-agent settings (chosen when spawning) and global app settings.
Per-Agent Settings
Each agent is configured when you spawn it via the Spawn Dialog:
Working Directory
The folder Claude has access to. This can be:
- A project root (
~/projects/my-app)
- A monorepo workspace (
~/work/monorepo)
- Any directory you want Claude to work with
Model Selection
| Model | Description |
|---|
| Opus | Most capable, best for complex tasks (default) |
| Sonnet | Balanced speed and capability |
| Haiku | Fastest responses, great for simple tasks |
Permission Mode
| Mode | Description |
|---|
| Full Auto | Automatically approve all tool operations (bypass mode) |
| Custom | Select which specific tools are allowed |
| Tool | Description |
|---|
| Read | Read files and directories |
| Edit | Modify existing files |
| Bash | Execute shell commands |
| Write | Create new files |
| Grep | Search file contents |
| Glob | Find files by pattern |
Branch Strategy
| Strategy | Description |
|---|
| Use existing branch | Work directly on your current branch (default for the first agent) |
| Create new worktree | Pentagon creates an isolated worktree with a new branch (default for subsequent agents) |
The first agent in a repo defaults to the existing branch. Subsequent agents automatically get new worktrees to prevent file conflicts.
Global Settings
Access global settings with Cmd + , (Preferences).
Theme
Choose from 16 built-in themes (12 dark, 4 light). Pentagon Dark is the default. See Interface Tour for the full list.
Grid Overlay
The canvas grid lines are always visible but styled per-theme with low opacity. No separate toggle is needed.
Agent Shape
Configure the default desk shape for new agents. Options range from circles to hexagons to other polygons. Individual agents can override the global default.
Data Storage
Pentagon stores all data locally in ~/.pentagon/:
~/.pentagon/
├── agents/ # Per-agent config, identity files, status
│ └── {uuid}/
│ ├── config.json
│ ├── SOUL.md
│ ├── TASKS.md
│ ├── MEMORY.md
│ ├── heartbeat-config.json
│ ├── status.json
│ └── report.json
├── pods/ # Pod configurations
├── teams/ # Team configurations
├── souls/ # Reusable soul templates
├── hooks/ # Hook scripts (auto-generated)
└── canvas-layout.json
Environment Variables
Pentagon passes environment variables to Claude Code processes:
# Required — set in your shell profile
export ANTHROPIC_API_KEY=sk-ant-...
# Optional — custom API endpoint
export ANTHROPIC_API_BASE=https://your-proxy.com
# Optional — default model override
export ANTHROPIC_MODEL=claude-sonnet-4-20250514
ANTHROPIC_MODEL environment variable.
Backup and Data Clearing
Backup
Copy the .pentagon folder:
cp -r ~/.pentagon ~/backups/pentagon-backup-$(date +%Y%m%d)
~/.pentagon by default.
Clearing Data
To reset Pentagon completely:
This deletes all agent configurations, identity files, and conversation history. This is irreversible.
Next Steps
