Hep.gg Documentation

Time tracking

WakaTime-style stats for your Claude Code sessions: time per project, daily charts, hour-of-day patterns, and a per-machine split.

Read via MCP

See where your Claude Code time goes. Hep.gg tracks the time you spend working in Claude Code, per project, and turns it into clean stats: totals for today and this week, a per-project breakdown, a daily chart, the hours of day you work, and a per-machine split.

How it works

While a Claude Code session is active, the Hep.gg status line reports short activity heartbeats. Time only accrues while the session is actually doing work: if you step away for more than 10 minutes, the clock stops until you come back. A terminal left open overnight adds nothing, so the numbers stay honest.

Every session counts. If you work on two machines at once, or run several sessions side by side, each one accrues its own time and the totals add up. The per-machine split on the Time page shows where the hours happened.

Only aggregate numbers are stored: hourly totals per project. Prompts, transcripts, file paths, and code never leave your machine as part of time tracking.

Projects

A project is the folder you run Claude Code in (just the folder name, not the path). Two tools on the Time page keep the list tidy, and both ask you to confirm before changing anything:

  • Rename: the pencil icon next to a project renames it. History and all future time move to the new name. If the new name matches an existing project, the two combine (the dialog tells you before you confirm).
  • Merge projects: if the same repo lives under different folder names on different machines, select both rows and merge them. You pick which name survives; history combines and future time flows to the surviving name.

In your status line

Add the ccas Time Today widget (ccas statusline customize) to see a live "2h 14m" style counter in your status line - your total across all machines, updating as you work.

API access

The summary is available to connected agents through the platform MCP tool hepgg_ai_time_summary (today, week, and month totals, per-day series, per-project and per-machine breakdowns, and an hour-of-day histogram).