Quickstart

Get vibestats tracking your Claude Code and Codex sessions in under 5 minutes.

Install

Run this command in your terminal:

curl -sSf https://vibestats.dev/install.sh | bash

What the installer does

1. Creates a private vibestats-data repository in your GitHub account to store your stats.
2. Writes a GitHub Actions workflow to vibestats-data/.github/workflows/aggregate.yml that runs daily to aggregate your data.
3. Authenticates with GitHub via gh auth login and stores your OAuth token at ~/.config/vibestats/config.toml.
4. Configures Claude Code and Codex Stop and SessionStart hooks when those tools are installed.
5. Adds <!-- vibestats-start --> / <!-- vibestats-end --> markers to your profile README so your heatmap is embedded automatically.
6. Triggers an initial backfill to push your full supported local history to vibestats-data.

Next steps

After installation, vibestats runs automatically in the background. You can:

• Run vibestats status to check sync health and auth status.
• Visit https://vibestats.dev/[your-github-username] to see your dashboard.
• Read the CLI reference for all available commands.