Generate a personalized Spotify Wrapped-style summary of your Jules usage
npm install jules-wrappedYour year in code, beautifully visualized.
Generate a personalized "Spotify Wrapped"-style summary of your Jules usage.
Credit: Built on top of
opencode-wrapped
by moddi3 (@moddi3io).



---
Run directly using your preferred package manager:
``bash`
npx jules-wrapped # or bunx, pnpx, yarn dlx
> [!IMPORTANT]
> Privacy: Your Jules API key is only used to fetch data from the official Jules API and is never shared elsewhere.
> Performance: The Jules API has strict rate limits; generating your summary may take several minutes.
| Option | Description |
| --------------- | ------------------------------------ |
| --year, -y | Generate wrapped for a specific year |--api-key
| | Jules API key (prompted if omitted) |--sample
| | Use bundled sample data |--hide-top-repos
| | Hide Top Worked Repos in the image |--no-clipboard
| | Skip copying the image to clipboard |--no-save
| | Skip saving the image to disk |--no-share
| | Skip share prompt |
Images display natively in Ghostty, Kitty, WezTerm, iTerm2, and Konsole. In other terminals, the wrapped card is saved as a PNG to your home directory.
`bash``
bun run dev # Development with hot reload
bun run build # Production build
MIT License - see LICENSE for details.