Skip to content

Repository files navigation

AI Wrapped icon

AI Wrapped

Spotify Wrapped-style desktop dashboard for your AI coding agent activity.
ai-wrapped.com · npm

A visual summary across multiple agents.

Built on Electrobun — a TypeScript-first desktop framework using Bun + native webviews.

Built on top of agent-sessions session format discovery — reads JSONL/JSON session logs that AI coding agents write to disk.

Supported Agents

  • Claude Code~/.claude/projects/ JSONL sessions + subagent logs
  • OpenAI Codex — Codex CLI session files
  • Google Gemini CLI — Gemini session logs
  • OpenCode — OpenCode session data
  • Droid — Droid session files
  • GitHub Copilot — Copilot session logs
  • Amp — Amp thread usage ledgers
  • Codebuff — Codebuff agent chats
  • Goose — Goose session database
  • Hermes — Hermes state database
  • Kilo — Kilo message database
  • Kimi Code — Kimi wire session logs
  • OpenClaw — OpenClaw session logs
  • pi — pi-agent session logs
  • Qwen Code — Qwen chat logs

What It Shows

  • Total sessions, messages, tool calls, tokens, and estimated cost
  • Daily activity timeline with per-agent and per-model breakdown
  • Cost breakdown by model (Claude Opus, Sonnet, GPT-4o, Gemini Pro, etc.)
  • Agent usage distribution (pie chart)
  • Time spent — total hours, average session duration, longest session, current streak, active day coverage ring
  • Top repositories with sessions, tokens, cost, and duration
  • Coding hours — 24-hour activity breakdown by agent
  • Shareable dashboard links via ai-wrapped.com/share
  • System tray with today's stats at a glance

Quick start

npx ai-wrapped@latest
# or
bunx ai-wrapped@latest

Flags: --version, --rebuild, --uninstall

Stack

  • Runtime: Bun
  • Desktop: Electrobun (native webview, no Chromium bundling on macOS)
  • Frontend: React + Tailwind CSS + Recharts
  • Build: Vite (frontend) + Electrobun CLI (app bundle)
  • Storage: JSON files in ~/.ai-wrapped/

Getting Started

bun install

Development

bun run dev

Or with HMR for the frontend:

bun run dev:hmr

Production Build

bun run build:prod

How It Works

  1. On launch (and every 5 minutes by default), the app scans known session directories for each agent
  2. New or changed session files are parsed into a normalized format with token counts, tool calls, and cost estimates
  3. Aggregated daily stats are written to ~/.ai-wrapped/daily.json
  4. The frontend fetches summaries over RPC and renders the Wrapped-style dashboard

About

Get Wrapped-style desktop dashboard for your AI coding agent activity

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages