context-bar

Reviewed at commit 172abf0 New version, not yet reviewed

The context window as one stacked bar above the prompt, a color per category like /context, with token counts and the compaction point.

Made by
Hamza Zafar
What we checked

Draws your context window as a stacked colored bar above the prompt, with a legend of tokens per category and where auto-compaction runs. /context-bar shows or hides it, and the choice is remembered. It uses the local usage breakdown only, reads an optional band-order file, and makes no network calls.

Review details

Static review of the source at the pinned commit; not run. Whole plugin reviewed again (new version of a reviewed mod; the changes are the shared bands.ts, the band-order read and a compaction-point calculation). Registers session.start, turn.complete, session.compact, session.end and command.run (/context-bar) and ui.render (AbovePrompt). Uses $.session.usage({breakdown:'summary'}) for the local, estimated breakdown (no token-count calls), $.env.get for CLAUDE_AUTOCOMPACT_PCT_OVERRIDE, CLAUDE_CONFIG_DIR and HOME, $.store.get/set for isHidden, $.command.register, $.clock.after and $.ui.resolve. Once per session it reads <config dir>/claude-code-mods/bands.json via $.fs.exists and $.fs.read (an optional list of mod names for band order; parsed as JSON, only an array of strings accepted, empty on any error) and sorts its band among other band mods' columns. Failures are caught. No network, no processes, no writes beyond its own store key, no tool changes. npm dependencies: none.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of context-bar

Your context window as a stacked bar above the prompt, a color per category, with token counts and the compaction point. /context-bar shows or hides it.

Made this mod? Add a badge to your README

modsforClaude badge for context-bar

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/context-bar.svg)](https://modsforclaude.com/mods/context-bar/)

← All mods