CLI Command Reference

The t2 CLI is the Agent Wallet in a terminal. Install once, then every command below works for a human at a shell and for an agent driving it programmatically — add --json to any command for machine output.

npm install -g @t2000/cli
t2 init          # wallet + free on-chain Agent ID

Wallet

Command	What it does
`t2 init`	Create the wallet (Bech32 key file, `0o600` perms) and register a free on-chain Agent ID. `--import` brings an existing secret; `--no-register` skips registration (offline/CI).
`t2 fund`	Show the wallet address + QR to fund it (USDC / USDsui / SUI on Sui).
`t2 balance`	All holdings — USDC / USDsui / SUI USD-priced, other tokens amount-only.
`t2 history [digest]`	Transaction history, or detail for one digest.
`t2 status`	Health check: wallet, balances, limits, MCP wiring, gateway reachability.
`t2 export`	Print the wallet secret for backup / recovery.

t2 balance --json
t2 history          # last transactions, newest first

Move money

Command	What it does
`t2 send <amount> <asset> <recipient>`	Send USDC, USDsui, or SUI. USDC + USDsui are gasless. Recipient: `0x…` address, SuiNS name, or `@audric` handle.
`t2 swap <amount> <from> <to>`	Swap any token pair via the Cetus aggregator. `--quote` previews without executing; `--slippage <pct>` caps slippage (default 1%).

t2 send 5 USDC alice.sui
t2 swap 100 USDC SUI --quote

Pay APIs (x402)

Command	What it does
`t2 pay <url>`	Pay an x402-protected endpoint in USDC — handles the 402 challenge → pay → retry loop. `--data` sends a JSON body, `--max-price` caps auto-approval (default $1.00), `--estimate` previews the price without paying.
`t2 services search <query>`	Search the gateway catalog by name, category, or endpoint.
`t2 services inspect <url>`	Pricing + endpoints for one service.

t2 services search "chat"
t2 pay https://mpp.t2000.ai/deepseek/v1/chat/completions \
  --data '{"model":"deepseek-chat","messages":[{"role":"user","content":"hi"}]}'

Private AI

Needs an API key — mint one at agents.t2000.ai/manage or with t2 agent onboard, then pass --api-key or set T2000_API_KEY.

Command	What it does
`t2 chat <message>`	Chat with a model on Private Inference (OpenAI-compatible, zero data retention; `phala/*` models are GPU-TEE confidential).
`t2 models`	The model catalog — id, privacy tier, per-1M pricing.
`t2 verify <receipt-id>`	Verify a confidential response: checks the signed receipt against its on-chain Sui anchor. Fails closed on any mismatch.

t2 chat "summarize this repo" --model phala/qwen3-coder
t2 verify rcpt_abc123

Identity (Agent ID)

Registration is free and sponsored — no gas, no funding.

Command	What it does
`t2 agent create`	Wallet + on-chain Agent ID + profile in one pass. `--owner <address>` proposes a human owner.
`t2 agent register`	Register this wallet on-chain as an Agent ID. Idempotent.
`t2 agent profile`	Set the public profile — name, image, description, links.
`t2 agent handle <label>`	Claim `<label>.agent-id.sui` for this wallet. `--release` gives it up.
`t2 agent link <owner>`	Propose an owner (two-sided — the owner confirms in the console).
`t2 agent confirm <agent>`	Confirm ownership of an agent that proposed you.
`t2 agent unlink <agent>`	Renounce ownership — the record returns to autonomous.
`t2 agent onboard`	Buy-side setup: fund credit (gasless USDC/USDsui) + mint a Private Inference key.
`t2 agent topup <amount>`	Top up credit from the wallet — call it on a 402 or on a schedule.
`t2 agents [address]`	The public directory: list registered Agent IDs, or one identity profile.

t2 agent create --name "Atlas Research" --description "Market research on demand"
t2 agents --category research

Spending limits

On by default:

25 per transaction,

100 per day. Any write can bypass a limit once with --force.

Command	What it does
`t2 limit show`	Current limits.
`t2 limit set`	`--per-tx <usd>` and/or `--daily <usd>`.
`t2 limit reset`	Clear all limits.

MCP & skills

Command	What it does
`t2 mcp`	Start the MCP stdio server — the wallet as tools for any MCP client.
`t2 mcp install`	Auto-configure Claude Desktop, Cursor, and Windsurf. `uninstall` removes it.
`t2 skills list`	Skills available from t2000.ai.
`t2 skills install [slug]`	Install skill playbooks locally (`--target cursor` writes `.mdc` rules).
`t2 skills check`	Are installed skills current? Agents: run at session start.

Global flags

Flag	Applies to	What it does
`--json`	every command	Machine-readable output.
`--key <path>`	wallet commands	Custom wallet path (default `~/.t2000/wallet.key`).
`--force`	writes	Override spending limits for this call.

Run t2 <command> --help for the full flag list of any command — the CLI’s own help is the source of truth.

​Wallet

​Move money

​Pay APIs (x402)

​Private AI

​Identity (Agent ID)

​Spending limits

​MCP & skills

​Global flags