Repo docs & further reading
Some topics live in the a2acli repository rather than on this site — either
because they are explicitly out of scope here (comparison, release process,
build/design internals) or because the repository holds the canonical source.
This page maps those topics to their locations. These are GitHub blob links, so
they resolve independently of this documentation site.
Canonical references
Section titled “Canonical references”- Reference Manual (
docs/MANUAL.md) — the full, canonical command reference: complete grammar, every flag, examples, output schemas, global flags, shell completion, and automation guidance. The command reference on this site is a curated, themed view of the same surface. - A2A specification (a2a-protocol.org) —
the protocol itself, which
a2acliimplements.
Excluded topics → repository location
Section titled “Excluded topics → repository location”These topics are intentionally out of scope for this site. Follow the link to the authoritative copy in the repository.
| Topic | Where it lives |
|---|---|
| Comparison vs the official a2a CLI | docs/COMPARISON.md |
| How to release | docs/RELEASING.md |
| CLI design / how-to-build rationale | docs/CLI_DESIGN_BEST_PRACTICES.md |
| Agent Registry Directory integration (build) | docs/ARD_INTEGRATION.md |
| Test plan | docs/TEST_PLAN.md |
| Test agents | docs/TEST_AGENTS.md |
| Sample conformance report | docs/CONFORMANCE_REPORT.md |
Contributing & development
Section titled “Contributing & development”- CONTRIBUTING.md
— how to contribute to
a2acli. - README → Development — building, testing, and working on the project locally.