Skip to content

About

Claude Pulse is a real-time metrics and export dashboard for your Claude conversations on claude.ai, giving you live insight into tokens, cache and usage limits, plus one-click chat history export to plain text or Markdown.

Resources

Stars

47 stars

Watchers

2 watching

Forks

Repository files navigation

Claude Pulse Logo

Claude Pulse

The real-time metrics dashboard for your Claude conversations

Chrome Firefox Privacy 4k+


✨ Why Claude Pulse?

  • Token Counter — Know your context window at all times. Live approximate counting using the o200k_base tokenizer.
  • Cache Timer — Never miss the 5-minute cache window. A live countdown shows exactly when your next message will be cheaper.
  • Usage Meters — Compact 5-hour and 7-day rings seamlessly integrated inside the composer card, showing percent used and time remaining.
  • Chat History Export — Export your entire conversation as plain text or formatted Markdown with a single click.
  • 100% Private & Local — No external servers, no tracking. All data is processed locally in your browser.
  • Native UI Integration — Discreetly blends into Claude's interface for a premium, built-in feel.
  • Open Source — MIT license, designed for the community.

Screenshots

Usage meters inside the Claude composer

📥 Installation

Chrome Web Store

Claude Pulse on the Chrome Web Store

Chrome / Brave / Edge

  1. Download or clone this repository
  2. Open chrome://extensions
  3. Enable Developer mode (top right)
  4. Click Load unpacked and select the claude-pulse folder

Firefox

  1. Download or clone this repository
  2. Open about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on
  4. Select the manifest.json file inside the claude-pulse folder

🚀 How it Works

Claude Pulse provides a transparent look into the "invisible" metrics of your Claude interactions. It works by intercepting the same API responses Claude's UI already fetches—usage stats, conversation trees, and streaming completions.

  • Security First: The extension requires no special permissions and runs entirely within the claude.ai sandbox.
  • Tiktoken Integration: Tokenization is powered by a local implementation of the o200k_base encoding, ensuring counts are as accurate as possible.
  • Real-time Synchronization: Usage data is synced directly from Claude's /usage endpoint (and completion streams on Free accounts) when you refresh the UI or send a message.

🖥️ UI Overview

Usage meters sit seamlessly inside the composer. Token count, cache timer, and export stay in the chat header.


📁 Project Structure

claude-pulse/
├── manifest.json         # Extension configuration & permissions
├── icons/                # Extension branding (PNGs)
├── src/
│   ├── styles.css        # Premium UI styling & animations
│   ├── content/
│   │   ├── main.js       # Content script entry logic
│   │   ├── ui.js         # Component architecture (bars, tooltips)
│   │   ├── tokens.js     # Tiktoken-compatible counting logic
│   │   ├── constants.js  # DOM selectors & runtime constants
│   │   └── bridge-client.js # Message bridge for intercepted data
│   ├── injected/
│   │   └── bridge.js      # XHR/Fetch interceptor for raw API data
│   ├── popup/
│   │   ├── popup.html    # Toolbar icon popup UI template
│   │   ├── popup.css     # Redesigned minimalist popup styles
│   │   └── popup.js      # Data sync, theme, & refresh relay logic
│   ├── shared/
│   │   └── format.js     # Shared timing and percent format helpers
│   └── vendor/
│       └── o200k_base.js  # Optimized tokenizer encoding
└── claude_pulse_logo.svg # Source vector asset

⚖️ Accuracy & Privacy

Data Accuracy

Token counts are approximate. Because Claude's internal system prompt and tokenizer specifics are not publicly exposed, counts exclude system overhead and may differ slightly from the official server count. The metric is intended as a high-fidelity guide, not an exact meter.

Your Privacy

Claude Pulse is built on a "zero-trust" architecture regarding your data.

  • No Analytics: We do not track usage or extension interactions.
  • No Cloud: No text or metadata ever leaves your machine.
  • Local Only: All tokenization happens on-device using JavaScript.

🤝 Credits

Inspired by and building upon Claude Counter. This project is a modern reimplementation with a focus on premium UI and expanded metric tracking. Tokenization powered by gpt-tokenizer (o200k_base encoding).


📄 License

MIT License — Feel free to contribute or fork for your own use.


Made with ❤️ for the Claude community

About

Claude Pulse is a real-time metrics and export dashboard for your Claude conversations on claude.ai, giving you live insight into tokens, cache and usage limits, plus one-click chat history export to plain text or Markdown.

Resources

Stars

47 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages