gitwtfhub

wtf is context-health-bar?

ucsandman/context-health-bar — explained in plain English

Analysis updated 2026-08-04 · repo last pushed 2026-01-16

2JavaScriptAudience · vibe coderComplexity · 2/5QuietLicenseSetup · easy

TL;DR

A Chrome extension that shows a color-coded health gauge on your Claude chat page, warning when a conversation is getting too long and helping you start a fresh chat with a summary of key context.

Mindmap

mindmap
  root((repo))
    What it does
      Colored health orb
      Token and message stats
      Refresh context button
    How it works
      Reads visible page content
      Estimates conversation health
      No internal API access
    Key features
      Pinned core instructions
      Copy summary to clipboard
      Three detail levels
    Use cases
      Long debugging sessions
      Drafting long documents
      Complex research chats
    Audience
      Claude power users
      Developers and writers
      Non-technical vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor long Claude chats and get a visual warning before the assistant starts losing track of earlier instructions.

REASON 2

Start a fresh Claude chat with an auto-generated summary so you don't lose key context from a long conversation.

REASON 3

Pin important messages as core instructions so the health gauge weighs what matters most to you.

REASON 4

Copy a formatted conversation summary to paste into another tool or share with a teammate.

What's in the stack?

JavaScriptChrome Extension

How it stacks up

ucsandman/context-health-bar3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-01-162021-09-252021-02-06
MaintenanceQuietDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencevibe coderresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Install as an unpacked Chrome extension in developer mode, no external services or API keys required.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Context Health Bar is a Chrome extension that helps you keep your Claude conversations productive. When you have a long chat going, Claude can start to lose track of earlier instructions or repeat itself. This tool shows a small colored orb at the top of the page that acts like a fuel gauge, telling you when the conversation is getting too long and it's time to start fresh. The orb changes from green to yellow to red as your conversation grows. It calculates this "health score" by looking at a few things: how far back your last important instruction was, how long the overall conversation is, and whether the assistant has been doing most of the talking. It doesn't peek at Claude's internal workings, it just reads what's visible on the page and makes an educated guess about how well things are going. You can hover over the orb to see character counts, token estimates, and message stats. The real payoff is the "Refresh Context" button. When your health is dropping, you click it and the extension opens a brand new Claude chat with a formatted summary of your previous conversation. This summary includes your original request, key highlights, the current focus, and recent exchanges. You can pick from three detail levels, compact, standard, or rich, depending on how much context you want to carry over. If you'd rather paste it somewhere yourself, there's a copy button too. This is for anyone who uses Claude for extended working sessions, debugging code, drafting long documents, or complex research where a single conversation might stretch across dozens of messages. Instead of hitting a wall where Claude seems confused or forgetful, you get an early warning and a clean handoff. You can also pin specific messages as "core instructions" so the health calculation knows what matters most to you. The extension is free and open source under an MIT license.

Yoink these prompts

Prompt 1
I'm building a Chrome extension that adds a health indicator to a chat website. How do I read the visible conversation messages from the page DOM and estimate a token count without calling an external API?
Prompt 2
Help me design a scoring algorithm that takes conversation length, distance since the last user instruction, and assistant-vs-user message ratio, and returns a health score from 0 to 100 that maps to green, yellow, and red.
Prompt 3
Write a function that takes an array of chat messages and produces a structured summary with fields for original request, key highlights, current focus, and recent exchanges, with compact, standard, and rich detail levels.
Prompt 4
How do I open a new tab to a specific URL from a Chrome extension sidebar button and pre-fill the chat input with formatted text?

Frequently asked questions

wtf is context-health-bar?

A Chrome extension that shows a color-coded health gauge on your Claude chat page, warning when a conversation is getting too long and helping you start a fresh chat with a summary of key context.

What language is context-health-bar written in?

Mainly JavaScript. The stack also includes JavaScript, Chrome Extension.

Is context-health-bar actively maintained?

Quiet — no commits in 6-12 months (last push 2026-01-16).

What license does context-health-bar use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is context-health-bar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is context-health-bar for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.