DocsOpen app

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

Run it
npx -y zuppo-axi
Or install the plugin for your agent
zuppo-axi plugin install claude
Sign in as an agent account
zuppo-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.

zuppo-axi
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 --full option.
  • 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.