Complementer

Shows what Claude Code does not: how full your context is, how much of your 5-hour and weekly limits you have used, and a place to manage your sessions.

Independent project, not affiliated with Anthropic.

Features

• Usage meters. Context, 5-hour and weekly limits in the status bar and the Sessions panel, with reset countdowns. Yellow above 50%, red from 80%.
• Session manager. Chats grouped by project, each with its own context %. Search, open, read as a transcript, or delete (to the Trash, or permanently with ✕). Start a new session in one click.
• Insights. Over 7, 30 or 90 days: tokens, cache hit rate, active days, a 13-week heatmap, top projects, top skills, model mix and streak.
• Context breakdown. Under the Context meter (listed after the 5-hour and weekly meters): a full-width bar of what the used context is made of (fixed baseline, tool results, assistant text, your messages) with a colour-keyed legend and, under Details, the biggest tool outputs (shown by file name or command) and the skills used in that session. The split is an estimate.
• Account. Your email, plan and organization.

Getting started

1. Install Complementer from the Marketplace, or run ext install pritompurkayasta.complementer in the Quick Open box (Ctrl/Cmd+P). It requires the Claude Code extension.
2. Open the Complementer icon in the activity bar.
3. Run Complementer: Enable live meters to show the 5-hour and weekly limits.

Context % and the session list work without step 3.

Live meters

Plan limits come from Claude Code itself. The extension asks the Claude Code that is already installed for them every few minutes (no message is sent, so no plan usage), and this needs no setup. If that is not possible on your machine, press the ↻ icon next to Usage. Terminal sessions also report limits through Claude Code's status line. Enabling live meters adds a small passthrough in front of it. The extension asks first, shows the exact change, and keeps your own status line working. Claude Code runs the status line only in terminal sessions (claude in a terminal, or the claudeCode.useTerminal setting), not in the native chat panel, so the live meters fill in from those; the 5-hour and weekly limits are account-wide, so one terminal session keeps them current. The ↻ Refresh icon at the right of the Usage heading (also the command Complementer: Refresh limits) resumes the session shown under "Following" in a terminal, sends one short message ("hi"), waits for the limits to arrive, then exits and closes it. This updates the context meter too. It costs a few tokens and adds one short message to that session. If that chat changed in the last minute (it may be open in the chat panel), it asks before resuming it. If nothing arrives within 30 seconds (for example a trust prompt is waiting), the terminal stays open for you. Disable live meters, or uninstalling, restores your settings exactly. With two copies installed, removing one leaves the other's live meters alone.

Commands

Privacy

Everything stays on your machine. There are no network calls and no telemetry. The extension reads your Claude Code session logs, the status-line data, and your email, plan and organization from ~/.claude.json. It stores only daily token totals and daily skill counts, never chat content.

Requirements

VS Code 1.85 or newer and the Claude Code extension. Node.js is not needed on macOS and Linux. On Windows, live meters need node on your PATH; enabling them stops with a message if it is missing. Tested on macOS only; Linux and Windows are untested.

Contributing

Contributions are welcome. Open an issue first, and send a pull request once a maintainer confirms it. See CONTRIBUTING.md. Release notes are in CHANGELOG.md.

License

MIT. If the extension is useful to you, please star it on GitHub.