CLI Reference

BudgetAI command groups and common workflows.

Run budgetai --help or budgetai <group> --help for full details. The most common groups are listed below.

Core

budgetai onboard            # first-run setup wizard
budgetai chat               # interactive terminal chat
budgetai agent -m "..."     # single-turn run; good for scripts
budgetai doctor             # health checks and fixes

Gateway

budgetai gateway run
budgetai gateway start --json
budgetai gateway restart
budgetai gateway stop

Cost & contracts

budgetai cost                       # recent spend
budgetai cost receipt <id> --pdf    # export a receipt
budgetai agent -m "..." --max-usd 0.25 --done-when "pytest -q"

Sessions & agents

budgetai sessions list
budgetai sessions resume <id>
budgetai agents create researcher --workspace ./research

Channels, providers, models

budgetai channels status slack --json
budgetai providers list
budgetai models list --json

Memory, skills, cron, migrate

budgetai memory search "deploy steps"
budgetai skills list
budgetai cron add "0 8 * * *" -m "Morning summary"
budgetai migrate --source openclaw --apply
PreviousConfigurationNext Web UI