axi

What problem does it solve?

AXI standardizes how agent-facing CLI tools should communicate so autonomous agents can reliably interpret outputs and complete next actions without wasting tokens.

Core Features & Use Cases

• Token-efficient stdout: Uses TOON for structured, agent-readable output with reduced token cost compared to equivalent JSON.
• Lean default schemas: Minimizes fields in list outputs and supports an explicit mechanism (like a --fields flag) to fetch more only when needed.
• Practical truncation strategy: Provides truncated previews of large fields along with clear “how to get the full content” guidance.
• Actionable aggregates and empty states: Includes total counts and definitive “nothing found” messaging to prevent unnecessary re-checks.
• Agent-safe operational rules: Uses structured errors in stdout, avoids interactive prompts, supports idempotent mutations, and recommends session-start hooks for ambient context.

Quick Start

Instruct your AI assistant to “Review my CLI’s list, detail, and mutation commands against AXI and propose changes so stdout is TOON-based, token-efficient, truncates large fields responsibly, and returns structured errors with useful next commands.”