docs(cli): package and document Zoo CLI

[taltas]

Stack

Position 6 of 6 in the Zoo CLI stack.

• Parent/base: fm/zoo-cli-interactive (PR feat(cli): add interactive Zoo terminal client #1160)
• Top of stack
• Native local ancestry is preserved; GitHub uses the recorded classic fallback because native stacked PR submission is unavailable for this repository.

Scope

• Adds relocatable lockstep client, bundled private host, production extension, runtime dependencies, checksums, and supported macOS ARM64/Linux x64/Linux ARM64 release artifacts.
• Adds release gates for protocol, host, packaged subprocess, build, help, and version behavior.
• Documents installation, interactive and automation workflows, approvals/threat model, credentials/vaults, project compatibility, sessions/resume, output contracts, signals/timeouts, ephemeral behavior, supported platforms, non-goals, troubleshooting, and roo coexistence.
• Adds security, privacy/telemetry, artifact, rollback, and support review evidence.
• Links the CLI from the main README and tests documented command discoverability against live help.

Acceptance Evidence

• pnpm --dir packages/zoo-host build, test, and typecheck
• pnpm --dir apps/zoo test (11 tests) and typecheck
• Repository pre-commit lint and pre-push typecheck
• Documentation formatted and live-help consistency tested

Risk

The initial artifact matrix is intentionally narrow and release lockstep is mandatory. Modes/models metadata commands remain withheld because canonical queries currently activate mutable extension services. Signing and publication credentials remain maintainer-controlled.

flowchart LR
    C[apps/zoo client] --> A[Relocatable artifact]
    H[Bundled zoo-host] --> A
    E[Production extension] --> A
    D[Runtime dependencies] --> A
    A --> M{Supported matrix}
    M --> MA[macOS ARM64]
    M --> LX[Linux x64]
    M --> LA[Linux ARM64]
    MA --> S[Smoke, checksum, upload]
    LX --> S
    LA --> S

Loading

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f9bee49b-dec5-4a70-9b36-97a63ab5ab68

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!