vibe-clock

简体中文 | 日本語 | Español

WakaTime for AI coding agents. Track usage across Claude Code, Codex, and OpenCode — then show it off on your GitHub profile.

Quick Start

# macOS (Homebrew)
brew install dexhunter/tap/vibe-clock

# or via pip
pip install vibe-clock

vibe-clock init          # auto-detects agents, sets up config
vibe-clock summary       # see your stats in the terminal

Privacy & Security

Everything stays local until you explicitly run vibe-clock share. The default public profile covers the last seven complete UTC days and contains only:

• Session and active-day counts
• Known agent names
• Normalized model families such as OpenAI, Claude, and Gemini

The payload is built from a fixed allowlist in sanitizer.py. Exact dates, message counts, token counts, hourly patterns, and anonymous project aliases are separate opt-ins. Raw model IDs are always reduced to public families.

Never shared: paths, real project names, prompts, responses, code, git data, session IDs, host data, durations, or raw timestamps. Run vibe-clock push --dry-run to inspect the exact payload. Public Gist updates retain revision history; vibe-clock unshare deletes the Gist and disables future updates.

Configurable Charts

Generate only the charts you want with --type:

vibe-clock render --type card,donut           # just these two
vibe-clock render --type all                  # all 7 charts

GitHub Actions Setup

Add to your <username>/<username> profile repo to auto-update SVGs daily.

1. Preview and explicitly share

vibe-clock push --dry-run
vibe-clock share         # confirms before creating a public Gist
# Note the gist ID printed

Upgrading from an older release with an existing Gist? Run vibe-clock unshare first to delete the legacy revision history, then run vibe-clock share and update the repository secret with the new Gist ID.

Optional fields must be selected explicitly, for example:

vibe-clock share --daily-activity --token-counts

2. Add the secret

In your profile repo: Settings → Secrets → Actions → add:

• VIBE_CLOCK_GIST_ID — the gist ID from step 1

3. Create the workflow

.github/workflows/vibe-clock.yml:

name: Update Vibe Clock Stats

on:
  workflow_dispatch:

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: dexhunter/vibe-clock@v1.4.1
        with:
          gist_id: ${{ secrets.VIBE_CLOCK_GIST_ID }}

4. Add SVGs to your README

<img src="images/vibe-clock-card.svg" alt="Vibe Clock Stats" />
<img src="images/vibe-clock-donut.svg" alt="Model Usage" />

5. Run it

Go to Actions tab → "Update Vibe Clock Stats" → Run workflow

Action Inputs

How it works

You (local)                    GitHub
─────────                      ──────
vibe-clock share ──▶  Gist (allowlisted JSON)
                     │
                     └──▶  workflow_dispatch
                              │
                       fetch gist JSON
                       generate SVGs
                       commit to profile repo

Supported Agents

Commands

Configuration

Config file: ~/.config/vibe-clock/config.toml

Environment variable overrides:

• GITHUB_TOKEN — GitHub PAT with gist scope
• VIBE_CLOCK_GIST_ID — Gist ID for push/pull
• VIBE_CLOCK_DAYS — Number of days to aggregate

Public sharing defaults are stored under [privacy]: seven complete days, with daily activity, message counts, token counts, time patterns, and project aliases disabled unless explicitly selected with vibe-clock share.

License

MIT