$ join clog

// get set up in a few simple steps and start tracking your claude code journey

// prerequisites

-GitHub account
-gh CLI installed and authenticated
-Node.js 18+

// setup

1Initialize clog

Run the init command to set up your clog repository and configure local tracking.

npx @jaobrown/clog init
2Sync your data

Push your Claude Code stats to GitHub. Run this whenever you want to update your profile.

npx @jaobrown/clog sync
3Wait for profile

Your profile will appear on the leaderboard within an hour after syncing. We sync from GitHub every hour.

// faq

Where does the data come from?

clog reads your local Claude Code session data from ~/.claude/projects/. This data includes session timestamps, durations, and project info - no conversation content is ever accessed.

Is my data private?

Your clog repo is public on GitHub so others can see your stats. However, no conversation content or code is ever included - only metadata like session counts and durations.

How are streaks calculated?

A streak is consecutive days with at least one Claude Code session. Your current streak resets if you miss a day. The streak continues if your last session was yesterday or today.

How often should I sync?

Whenever you want! Run 'clog sync' after coding sessions to update your stats. Some people sync daily, others weekly.

_ready to join