AI Gains ⚡

Track the time you save using AI in your development workflow. AI Gains automatically logs Claude Code sessions and visualises your productivity gains in a browser dashboard.

How it works

1. Hooks record each Claude Code session — start time, author, end time
2. A skill reminds you to log achievements at natural stopping points; run /ai-gains whenever you want to capture what was done and estimate how long it would have taken without AI
3. A dashboard visualises sessions, time saved, and speedup across your project

Setup

In your project directory:

npx ai-gains init

This sets up .claude/settings.json hooks and the /ai-gains skill. If you already have a settings.json, the hooks are merged in safely — existing hooks are preserved and duplicates are never added.

Running the dashboard

npx ai-gains

Opens a browser dashboard at http://localhost:3847 showing sessions from the current project's .ai-gains folder.

To use a different port:

PORT=4000 npx ai-gains

Logging achievements

After completing a meaningful piece of work — a feature, a bug fix, a refactor — run:

/ai-gains

Claude will reflect on what was done, estimate how long it would have taken a human, and write the achievement to the session log. Run it as many times as you like within a session to capture checkpoints, or once at the end to log everything in one go. The hooks handle start and end time automatically — /ai-gains is purely for recording what was accomplished.

Dashboard features

• Stats — total sessions, achievements, time saved, average speedup
• Chart — AI time vs estimated human time per session
• Filters — filter by author and time period
• Session detail — per-session breakdown of achievements and files touched

What gets tracked

Each session file (.ai-gains/<session-id>.json) contains:

{
  "uuid": "...",
  "start_time": "2026-01-15T09:00:00Z",
  "end_time": "2026-01-15T09:45:00Z",
  "author": "[email protected]",
  "duration_minutes": 45,
  "achievements": [
    {
      "description": "Implemented user authentication with JWT",
      "estimated_human_time_minutes": 180
    }
  ],
  "ai_speedup": "4× faster — 3h of work done in 45 minutes"
}

Committing session logs

Add .ai-gains/ to your repository to share gains across your team. Each file is named <timestamp>_<session-id>.json so files sort chronologically and concurrent sessions never conflict.

Requirements

• Node.js 16+
• Claude Code