jules-wrapped
v1.0.4
Published
Generate a personalized Spotify Wrapped-style summary of your Jules usage
Maintainers
Readme
jules-wrapped
Your year in code, beautifully visualized.
Generate a personalized "Spotify Wrapped"-style summary of your Jules usage.
Installation
Run directly using your preferred package manager:
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.
Options
| 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 |
Terminal Support
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.
Development
bun run dev # Development with hot reload
bun run build # Production buildLicense
MIT License - see LICENSE for details.
