gemini-wrapped
v1.1.0
Published
Generate a personalized wrapped-style summary of your Gemini CLI usage
Readme
gemini-wrapped
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.
Installation
Quick Start
Run directly without installing:
npx gemini-wrappedor with Bun:
bunx gemini-wrappedUsage Options
| Option | Description |
| --------------- | ------------------------------------ |
| --year <YYYY> | Generate wrapped for a specific year |
| --help, -h | Show help message |
| --version, -v | Show version number |
Features
- 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
Data Source
Gemini Wrapped reads data from your local Gemini CLI installation (~/.gemini/tmp). No data is sent anywhere. Everything is processed locally.
Acknowledgements
Special thanks to the following projects which provided the inspiration and starting point for this tool:
Made with ❤️ for the Gemini CLI community
