zh-CN
ZAN CLI

ZAN CLIBeta

A unified command-line interface for ZAN — manage projects, wallets, on-chain data, x402 payments, and AI Router Keys from your terminal or your AI coding agent.

ZAN CLI is in beta — capabilities and commands may change significantly in future releases.

Quick start

Install with your agent

Copy the prompt and paste it into your AI coding agent. The agent installs the ZAN CLI together with the ZAN skills pack, so it knows how to use every command.

Agent prompt
Install the ZAN CLI and set up its agent skill for me:
1. Install the CLI globally from npm with `npm install -g @zan_team/cli` (Node.js 22 or later is required).
2. The npm package ships a bundled `zan-cli` skill. Install it into your skill discovery path with `zan skills install`, choosing the agent I am using (for example `zan skills install --agent claude-code`).
3. Verify the setup by running `zan --version` and `zan agent manifest`, then report the result.
Capabilities

What you can do

Sign in

Authenticate your ZAN account from the terminal, or let your agent start a device code flow for you.

zan auth login
zan auth login --device-code

List your projects

Browse your ZAN projects and networks, switch the working context, and pull RPC keys into your app.

zan project list
zan project use <project-id>

Create wallets

Import and manage local wallets, switch the default account, and sign messages with an alias.

zan settings wallet add <alias>
zan sign "hello zan" --account <alias>

Query on-chain data

Check address balances, blocks, transactions, and event logs on EVM networks.

zan evm data balance <address>
zan evm tx <hash>

Pay for data with x402

Preview payment quotes and fetch data with USDC from your wallet, within a per-request budget.

zan x402 inspect <url>
zan x402 fetch <url> --account <alias> --max-amount 0.5

Query AI Router Keys

List your personal and team Router Keys, and check each Key’s credit limit, usage, and remaining quota.

zan router key list
zan router key get <key-id>
This page only covers the highlights — see the full command reference in the ZAN CLI README on npm.
Feedback

Report issues or ideas

Run into a problem or have a feature request? Reach out through the ZAN contact page and the team will follow up.

Contact us