Skip to main content
Pentagon is a native macOS app. No Node.js, no npm — just download and run.

​
Prerequisites

Before installing Pentagon, ensure you have:
  1. macOS 14 (Sonoma) or later
  2. Claude Code CLI installed — Installation guide
  3. An Anthropic API key or Claude Max subscription

​
Install

​
First Launch

When you first open Pentagon, macOS may show a Gatekeeper warning because the app is downloaded from the internet.
  1. If you see “Pentagon can’t be opened”, right-click the app and select Open, then click Open in the dialog.
  2. Pentagon will request file access permissions — click Allow when prompted. Pentagon needs access to:
    • ~/.pentagon/ — stores agent configurations and identity files
    • ~/.claude/ — reads Claude Code transcripts
    • Your project directories — where agents operate
  3. For full functionality, grant Full Disk Access in System Settings → Privacy & Security → Full Disk Access.
Pentagon shows a helpful dialog if it detects permission issues, with a button to open System Settings directly.

​
Verifying Claude Code

Pentagon requires the Claude Code CLI to be installed and accessible. To verify: 
claude --version
If this command fails, follow the Claude Code installation guide first. Pentagon searches for claude in standard locations:
  • /usr/local/bin/
  • /opt/homebrew/bin/ (Apple Silicon)
  • ~/.npm-global/bin/
  • Any path in your $PATH

​
Updating Pentagon

Pentagon checks for updates automatically on launch via Sparkle. You can also check manually:
  • Pentagon menu → Check for Updates…
If you installed via Homebrew, run brew upgrade --cask pentagon.

​
Next Steps

  1. Spawn your first agent
  2. Take the interface tour
  3. Configure settings