Xona DocsCLI commands
Every xPay CLI command, its purpose, and its flags.
Every command is a thin shell over the SDK.
| Command | Description |
|---|---|
xpay init [name] | Create a profile — Solana + EVM from one seed. Flags: --import, --no-encrypt, --workspace. |
xpay accounts | list · show · use — manage and switch profiles. |
xpay balance | USDC balance per network for the active profile. |
xpay discover [query] | Search 21k+ x402 services. Flags: --network, --limit, --json. |
xpay pay <url> | Pay an x402 endpoint (catalog or live 402). Flags: --max-usd, --body, -y. |
xpay transfer <amt> USDC <to> | Direct USDC transfer, subject to the guardrail. Flags: --network, -y. |
xpay report | Comprehensive USDC report (daily / weekly / monthly) — totals, net flow, timeline, top counterparties. Flags: --period, --network, --json. |
xpay guardrail | show · set · clear — manage spending caps and allowed hosts. |
xpay biometric | status · enable · disable — Touch ID unlock for the wallet passphrase (macOS). |
xpay mcp | Start the MCP server on stdio. |
See Guardrails, Biometric unlock, and Activity reports for details on those commands.