> ## 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.

# Installation

> Download and set up Pentagon on your Mac

# Installation

Pentagon is a native macOS application. Download it, install it, and you're ready to start building your team.

## Requirements

* **Apple Silicon Mac** running **macOS 15 (Sequoia) or later**
* **Git** installed
* At least one supported coding-agent CLI signed in: **[Claude Code](https://claude.ai/install)** or **[Codex](https://github.com/openai/codex)** (you can install both)

<Steps>
  <Step title="Install a coding-agent CLI">
    Pentagon runs each agent on top of a coding-agent CLI. Install at least one — most users start with Claude Code:

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    claude  # authenticate
    ```

    Or use Codex if you prefer OpenAI's models. Follow the prompts to sign in. You can install both and pick per agent later — see [Agent Runtimes](/agents/runtimes).
  </Step>

  <Step title="Download Pentagon">
    Download the latest version from [pentagon.run/download](https://pentagon.run/download). Open the `.dmg` and drag Pentagon to your Applications folder.
  </Step>

  <Step title="Launch and sign in">
    Open Pentagon from your Applications folder and sign in with Google or GitHub.

    First-time users land in [Workspace Setup](/workspace-setup) — a short guided flow that takes you from "who are you" to your first agent running on the canvas. Returning users skip straight to where they left off.
  </Step>
</Steps>

## Updates

Pentagon checks for updates automatically and prompts you when a new version is available. Updates install in-place — your maps, agents, conversations, and knowledge are preserved.

## Data storage

Pentagon is cloud-backed. Your agent conversations, documents, and workspace metadata sync to the cloud so they're available across sessions and to your teammates.

* **Conversations, agent documents, and knowledge** — synced to the cloud
* **Source code and project files** — stay on your local machine
* **Settings and preferences** — stored in macOS UserDefaults

Your source code never leaves your machine. Only agent conversations and workspace metadata cross the wire.

<Card title="Next: Workspace Setup" icon="wand-magic-sparkles" href="/workspace-setup">
  Walk through the first-launch setup flow, step by step.
</Card>