Design and implement a "robot mode" CLI for this project.
The CLI should be optimized for use by AI coding agents:
- JSON Output: Add --json flag to every command for machine-readable output
- Quick Start: Running with no args shows help in ~100 tokens
- Structured Errors: Error responses include code, message, suggestions
- TTY Detection: Auto-switch to JSON when piped
- Exit Codes: Meaningful codes (0=success, 1=not found, 2=invalid args, etc.)
- Token Efficient: Dense, minimal output that respects context limits
Think about what information an AI agent would need and how to present it most efficiently.
Design the interface before implementing.
When to Use
- When building a new CLI tool
- When adding agent-friendly features to existing CLI
- When optimizing human-centric tools for AI use
Tips
- Start with the most common agent workflows