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

# CLI

> Sign in, the conventions every command shares, and where each stage's commands live.

Install and first steps are in the [Quickstart](https://docs.selfbench.dev/quickstart.md). `self-bench help` lists every command in your terminal.

## Sign In and CI

`login` saves a personal API key to `~/.config/self-bench/config.json`, readable only by you. On a remote machine, paste the address the browser lands on into the login page. `logout` revokes the key.

In CI, skip `login` and set `SELFBENCH_API_KEY` (from **Settings → API Keys**) and `SELFBENCH_ORG`. `SELFBENCH_API_URL` or `login --api-url` points at a self-hosted deployment.

## Conventions

* **Workspace.** Commands act in the workspace `login` chose. `org use` changes it; `--org` overrides it once.
* **Scope.** `R` in the command tables is `--repo OWNER/NAME`. An eval is `evals/NAME`. `--benchmark ORG/NAME` and `--group SLUG` take its place.
* **Tasks** are named by batch and ID: `RUN_ID TASK_ID`.
* **Configurations** are named by the `KEY` that `results` prints.
* **Output.** Tables on a terminal, JSON when piped or with `--json`, so `self-bench results --repo acme/app | jq` works.
* **Background work.** Explanations, audits, and summaries return at once. Add `--wait` to wait and print the answer.

## Commands

| Page | Commands |
| - | - |
| [Account and Credentials](https://docs.selfbench.dev/cli/account.md) | `login`, `org`, `whoami`, `credential` |
| [Build Tasks](https://docs.selfbench.dev/cli/build.md) | `repo`, `eval create`, `prs`, `generate`, `task add-pr`, `scenario create`, `batch` |
| [Review Tasks](https://docs.selfbench.dev/cli/review.md) | `tasks`, `task show\|pull\|revise\|steer\|approve\|reject` |
| [Repo Ablations](https://docs.selfbench.dev/cli/environments.md) | `environments`, `environment create\|show\|build\|delete` |
| [Harnesses](https://docs.selfbench.dev/cli/harnesses.md) | `harnesses`, `harness create\|show\|update\|delete` |
| [Evaluate](https://docs.selfbench.dev/cli/evaluate.md) | `catalog`, `compare`, `comparison`, `run` |
| [Inspect Results](https://docs.selfbench.dev/cli/inspect.md) | `results`, `task results\|explain\|audit`, `summaries` |
| [Publish](https://docs.selfbench.dev/cli/publish.md) | `release preview\|publish\|withdraw` |
| [Benchmarks and Groups](https://docs.selfbench.dev/cli/benchmarks-and-groups.md) | `benchmark`, `group` |
| [Operator](https://docs.selfbench.dev/cli/operator.md) | `status`, `download`, `grant` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.