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

# Quickstart

> Install the CLI and start a repeatable Simulation.

This guide starts a ready Simulator from your workspace or the shared catalog.

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    curl -fsSL https://app.continuouslabs.ai/install.sh | sh
    ```

    Add `~/.local/bin` to your `PATH` if the installer asks you to do so.
  </Step>

  <Step title="Sign in">
    ```bash theme={null}
    continuous auth login
    ```

    Approve the browser prompt or paste a Workspace API key from the app.
  </Step>

  <Step title="Choose a ready Simulator">
    ```bash theme={null}
    continuous simulator list --status ready
    ```

    Copy a Simulator ID or a `name:tag` reference from the result.
  </Step>

  <Step title="Start a Simulation">
    ```bash theme={null}
    continuous simulation create \
      --simulator <simulator-ref> \
      --seed quickstart \
      --clock-start 2026-01-01T00:00:00Z
    ```

    The seed and clock start pin injected randomness and virtual time.
    Save the returned Simulation ID, endpoint, and token. The command returns the token only once.
  </Step>

  <Step title="Inspect the Simulation">
    ```bash theme={null}
    continuous simulation get <simulation-id>
    continuous simulator openapi <simulator-ref>
    ```

    The first command shows lifecycle state and the endpoint. The second command shows the simulated system API.
  </Step>
</Steps>

## Call the simulated system

Each Simulator defines its own paths. Send the one-time Simulation token to its endpoint.

```bash theme={null}
curl "$SIMULATION_ENDPOINT/<path>" \
  --header "Authorization: Bearer $SIMULATION_TOKEN"
```

<Note>
  The Simulation token authenticates only its data-plane endpoint. Your Workspace API key authenticates supported control-plane routes.
</Note>

Use the [API reference](/api-reference/overview) for exact control-plane requests, responses, and authentication rules.

<Columns cols={2}>
  <Card title="Understand Simulations" icon="play" href="/concepts/simulations">
    Learn about state, seeds, tokens, and lifecycle controls.
  </Card>

  <Card title="Connect systems" icon="network" href="/concepts/worlds">
    Use a World when an agent needs more than one system.
  </Card>
</Columns>