JSPM

amp-wrapped

1.0.5
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 6
  • Score
    100M100P100Q22243F
  • License MIT

Generate a personalized Spotify Wrapped-style summary of your Amp Code usage

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (amp-wrapped) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    amp-wrapped

    Your year in code, beautifully visualized.

    Credit: Built on top of opencode-wrapped by moddi3 (@moddi3io).

    Follow @ajanraj25 for updates!

    Generate a personalized "Spotify Wrapped"-style summary of your Amp Code usage.

    npm version License: MIT Bun GitHub

    Amp Wrapped Example

    Installation

    Quick Start

    Run directly without installing:

    npx amp-wrapped # or bunx, or yarn/pnpm dlx

    Global Install

    npm install -g amp-wrapped # or bun/yarn/pnpm

    Then run anywhere:

    amp-wrapped

    Usage Options

    Option Description
    --year, -y 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
    • Credits usage tracking
    • Shareable PNG image
    • Inline image display (Ghostty, Kitty, iTerm2, WezTerm, Konsole)
    • Auto-copy to clipboard

    Terminal Support

    The wrapped image displays natively in terminals that support inline images:

    Terminal Protocol Status
    Ghostty Kitty Graphics Full support
    Kitty Kitty Graphics Full support
    WezTerm Kitty + iTerm2 Full support
    iTerm2 iTerm2 Inline Full support
    Konsole Kitty Graphics Full support
    Other terminals — Image saved to file only

    Output

    The tool generates:

    1. Terminal Summary — Quick stats overview in your terminal
    2. PNG Image — A beautiful, shareable wrapped card saved to your home directory
    3. Clipboard — Automatically copies the image to your clipboard

    Data Source

    Amp Wrapped reads data from your local Amp installation:

    ~/.local/share/amp/threads/

    No data is sent anywhere. Everything is processed locally.

    Building

    Development

    # Run in development mode with hot reload
bun run dev

    Production Build

    # Build for all platforms
bun run build

    Releasing

    Releases are automated via semantic-release. Merging PRs with conventional commits to main triggers a release.

    Tech Stack

    Contributing

    Contributions are welcome! Please feel free to submit a Pull Request.

    License

    MIT License - see LICENSE for details.

    Built for the Amp Code community