Stream separation
stdout carries the final machine payload; logs, progress, and structured
error envelopes go to stderr.
ax-go
The Agentic Experience foundation for Go CLI tools — predictable for LLM agents, ergonomic for human engineers.
Deterministic by contract
The same inputs produce byte-identical stdout, modulo documented
non-deterministic fields (timestamps, trace IDs).
Agent-safety primitives
--idempotency-key, --dry-run, and --format mode resolution are
first-class on every command.
Self-describing
Every CLI exposes __schema; __schema --as=mcp adapts it to an
MCP-compatible tool description.