Web Dashboard

A browser dashboard served from your own machine.

Usage

codeburn web                     # opens http://127.0.0.1:4747
codeburn web -p 30days           # start on a different period
codeburn web --port 8080         # pick a port
codeburn web --no-open           # start the server, do not open a browser
codeburn web --provider claude   # scope to one provider

Flags

Flag	Description
`-p, --period <period>`	Initial period: today, week, 30days, month, all, lifetime (default `today`)
`--from <date>`	Start date (YYYY-MM-DD)
`--to <date>`	End date (YYYY-MM-DD)
`--provider <provider>`	Filter by provider (default `all`)
`--project <name>`	Show only matching projects (repeatable)
`--exclude <name>`	Exclude matching projects (repeatable)
`--port <number>`	Port to listen on, default `4747` (falls back to a free port if taken)
`--no-open`	Do not open the browser automatically

It Runs Locally

The server binds to 127.0.0.1 only, and rejects requests that are not addressed to localhost. Usage is parsed from the same local transcript files the CLI reads. Nothing is uploaded.

The UI

The dashboard is a React app (built with Vite from the dash/ directory) that ships prebuilt with the CLI package. It shows the same task, model, tool, and project breakdowns as the TUI, rendered as charts. If the bundle is missing, the CLI prints the build command instead of serving a page.

Paired Devices

The web dashboard can also discover and pair nearby devices, so combined multi-device totals are available without leaving the browser. See Device Sharing.

Press Ctrl+C in the terminal to stop the server.

Dashboard Reports