# BWorlds CLI

- [Overview](/docs): What BWorlds does for a Build, and what the bworlds CLI lets you and your coding agent do with it.
- [Quickstart](/docs/quickstart): Install the binary, sign in, pick a Build, and read its Audit. Five minutes, nothing charged.
- [Coding agent workflows](/docs/agent-workflows): Give Claude Code, Codex, or another coding agent verified Build context and production evidence before it changes code.
- Concepts
  - [Product model](/docs/concepts/product-model): Build, Workspace, Audit, Control, Finding, Dossier, and the production signals around them. The words the CLI speaks.
  - [Access and context](/docs/concepts/access-and-context): One identity, a Workspace Membership as the whole grant, and an explicit Build on every command.
  - [Security boundaries](/docs/concepts/security-boundaries): What the server enforces, how repository credentials are handled, and which commands ask for confirmation.
- Guides
  - [Audits and Controls](/docs/guides/audits): Read the current Audit, run any available Audit, check one Control after a fix, and correct a verdict you verified yourself.
  - [Production evidence](/docs/guides/production): See what breaks in production and what your users live through, then turn it into a Finding the Builder can act on.
  - [Fix in the repository](/docs/guides/repository): Clone, reproduce locally on the Build's seed, and push a fix through short-lived, repository-scoped access.
  - [Shared memory](/docs/guides/shared-memory): Findings and the Dossier keep what you learned where the Builder and the next operator will find it.
  - [Agents and automation](/docs/guides/automation): Run bworlds without a browser or a prompt, consume stable JSON and exit codes, retry paid commands safely, and run it in GitHub Actions.
- Reference
  - [Reference](/docs/reference): Installation, authentication, pricing, troubleshooting, and the generated command reference for this CLI version.
  - [Installation and updates](/docs/reference/installation): Install a versioned release without repository access, verify its checksum, and pin it in automation.
  - [Authentication and tokens](/docs/reference/authentication): Sign in from a terminal, or create a revocable personal token for a coding agent, a remote machine, or CI.
  - [Pricing and tokens](/docs/reference/pricing): Which commands consume Workspace tokens, how much, who pays, and how to retry a paid command safely.
  - [Troubleshooting](/docs/reference/troubleshooting): Diagnose identity, access, billing, network, and repository failures.
  - [CLI command reference](/docs/reference/cli): Generated reference for every bworlds command and flag.