> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tempo.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Install Tempo and connect Claude or Codex — about ten minutes.

## 1. Install

<Tabs>
  <Tab title="macOS">
    1. Open the `.dmg` and drag **Tempo** into Applications.
    2. On first launch, if macOS warns you, go to **System Settings → Privacy & Security**, scroll to the bottom, and click **Open Anyway**.
    3. Grant Full Disk Access and Accessibility when prompted (toggleable later in the same place).
  </Tab>

  <Tab title="Windows">
    1. Run the installer. If SmartScreen warns you, click **More info → Run anyway** — Tempo installs to your user folder, no admin needed.
    2. If Tempo says Git is missing, install from [git-scm.com](https://git-scm.com) with the default options.
    3. Allow Tempo network access so the live preview can run.
  </Tab>
</Tabs>

## 2. Connect your AI account

Pick a provider and sign in. For Claude or Codex, run the command in the **Terminal** tab at the bottom of any workspace.

<Tabs>
  <Tab title="Claude Code (Anthropic)">
    Requires a paid Claude plan (Pro, Max, Team) or an API key from [console.anthropic.com](https://console.anthropic.com).

    ```bash theme={null}
    claude /login
    ```
  </Tab>

  <Tab title="Codex (OpenAI)">
    Requires ChatGPT Plus / Pro / Team or an API key from [platform.openai.com](https://platform.openai.com/api-keys).

    ```bash theme={null}
    codex login
    ```
  </Tab>

  <Tab title="Tempo Inference">
    No CLI sign-in needed. Pick a Tempo Inference model from the chat's model dropdown to start.

    <Note>
      You can try the free **GPT-5.4-mini** model with no setup. It's good for quick edits and exploration, but trails the paid Claude and Codex models on longer or more complex tasks.
    </Note>
  </Tab>
</Tabs>

***

Working across multiple repos? See [Multi-Repo Workspaces](/guides/multi-repo).

Need Tempo to run a different `dev` command, install step, or environment? See [Setup & Run Scripts](/guides/setup-run-scripts).

## Next

<CardGroup cols={2}>
  <Card title="Docs" icon="file-lines" href="/product/docs">
    Write PRDs the agent reads as context.
  </Card>

  <Card title="Canvas" icon="palette" href="/product/canvas">
    Design surface backed by your real React components.
  </Card>

  <Card title="Issues" icon="kanban" href="/product/issues">
    Built-in Kanban with agent pickup.
  </Card>

  <Card title="Chat" icon="comments" href="/product/chat">
    Claude or Codex in isolated git worktrees.
  </Card>
</CardGroup>

Stuck? Reach out at [support@tempo.new](mailto:support@tempo.new).