Skip to main content
Pentagon uses a three-panel layout built on NSSplitViewController for native macOS split-view behavior. 
[ Sidebar | Office Canvas | Detail Panel ]
The left panel provides organized access to your agents, pods, and teams.
  • Agent list — all agents with status indicators and branch info
  • Pod list — spatial groupings with agent counts
  • Team list — logical groupings with emoji identifiers
Toggle the sidebar with Cmd + B.

​
Office Canvas

The center panel is a 2D grid workspace where your agents live.

​
Agent Desks

Each agent appears as a desk on the grid with:
  • Status ring — colored border indicating state (green = ready, yellow = active, red = error, gray = dormant)
  • Initials badge — first two characters of the agent’s name
  • Agent color — unique color derived from the agent’s name
  • Clone indicators — + marks on adjacent empty cells for quick cloning

​
Pods

Pods appear as colored rectangular rugs on the canvas. Agents inside a pod’s bounds are automatically assigned to it. See Pods & Teams for details.
ActionInput
PanClick and drag, or scroll
ZoomCmd + scroll wheel, or pinch on trackpad
Zoom range0.25x to 4x
Reset viewClick the reset button (scope icon) in the bottom-right overlay

​
Canvas Tools

The toolbar in the bottom-left corner provides two modes:
ToolDescription
Select (cursor icon)Default. Click desks to select agents, click empty cells to spawn, drag to pan.
Pod (dashed rectangle icon)Click and drag to draw a new pod on the canvas.
There’s also a New Team button for creating logical team groupings.

​
Minimap

A minimap in the bottom-right corner shows an overview of all agents and pods. A cyan rectangle indicates your current viewport. Zoom controls (- / +) and a reset button sit below the minimap.

​
Detail Panel

The right panel shows details for the selected agent (or pod). It has five tabs:
TabContents
TerminalLive Claude Code session via SwiftTerm. Type prompts, see responses.
SoulEdit the agent’s SOUL.md — role, personality, instructions.
TasksView and manage the agent’s TASKS.md checkbox list.
HeartbeatConfigure restart behavior (manual, alwaysOn, interval, scheduled).
MemoryView the agent’s MEMORY.md — persistent context and learnings.
Toggle the detail panel with Cmd + J.

​
Command Palette

Press Cmd + K to open the command palette. It provides:
  • Fuzzy search across all commands
  • Theme switching
  • Quick access to any action
  • Keyboard navigation with arrow keys

​
Themes

Pentagon ships with 16 themes. Switch themes via the command palette (Cmd + K) or Preferences (Cmd + ,). Dark themes: Pentagon Dark (default), Dark+, One Dark Pro, GitHub Dark, Dracula, Nord, Monokai, Gruvbox Dark, Tokyo Night, Catppuccin Mocha, Ayu Dark, Solarized Dark Light themes: Light+, GitHub Light, Solarized Light, Ayu Light

​
Status Bar

The bottom status bar shows real-time information:
  • Total agent count
  • Active agent count
  • Panel toggle states

​
Next Steps