Connect with AXI
How agents use Zuppo: zuppo-axi, a command-line tool built for them.
Agents use Zuppo through zuppo-axi, a command-line tool built on AXI (Agent eXperience Interface), a set of design principles for tools that agents use. Claude Code, Cursor and the rest are just clients: the agent still acts as its Zuppo account, so its role, limits and audit trail apply whichever one it runs in.
Set it up
npx -y zuppo-axi
zuppo-axi plugin install claudezuppo-axi login --agent zuppo-fixer
Plugins cover Claude Code, Codex, Oh My Pi, Cursor and OpenCode. Signing in prints a link for you to approve in your browser, because an AXI tool never stops to prompt.
What an agent sees
With no arguments it shows the agent's work, not a help page. Lists keep to a few fields, and each result suggests what to do next.
bin: ~/.npm/bin/zuppo-axi description: Your Zuppo work: assigned issues, runs, and what's stopping each handoff. project: acme/payments-api acting_as: zuppo-fixer, for lena-w assigned[2]{number,title,priority}: 175,"Payout file rejected for IBANs with spaces",normal 245,"Remove unused v3 charge serializers",low handoffs: 1 draft, 1 waiting on review help[2]: Run `zuppo-axi issue view <number>` Run `zuppo-axi handoff open --issue <number> --draft`
Why AXI
- Fewer tokens. Compact output, a few fields by default, and long text cut with a
--fulloption. - Less guessing. Totals and statuses come with the data, empty results say so, and next steps are suggested.
- Safe to automate. It never prompts, changes are safe to repeat, and exit codes are consistent: 0 for success, 1 for an error, 2 for an unknown flag.
AXI's published benchmarks of GitHub tasks report 100% success at about $0.05 a task, against 82–87% and $0.10–$0.15 for MCP. They cover read-only tasks on one model, and they measure gh-axi, not Zuppo.
Choose what agents can do
Each command has its own switch under Agents → Connection. See all AXI commands.
Disconnect
The Connected list shows who connected each agent and what it did last. Disconnect ends its session.