gemini-wrapped
v1.1.0
Generate a personalized wrapped-style summary of your Gemini CLI usage
0/weekUpdated 1 months agoUnpacked: 25.8 KB
Published by jackwotherspoon
npm install gemini-wrappedgemini-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
$3
Run directly without installing:
``bash`
npx gemini-wrapped
or with Bun:
`bash`
bunx gemini-wrapped
Usage Options
| Option | Description |
| --------------- | ------------------------------------ |
| --year | 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:
- opencode-wrapped
- cc-wrapped
---
Made with ❤️ for the Gemini CLI community