Commands

claude-finops                 start the dashboard and open it in your browser
claude-finops --rebuild       re-read transcripts, then start
claude-finops --stop          stop it
claude-finops --where         where your data, settings and keys live
claude-finops --set-key       store a provider API key (hidden prompt, 0600)
claude-finops --keys          which provider keys are configured
claude-finops --version       installed version, and whether a newer one is out
claude-finops --install-statusline    model, context % and 5-hour limit under every prompt
claude-finops --uninstall-statusline  remove it again
claude-finops --install-guard         optional live warnings at your per-session token limit
claude-finops --uninstall-guard       remove them again
claude-finops --no-update-check   skip the daily version check
claude-finops --help          everything

These work from any directory, whether installed globally (npm i -g claude-finops) or run ad hoc (npx claude-finops).

From a source checkout

OS	Start	Stop
macOS / Linux	`./run.sh`	`./run.sh --stop`
Windows	`run.cmd` (or `py run.py`)	Ctrl-C

./run.sh accepts the same flags.

Rebuilding the warehouse

python3 -m finops.etl                      # default ~/.claude/projects
python3 -m finops.etl /path/to/transcripts # or a specific directory

The rebuild recreates ~/.claude-finops/data/finops.db from your transcripts. Sessions whose transcripts have since been deleted are carried over from the previous warehouse (turn that off with history.keep_deleted_transcripts: false).

Environment variables

Variable	Effect
`PORT`	Serve on another port (default 8787)
`CLAUDE_PROJECTS`	Read transcripts from a different directory
`CLAUDE_FINOPS_PYTHON`	Which Python the npm launcher should use
`CLAUDE_FINOPS_HOME`	Store the warehouse and settings somewhere other than `~/.claude-finops`
`CLAUDE_FINOPS_TZ`	Time zone for days and hours, e.g. `Asia/Kolkata` (default: this computer’s)
`CLAUDE_FINOPS_AUTOSYNC_MINUTES`	Re-read transcripts once the data is this many minutes old (default 60, `0` = never)
`CLAUDE_FINOPS_NO_UPDATE_CHECK=1`	Disable the daily version check
`NO_UPDATE_NOTIFIER=1`	Same, using the common convention