Your year in Gemini CLI, beautifully visualized.
Generate a personalized "Wrapped"-style summary of your Gemini CLI usage.
Credit: Built on top of opencode-wrapped by moddi3 (@moddi3io) and cc-wrapped by @nummanali.
Run directly without installing:
npx gemini-wrappedor with Bun:
bunx gemini-wrapped| Option | Description |
|---|---|
--year <YYYY> |
Generate wrapped for a specific year |
--help, -h |
Show help message |
--version, -v |
Show version number |
- Sessions, messages, tokens, projects, and streaks
- GitHub-style activity heatmap
- Top models breakdown
- Detailed token usage (Input, Output, Cached)
- Shareable PNG image
- Inline image display (Ghostty, Kitty, iTerm2, WezTerm, Konsole)
- Auto-copy to clipboard
Gemini Wrapped reads data from your local Gemini CLI installation (~/.gemini/tmp). No data is sent anywhere. Everything is processed locally.
Special thanks to the following projects which provided the inspiration and starting point for this tool:
Made with ❤️ for the Gemini CLI community