> ## Documentation Index
> Fetch the complete documentation index at: https://developers.t2000.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Command Reference

> Every t2 command — wallet, payments, identity, Private Inference, MCP. One page, generated against the live CLI.

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.

```bash theme={null}
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.                                                                                                                                   |

```bash theme={null}
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%). |

```bash theme={null}
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.                                                                                                                                                                                  |

```bash theme={null}
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](https://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.    |

```bash theme={null}
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.                     |

```bash theme={null}
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.