The CLI application (packages/cli) provides a powerful terminal-based dashboard for human operators to monitor their agent wallets in real time.
Built with Ink (React for the terminal), it bridges the gap between headless agent operations and the physical owner of the funds.
Starting the CLI
# Build and launch
pnpm cli
# Or via Make
make cli
# Or via Docker
docker compose up cli
Features
Live Dashboard
Auto-refreshing interface displaying:
- Current agent tasks and recently invoked MCP tools
- Financial velocity (SOL/USDC spent vs earned)
- Active wallet count and total balance
Wallet Management
- Create new wallets with automatic Master Funder seeding
- View detailed balance breakdowns (SOL + all SPL tokens)
- Close wallets with SOL sweep to
OWNER_ADDRESS
Wallet closure is intentionally restricted to the CLI — it is not exposed as an MCP tool. This ensures AI agents cannot destroy their own wallets.
Live Audit Logs
Streaming tabular view of the audit trail, color-coded:
- 🟢 Green — successful transfers
- 🔴 Red — policy engine rejections
- 🔵 Blue — incoming x402 payments
- ⚪ Gray — informational events (wallet creation, balance checks)
Policy Configuration
Interactive adjustment of spending policy parameters:
- Modify 24-hour spending limits
- Add or remove addresses from the whitelist
- Toggle the
HUMAN_ONLY threshold for high-value transfers
- Changes take effect immediately
Docker
The CLI runs inside Docker with full TTY support:
The wallet-data volume persists keystores, audit logs, and policy state across container restarts.