AXI

AI Web Dev entity developing

updated today 1 source

AXI

AXI (Agent eXperience Interface) is a set of 10 design principles for building agent-ergonomic CLI tools, along with reference implementations for GitHub (gh-axi) and browser automation (chrome-devtools-axi). Created by Kun Chen, AXI treats token budget as a first-class design constraint and achieves 100% task success at the lowest cost across two independent benchmarks totaling 915 runs.

The 10 Principles

See Agent-Tool Interfaces for the broader context of why these principles matter.

Efficiency

Token-efficient output — use TOON format for ~40% token savings over JSON
Minimal default schemas — 3–4 fields per list item; agents request additional fields via --fields
Content truncation — truncate large fields with size hints and --full escape hatches

Robustness

Pre-computed aggregates — always include totalCount, computed CI status summaries, and other derived fields that eliminate round trips
Definitive empty states — explicit “0 results” rather than ambiguous empty output
Structured errors & exit codes — idempotent mutations, structured errors on stdout, no interactive prompts

Discoverability

Ambient context — self-install into session hooks so agents see relevant state before their first action
Content first — running a command with no arguments shows live data, not help text
Contextual disclosure — append help[] lines with concrete next-step command templates after each output

Help

Consistent --help — concise per-subcommand reference as a fallback

Reference Implementations

gh-axi — GitHub operations. 100% success at $0.050/task across 425 runs, vs. 86%/$0.054 for raw gh CLI and 82–87%/$0.101–$0.148 for MCP.
chrome-devtools-axi — browser automation. 100% success at $0.074/task across 490 runs, leading all seven conditions on every metric (cost, duration, turns, success).

Key commands that demonstrate the principles:

open <url> --query <filter> — combines navigate + snapshot + search into one operation (principles 1, 4, 9)
fill @<uid> <value> --submit — fills a form field, submits, waits for load, and returns snapshot (principle 4)
tables --url <url> — navigates and extracts structured table data in a single step (principles 1, 2)

Installation

# Use via npx
npx -y gh-axi           # GitHub operations
npx -y chrome-devtools-axi  # Browser automation

# Build your own AXI
npx skills add kunchenguid/axi

Sources

Source - AXI Agent eXperience Interface

AXI

AXI