claude-code-time-tracker

Optional wizard to put the Claude Code Time Tracker online as a private, magic-link-gated dashboard on Vercel, fed by your real data. Walks through deploying the app (Vercel CLI or dashboard), turning on passwordless email login (Resend + an email allowlist), wiring private Vercel Blob storage, and scheduling the hourly push that sends your local report up. Run when the user types /time-tracker:deploy-vercel, or says "host the time tracker", "deploy the dashboard to Vercel", "put my time tracker online", "share my dashboard with a login". Local use needs none of this - it's purely for a hosted copy.

Start the Claude Code Time Tracker dashboard locally and open it in the browser. Boots the Next.js dev server in the background against your ~/.claude logs, waits for it to be ready, prints the URL (http://localhost:3000), and opens it. Run when the user types /time-tracker:launch, or says "open the time tracker", "launch the dashboard", "show me my Claude Code hours", "start the time tracker". If it isn't installed yet, run /time-tracker:setup first.

Rate how well you prompted Claude in each session (optional, AI-graded). Runs the local prompt-health scorer over your ~/.claude transcripts and writes a 🟢/🟡/🔴 rating, a session type, and a one-line coaching note per session - shown in the dashboard. Needs your own Anthropic API key; runs entirely on your machine, and only the ratings (never your prompts) are ever stored or, if you host it, pushed. Run when the user types /time-tracker:score, or says "rate my prompts", "score my sessions", "how well did I prompt".

One-time local install for the Claude Code Time Tracker dashboard. Copies the app out of the plugin into a stable working directory (~/.claude-time-tracker), installs its dependencies with npm, and verifies it's ready - no API keys, no account, nothing leaves the machine. Run when the user types /time-tracker:setup, or says "install the time tracker", "set up claude code time tracker", "get the time tracker running", "install the dashboard". Re-running is safe and also acts as an update.

Export a static, shareable snapshot of your Claude Code Time Tracker data - a self-contained report file built from your ~/.claude logs, with no server required. Useful for sharing your hours or archiving a point-in-time view without hosting anything. Run when the user types /time-tracker:snapshot, or says "export my time tracker", "snapshot my hours", "save a report of my Claude Code time".

Stop the locally running Claude Code Time Tracker dashboard. Shuts down the background Next.js dev server that /time-tracker:launch started and cleans up its PID file. Run when the user types /time-tracker:stop, or says "stop the time tracker", "shut down the dashboard", "kill the time tracker server", "close the dashboard".