Context Circuit CLI
A native tool for dependable bookkeeping and Git mechanics. The agent supplies judgment.
The Context Circuit CLI is a native command-line tool. It initializes workspace files, manages members and bindings, retrieves catalog entries, creates records, records decisions already made, derives dependency order, prepares worktrees, and produces diagnostics.
It does not call a model, execute a plan, run application setup, commit, push, merge, deploy, or start an independent review. It neither supplies human consent nor treats an editable field as approval.
Each workspace pins a CLI version in .context-circuit/CLI_VERSION. Installed versions coexist. The shared command on PATH is not proof that you are running this workspace's pin. Resolve the versioned executable each time you change workspaces.
What you use it for
context-circuit-cli version
context-circuit-cli help
context-circuit-cli --workspace . --json status
Normal output is readable YAML. --json returns structured values. Errors go to stderr with a nonzero exit status. The agent still does the reasoning; the CLI keeps the files and Git mechanics dependable.
- Installation
- Verified native binaries, installed side by side from the workspace pin.
- Commands
- The available surface, and what it will not do.
- Version pinning
- How a workspace names the CLI it expects.
- Repository and worktree operations
- Connect checkouts and prepare isolated working copies.
- Diagnostics
- Structured facts about workspace consistency, not permission to repair.