██████╗██╗      ██████╗  ██████╗
██╔════╝██║     ██╔═══██╗██╔════╝
██║     ██║     ██║   ██║██║  ███╗
██║     ██║     ██║   ██║██║   ██║
╚██████╗███████╗╚██████╔╝╚██████╔╝
 ╚═════╝╚══════╝ ╚═════╝  ╚═════╝

Track and share your Claude Code usage.

Clog parses your local Claude Code sessions and gives you stats on sessions, duration, tokens, and projects. Optionally sync to a public GitHub repo to share your coding activity.

Requirements

• Node.js 18+
• GitHub CLI (gh) - for GitHub sync; required for profile + leaderboard

Usage

View local stats

npx @jaobrown/clog
# or
npx @jaobrown/clog stats

Shows a summary of your Claude Code usage:

• Total sessions, duration, and tokens
• Project count and current streak
• Top 5 projects by time spent
• Recent sessions

Initialize GitHub sync

npx @jaobrown/clog init

Creates a public GitHub repository to sync your stats. You'll be prompted for:

• GitHub username
• Repository name (default: clog)
• Local repo path (default: ~/.clog/repo)

Sync to GitHub

npx @jaobrown/clog sync

Parses your sessions and pushes updated stats to your GitHub repo. The repo includes:

• data/latest.json - Public profile payload (summary, activity, project/session metadata used by clog.sh)
• README.md - Formatted stats display

Redact sensitive projects

npx @jaobrown/clog redact [path]

# Examples: `npx @jaobrown/clog redact my-app` or `npx @jaobrown/clog redact /Users/you/code/my-app`

Marks a directory as redacted (defaults to the current directory). Redacted projects still count toward totals, but their project name and session titles are hidden everywhere clog syncs data:

• Project name: top secret
• Session title: **********

Tip: Redaction matches by full path, project name, or basename. If you used a path under ~/.claude/projects/, use the real project directory (for example /Users/you/code/my-app) or just the project name (npx @jaobrown redact my-app).

How it works

clog reads Claude Code session files from ~/.claude/projects/. Each session includes:

• Session title and timestamp
• Duration
• Token usage (input, output, cache)
• Git branch and model used
• Subagent activity

When syncing to GitHub, clog publishes only profile/leaderboard data:

• Summary totals and daily activity
• Project names and session titles/timestamps/durations
• Aggregated token usage, tool usage, and model breakdown

It does not publish local project paths, per-session git branches/model IDs, message counts, or conversation content.

Data storage

• Claude Code sessions: ~/.claude/projects/
• clog config: ~/.claude/clog.json
• Sync repo (default): ~/.clog/repo/

FAQ

Can I redact sensitive data?
Yes. Use npx @jaobrown/clog redact [path] to hide a project’s name and session titles in clog stats, the README, and latest.json. You can redact as many projects as you need.

License

MIT