Global Options
All commands support these flags:
| Flag | Description |
|---|
--json | Output in JSON format for scripting |
--help | Show help for any command |
--version | Show CLI version |
Agent & Status
conto status # Agent info, wallet balances, spending progress
conto balance # Wallet balance table
conto config # Show current configuration
conto config <key> <value> # Update a config value
Payments
conto pay <address> <amount> # Request and execute payment
conto pay <address> <amount> --dry-run # Policy check without executing
conto pay <address> <amount> --purpose "reason" # Add a purpose string
conto pay <address> <amount> --wallet <id> # Use a specific wallet
conto pay <address> <amount> --category "API" # Tag with spend category
--dry-run runs the full policy evaluation (all rules, all policies) and returns APPROVED, DENIED, or REQUIRES_APPROVAL without sending any transaction.
Transactions
conto transactions # List recent transactions (default: 10)
conto transactions --limit 50 # List more transactions
conto transactions <id> # View transaction details
Wallets
conto wallets # List all wallets with balances
conto fund # Show chain-aware funding instructions
Spending Limits
conto limits # Daily/weekly/monthly limits with progress bars
Alerts
conto alerts # List all alerts
conto alerts --unread # Unread alerts only
Policies
See Policy Management for full CRUD documentation.
conto policies # List agent policies ([agent] vs [org-wide])
conto policies all # List all org policies
conto policies create # Interactive policy builder
conto policies update <id> # Update name, priority, active status
conto policies delete <id> # Delete with confirmation
conto policies assign <id> # Assign policy to current agent
conto policies unassign <id> # Remove policy from agent
conto policies add-rule <id> # Add a rule to a policy
conto policies remove-rule <policyId> <ruleId> # Remove a rule
Authentication
conto login # Re-authenticate (opens browser)
conto login --base-url <url> # Authenticate against a specific server
conto logout # Clear stored credentials
MCP Server
conto mcp # Start the Conto MCP server for Claude
Init Wizard
create-conto-agent # Run the setup wizard (interactive)
conto init # Same as above
# Non-interactive with flags:
create-conto-agent --base-url https://conto.finance --name my-agent --type ANTHROPIC_CLAUDE --limit 500 --chain 4217
JSON Mode
Every command supports --json for machine-readable output:
conto status --json | jq '.agent.name'
conto pay --dry-run 0x... 10 --json | jq '.status'
conto policies --json | jq '.[].name'
Configuration Files
| File | Location | Purpose |
|---|
~/.conto/config.json | Global | API keys, agent ID, server URL |
.env.local | Project | SDK key, chain config, wallet address |
conto.config.json | Project | Agent metadata (generated by init) |
The CLI reads project-level .env.local first, then falls back to global ~/.conto/config.json.