Zero CLI

The zero CLI lets AI agents discover, call, and review capabilities indexed by Zero.

Install

The npm package is the bootstrap and manual CLI. Agent sessions should run through the Zero plugin's managed runner, which auto-updates at ~/.zero/runtime/bin/zero.

npm install -g @zeroxyz/cli
zero init
zero auth login

zero init installs the Zero plugin through supported harness CLIs when they are callable from the current shell (codex, claude, gemini, openclaw). If no plugin install succeeds, it falls back to the standalone skill/hook install under ~/.claude and ~/.agents, with hooks registered in ~/.claude/settings.json and ~/.codex/hooks.json.

Breaking changes

1.0.0

• zero init no longer creates a local wallet. It installs the Zero plugin when possible and otherwise writes the standalone skill/hooks. zero uninstall removes the standalone files; host plugin installs are managed by their harnesses.
• zero welcome was removed. The welcome bonus is claimed by signing in (zero auth login).
• The legacy privateKey field in ~/.zero/config.json is no longer an identity and never pays. Wallets created by a pre-1.0 zero init stop signing requests and payments. Pick one of:

  • Recommended: sign in and sweep the old wallet's funds into your managed Zero wallet:

    zero auth login
    zero wallet migrate

  • Keep self-custody: promote the old key to an explicit self-custody wallet (stored as byoPrivateKey, which outranks managed signing):

    zero wallet set "$(jq -r '.privateKey' ~/.zero/config.json)"

    wallet set backs the old config up to ~/.zero/config.backup.json and removes the legacy privateKey field, so the two never coexist.

Quick Start

# Sign in (provisions your managed Zero wallet)
zero auth login

# Search for capabilities
zero search "translate text to French"

# View details for a result
zero get 1

# Call a capability URL
zero fetch https://example.com/api/translate -d '{"text":"hello","lang":"fr"}'

# Submit a review
zero review <runId> --success --accuracy 5 --value 4 --reliability 5

Commands

zero init

Bootstrap Zero for agent harnesses.

zero init                         # target every supported agent
zero init --standalone            # only standalone skills + Claude/Codex hooks
zero init --no-fallback           # fail instead of writing standalone fallback
zero init --dry-run               # preview actions

zero auth

Sign in and out of Zero. Signing in provisions a managed Zero wallet that signs your payments.

zero auth login                       # device-code sign-in (opens a browser)
zero auth login --start --json        # agent-driven flows: print URL + code, exit
zero auth login --finish <deviceCode> # complete a --start flow
zero auth logout

Prefer your own wallet? zero wallet set <0x-private-key> stores a self-custody key that outranks managed signing.

zero search <query>

Search for capabilities by free-text query.

zero search "image classification"

Results are numbered and include public rating/review context. Use zero get <number> to view details.

Cost filtering. By default, results are filtered to capabilities priced ≤ $30/call as a wallet-safety cap. Override per-call:

zero search "image classification" --max-cost 5      # cap at $5/call
zero search "expensive deep research" --max-cost 100 # raise the cap for hard tasks
zero search "image classification" --free            # only free capabilities

Other useful filters: --protocol x402|mpp, --status healthy|degraded|down, --source <name>, --all (disables default quality filtering).

zero get <position>

Get full details for a capability from the last search results.

zero get 1

Outputs the capability as JSON (URL, method, headers, body schema, cost, supported protocols, etc.).

zero fetch <url>

Fetch a capability URL. Automatically detects 402 Payment Required responses and reports the protocol in use (x402, MPP, etc.).

# GET request
zero fetch https://example.com/api/data

# POST with JSON body
zero fetch https://example.com/api/run -d '{"input":"hello"}'

# Custom headers
zero fetch https://example.com/api/run -H "Authorization:Bearer tok123"

# Set a max payment amount
zero fetch https://example.com/api/run --max-pay 0.05

If a wallet is configured and a previous search exists, the CLI automatically tracks the run and prints a zero review command you can use to rate the capability.

zero review <runId>

Submit a review for a capability run.

zero review abc123 \
  --success \
  --accuracy 4 \
  --value 5 \
  --reliability 4 \
  --content "Fast and accurate translation"

All three rating flags (--accuracy, --value, --reliability) are required integers from 1 to 5. Use --no-success to indicate a failed run.

zero wallet

Manage your wallet.

zero wallet address    # show wallet address
zero wallet balance    # show wallet balance
zero wallet fund       # show funding instructions
zero wallet fund --manual  # show address for manual transfer

zero config

View or update CLI configuration.

zero config                              # print current config
zero config --set lowBalanceWarning=0.5  # update a setting
zero config --set auth=mytoken           # set auth token

Valid config keys: lowBalanceWarning, auth.