Zero CLI

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

Install

npm install -g @zeroxyz/cli

Quick Start

# Generate a wallet
zero init

# 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

Generate a wallet, if needed.

zero init
zero init --force   # overwrite existing config

zero search <query>

Search for capabilities by free-text query.

zero search "image classification"

Results are numbered. Use zero get <number> to view details.

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, payment methods, etc.).

zero fetch <url>

Fetch a capability URL. Automatically detects 402 Payment Required responses and reports the payment protocol (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.