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

# Doppels: Freeze AI Agent Sessions into Replayable Recipes

> Doppels turns AI agent sessions into deterministic YAML Recipes you run locally. Freeze once, replay forever — zero tokens after the first run.

Doppels is a CLI tool that turns one-off AI agent sessions into replayable, locally-executed automations. You explore a problem with Cursor, Claude, Codex, or OpenCode — then ask the agent to freeze what it just did. The agent writes a typed, validated **Capability** (the contract) and a **Recipe** (the steps) straight into your repo. Every subsequent run executes locally on your machine, consuming zero AI tokens.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/introduction">
    Understand what Doppels is, the problem it solves, and the core concepts: Capabilities, Recipes, and Runs.
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Install the `doppels` CLI via curl, Homebrew, or build from source on macOS or Linux.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Initialize a Space, validate manifests, and run your first Capability in under five minutes.
  </Card>

  <Card title="How It Works" icon="gear" href="/concepts/how-it-works">
    Dive deeper into the Capability–Recipe–Run model and how the freeze skill interacts with the CLI.
  </Card>
</CardGroup>

## Get started in three steps

<Steps>
  <Step title="Install the Doppels CLI">
    Download the binary using the one-line curl installer:

    ```shell theme={null}
    curl -fsSL https://raw.githubusercontent.com/doppelshq/doppels/main/install.sh | sh
    ```

    Verify the install:

    ```shell theme={null}
    doppels --version
    ```
  </Step>

  <Step title="Install the freeze skill">
    Add the `doppel-freeze` skill to your agent (once per machine or project):

    ```shell theme={null}
    npx skills add doppelshq/doppels --skill doppel-freeze
    ```

    The skill teaches Claude, Cursor, Codex, or OpenCode how to write valid Capability and Recipe YAML and validate it with the CLI.
  </Step>

  <Step title="Ask your agent to freeze what it just did">
    Do your real work in the agent — deploy, migrate, fix prod, automate a report. When it works, tell the agent:

    > doppel freeze — turn what we just did into a Capability

    The agent writes YAML into `capabilities/` and `recipes/`, loops `doppels validate` until clean, and asks you to confirm before it's done. Commit the YAML to git — that's your reusable asset.
  </Step>
</Steps>

<Note>
  **Zero tokens on replay.** The freeze step happens once while the agent is working. Every subsequent `doppels run` executes the deterministic Recipe locally — no model calls, no re-prompting, no cost.
</Note>

<Tip>
  Recipes are plain YAML committed to your repo alongside your source code. Fork them, review them in PRs, and share them with teammates — execution always stays on the local machine.
</Tip>