Skip to content

CLI Reference

Allowealth exposes a single CLI entrypoint: aw.

Help and discovery

Terminal window
bun run aw --help
bun run aw workspace --help
bun run aw db --help

Target selection

Many commands accept --target (alias: -t):

  • sqlite (default local)
  • d1 (remote Cloudflare D1)
  • d1-local (local D1 emulation)
  • postgres (PostgreSQL)

Examples:

Terminal window
bun run aw db migrate --target sqlite
bun run aw db migrate --target d1
bun run aw db migrate -t d1-local
bun run aw workspace create --target postgres --name "Ops" --email admin@example.com

Common command groups

  • workspace: create, list, delete
  • db: migrate, generate, push, seed, reset, empty
  • recurring: recurring templates and occurrence operations
  • admin: super-admin + API key + credential operations
  • mcp: start MCP server
  • deploy: cloudflare/vercel/netlify deployment helpers

Global options expectations

  • Keep --target / -t available on leaf subcommands to select sqlite, d1, d1-local, or postgres.
  • Support --json on leaf subcommands for script/agent-friendly output.
  • Require --yes (or interactive confirmation) for destructive CRUD/alias operations like delete / rm.
  • Some destructive commands use command-specific confirmations instead (for example workspace delete --force or typed confirmation in aw db drop).

Resource commands

Terminal window
bun run aw transactions create|get|list|update|delete
bun run aw accounts create|get|list|update|delete
bun run aw budgets create|get|list|update|delete

Alias commands

Terminal window
bun run aw tx add|show|ls|edit|rm
bun run aw acc add|show|ls|edit|rm
bun run aw bdg set|show|ls|edit|rm