Command reference
The 8 StackTracker CLI commands, their flags, and a usage example for each.
scan and usage work offline. The rest talk to your workspace over the MCP endpoint documented at /docs/mcp.
The global flag --project <slug> selects the project on commands that need one.
| Command | What it does | Flags |
|---|---|---|
projects | List your projects. | none |
costs <project> | Spend by cost category. | positional <project> or --project <slug> |
renewals [days] | Upcoming charges, default 30 days. | positional [days], --project |
cashflow [project] | Next 30 days of cash out. | positional [project] or --project |
scan | Detect SaaS tools installed on this machine. | --project <slug> |
usage | Claude Max utilization from your local ~/.claude logs. | --plan <amount>, --days <n> |
log <amount> <vendor> [category] | Log an expense. | positionals, --project |
time <hours> <area> | Log hours worked. | positionals, --project |
projects
List your projects. No flags. Calls list_projects.
stacktracker projectscosts
Spend by cost category for one project. Takes a positional <project> or --project <slug>. Calls get_cost_breakdown.
stacktracker costs my-apprenewals
Upcoming charges. Default window is 30 days. Takes a positional [days] and --project. Calls upcoming_renewals.
stacktracker renewals 60 --project my-appcashflow
Next 30 days of cash out. Takes a positional [project] or --project. Calls upcoming_cashflow.
stacktracker cashflow my-appscan
Detect SaaS tools installed on this machine. It runs locally and reads which tools exist across ~37 signals. It never reads secret values. With --project <slug> it uploads the detected tools as tracked candidates. Without it, nothing is uploaded. Calls scan_import only when --project is given.
stacktracker scan --project my-appusage
Claude Max utilization from your local ~/.claude logs. Shows API-equivalent dollar cost versus your plan. Fully local, no network. Flags: --plan <amount> (default 200) and --days <n> (default 30).
stacktracker usage --plan 200 --days 30log
Log an expense. Takes positional <amount>, <vendor>, and optional [category], plus --project. Calls log_expense.
stacktracker log 49 vercel hosting --project my-apptime
Log hours worked. Takes positional <hours> and <area>, plus --project. Calls log_time. Areas: backend, frontend, design, marketing, content, sales, support, ops, research, other.
stacktracker time 3 backend --project my-app