Skip to main content

Global Options

All commands support these flags:
FlagDescription
--jsonOutput in JSON format for scripting
--helpShow help for any command
--versionShow 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

FileLocationPurpose
~/.conto/config.jsonGlobalAPI keys, agent ID, server URL
.env.localProjectSDK key, chain config, wallet address
conto.config.jsonProjectAgent metadata (generated by init)
The CLI reads project-level .env.local first, then falls back to global ~/.conto/config.json.