Commands Reference

conto doctor                    # Diagnose setup: auth, scopes, wallet, chain, balance, base URL
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

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

conto transactions              # List recent transactions (default: 10)
conto transactions --limit 50   # List more transactions
conto transactions <id>         # View transaction details

conto wallets                   # List all wallets with balances
conto fund                      # Show chain-aware funding instructions
conto fund --faucet             # Request testnet funds when the configured chain supports it

conto limits                    # Daily/weekly/monthly limits with progress bars

conto alerts                    # List all alerts
conto alerts --unread           # Unread alerts only

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

conto login                     # Re-authenticate (opens browser)
conto login --base-url <url>    # Authenticate against a specific server
conto logout                    # Clear stored credentials

conto mcp                       # Start the Conto MCP server for Claude

conto docs                      # Open the CLI quickstart docs
conto docs commands             # Open the commands reference
conto docs policies             # Open the policy docs
conto docs sdk                  # Open the SDK installation guide
conto docs api                  # Open the API reference page

create-conto-agent              # Run the setup wizard (interactive)
conto init                      # Same as above

# Non-interactive with flags:
CONTO_ORG_API_KEY=conto_xxx create-conto-agent --base-url https://conto.finance --name my-agent --type ANTHROPIC_CLAUDE --limit 500 --chain 42431 --json

# Mainnet requires an explicit chain and real-funds acknowledgement:
CONTO_ORG_API_KEY=conto_xxx create-conto-agent --chain 4217 --confirm-mainnet

# Skip the local CLI install (npx conto will not resolve without it):
create-conto-agent --no-install

conto status --json | jq '.agent.name'
conto pay --dry-run 0x... 10 --json | jq '.status'
conto policies --json | jq '.[].name'