All Projects

cmdproto: Proto-First Command ABI

View Code

Proto-first command ABI toolkit for tool-shaped apps, with one schema for human CLI use, per-command help, and machine JSON execution.

TypeScript Go Protobuf CLI Tooling

Contract Architecture for Agent Tools

AI tooling needs command contracts that are reliable for both human operators and machine callers. cmdproto defines command surfaces from protobuf descriptors instead of hand-maintained CLI glue, keeping command paths, flags, aliases, examples, and JSON request examples beside the service contract.

The V1 implementation focuses on a strict manifest-driven CLI and JSON execution surface: human commands, per-command help, structured help, and execjson calls backed by compiled protobuf descriptor artifacts.

Engineering Focus

  • Schema-led commands: Command paths, flags, positional parameters, and examples live beside the protobuf service contract.
  • Human and agent use: The same command manifest supports CLI help and machine JSON payload execution.
  • Consumer bootstrap: I included a bootstrap path for Buf configuration, starter proto files, and TypeScript runtime wiring.