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

# CLI Overview

> The Traceback Command Line Interface for managing source maps, local simulations, and project settings.

The Traceback CLI (`traceback`) provides terminal commands to automate source map uploads in CI/CD, run local replay debugging, and inspect project health.

## Installation

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @traceback/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @traceback/cli
  ```

  ```bash Homebrew (macOS / Linux) theme={null}
  brew install traceback-dev/tap/traceback
  ```

  ```bash Standalone Binary (cURL) theme={null}
  curl -fsSL https://get.traceback.dev | sh
  ```
</CodeGroup>

***

## Authentication

Authenticate the CLI with your Traceback account:

```bash theme={null}
traceback login
```

Alternatively, set the environment variable:

```bash theme={null}
export TRACEBACK_AUTH_TOKEN="tb_token_193829048204"
```

***

## Available Commands

<CardGroup cols={2}>
  <Card title="traceback init" icon="wand-magic-sparkles" href="/cli/commands/init">
    Bootstrap Traceback configuration in an existing repository.
  </Card>

  <Card title="traceback sourcemaps" icon="file-arrow-up" href="/cli/commands/sourcemaps">
    Validate and upload JavaScript / TypeScript source maps to Traceback.
  </Card>

  <Card title="traceback capture" icon="bug" href="/cli/commands/capture">
    Send synthetic test events and verify pipeline connectivity.
  </Card>

  <Card title="traceback replay" icon="play" href="/cli/commands/replay">
    Download and inspect session replay streams locally.
  </Card>

  <Card title="traceback doctor" icon="stethoscope" href="/cli/commands/doctor">
    Run diagnostic checks on your environment, SDK installation, and network routes.
  </Card>
</CardGroup>