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

# Detail CLI: Consume bugs and manage rules from the terminal

> The Detail CLI gives you full access to your Detail workspace from the terminal. Triage bugs, manage rules, inspect scans, and more.

The Detail CLI (`detail`) gives you full access to your Detail workspace from the terminal. Use it to triage bugs, manage custom rules, and inspect scan history.

## What you can do

Each top-level command maps to a core concept in Detail. Run any of them with `--help` to see the available subcommands and options.

| Command        | What it does                                                       |
| -------------- | ------------------------------------------------------------------ |
| `detail bugs`  | List, view, close, and reopen bug findings                         |
| `detail rules` | Create, propose, and inspect custom analysis rules                 |
| `detail scans` | List recent scans and filter by status, date, or type              |
| `detail repos` | List repositories connected to your Detail account                 |
| `detail auth`  | Authenticate with your Detail account                              |
| `detail skill` | Install Detail skills into your repo's `.claude/skills/` directory |

## Installation

The CLI is a single static binary with no runtime dependencies. Install it on macOS, Linux, or Windows. See the [Installation guide](/cli/installation) for the full steps.

## Authentication

Before running any command, authenticate with your Detail account using `detail auth login`. The CLI supports a browser-based OAuth flow for local development and a `--token` flag for CI/CD pipelines. See the [Authentication guide](/cli/authentication) for details.

## Next steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/cli/installation">
    Install the Detail CLI on macOS, Linux, or Windows.
  </Card>

  <Card title="Authentication" icon="key" href="/cli/authentication">
    Log in with your Detail account or an API key.
  </Card>

  <Card title="Bugs" icon="bug" href="/cli/commands/bugs">
    List, view, close, and reopen bug findings.
  </Card>

  <Card title="Rules" icon="shield-check" href="/cli/commands/rules">
    Create and manage custom analysis rules.
  </Card>
</CardGroup>

## Getting help

Run `detail --help` for a top-level overview of every command. Append `--help` to any subcommand for focused usage information:

```bash theme={null}
detail --help
detail bugs --help
detail rules create --help
```

To enable tab completion in your shell, use `detail completions`:

```bash theme={null}
# Bash
source <(detail completions bash)

# Zsh
source <(detail completions zsh)

# Fish
detail completions fish | source

# PowerShell
detail completions powershell | Out-String | Invoke-Expression
```

See the [Installation guide](/cli/installation) for how to persist completions across shell sessions.