AGENTS.md@cli git:20260620.23769dfA

Immutable. This exact content is served forever at /api/v1/blob/8757e9fddb828cb4.

# CLI subtree — operator pointer

This file is **not** the issue-tracker or workflow source of truth. Read the repo root contracts first:

- [`../AGENTS.md`](../AGENTS.md) — canonical operator contract
- [`../docs/architecture/codebase-overview.md`](../docs/architecture/codebase-overview.md) — map, footguns, active waist

## Issue tracker (br only)

```bash
BEADS_DIR="$(ao beads dir)" br ready              # Find available work
BEADS_DIR="$(ao beads dir)" br show <id>          # View issue details
BEADS_DIR="$(ao beads dir)" br update <id> --claim  # Claim work
BEADS_DIR="$(ao beads dir)" br close <id> -r "Done" # Complete work
```

**bd/Dolt is retired legacy (2026-06-11).** Do not run `bd` here. Sync the private ledger with `git -C "$(ao beads dir)" push`; never stage that ledger from the public repo.

## CLI development

```bash
cd cli && make build   # Build ao binary
cd cli && make test    # Run tests
cd cli && make lint    # Run linter
```