claude-context-meter 1.0.0 → 1.0.2

package/README.md

@@ -3,23 +3,30 @@
 A Claude Code plugin that adds a persistent context window usage meter to the status line. After every API response you'll see something like:
 
 ```
-Context: 24k (18%)
+Context: 24k (18%) · [GitHub/my-project/main]
 ```
 
 Color-coded by pressure level:
 
-| Color  | Token range       | Example output                                          |
-|--------|-------------------|---------------------------------------------------------|
-| Green  | < 70,000          | `Context: 24k (18%)`                                    |
-| Yellow | 70,000 – 100,000  | `Context: 85k (43%)`                                    |
-| Red    | > 100,000         | `Context: 112k (56%) · Consider /compact or /clear`     |
+| Zone   | Token range      | Context numbers | VCS segment         |
+|--------|------------------|-----------------|---------------------|
+| Green  | < 70,000         | Green           | Gray (clean) / Cyan (dirty) |
+| Yellow | 70,000–100,000   | Yellow          | Gray (clean) / Cyan (dirty) |
+| Red    | > 100,000        | Red             | Gray (clean) / Cyan (dirty) |
 
-The status line updates automatically — no polling or background process required.
+In the red zone a suggestion is appended:
 
-## Prerequisites
+```
+Context: 112k (56%) · Consider /compact or /clear · [GitHub/my-project/main]
+```
 
-- **Claude Code** (any version that supports the `statusLine` setting)
-- **Node.js** — already installed as part of Claude Code; no additional installation required
+**VCS segment** — if you're inside a git repository, the current platform, repo, and branch are shown at the end of the line. The segment turns cyan with a `*` when there are uncommitted changes:
+
+```
+Context: 24k (18%) · [GitHub/my-project/main*]
+```
+
+The status line updates automatically — no polling or background process required.
 
 ## Installation
 
@@ -27,35 +34,36 @@ The status line updates automatically — no polling or background process requi
 npx claude-context-meter install
 ```
 
-This copies the meter script to `~/.claude/plugins/context-meter/` and adds the required `statusLine` entry to `~/.claude/settings.json` automatically. If a `statusLine` entry already exists it is backed up, replaced, and the backup is removed after a successful write.
+This copies the plugin to `~/.claude/plugins/context-meter/` and updates `~/.claude/settings.json` automatically. Open a new Claude Code session to activate it.
 
-Open a new Claude Code session to activate the meter.
-
-## Uninstalling
+## Uninstallation
 
 ```sh
 npx claude-context-meter uninstall
 ```
 
-Removes the plugin directory and the `statusLine` entry from `~/.claude/settings.json`.
+This removes the plugin files and cleans up the `statusLine` entry from `~/.claude/settings.json`. Open a new Claude Code session to complete the removal.
+
+## Prerequisites
+
+- **Claude Code** (any version that supports the `statusLine` setting)
+- **Node.js** ≥ 18 — already installed as part of Claude Code; no additional installation required
 
 ## Verifying the installation
 
-After opening a new Claude Code session you should see a status line at the bottom of the terminal that reads:
+After opening a new Claude Code session you should see a status line that reads:
 
 ```
-Context: 0 (0%)
+Context: 0 (0%) · [GitHub/my-project/main]
 ```
 
-Send any message to Claude. After the API response the token count and percentage will update to reflect the current session context. If the status line does not appear, check that:
+Send any message to Claude. After the API response the token count and percentage will update. If the status line does not appear, check that:
 
-- `~/.claude/settings.json` contains the correct `statusLine` entry (run `npx claude-context-meter install` to set it)
 - You opened a **new** Claude Code session after running the installer
+- `~/.claude/settings.json` contains a `statusLine` entry pointing to the plugin
 
 ## Running tests
 
 ```sh
 node --test tests/test_context_meter.js
 ```
-
-All 26 tests pass with no external dependencies — Node.js standard library only.

package/context_meter.js

@@ -1,17 +1,26 @@
 #!/usr/bin/env node
 'use strict';
 
+const { execSync } = require('child_process');
+
 const GREEN = '\x1b[32m';
 const YELLOW = '\x1b[33m';
 const RED = '\x1b[31m';
+const GRAY = '\x1b[2m';
+const CYAN = '\x1b[36m';
 const RESET = '\x1b[0m';
 
 const GREEN_THRESHOLD = 70_000;
 const YELLOW_THRESHOLD = 100_000;
-const RED_ZONE_MSG = ' · Consider /compact or /clear';
 
 const ANSI = { green: GREEN, yellow: YELLOW, red: RED };
 
+const KNOWN_PLATFORMS = {
+  'github.com': 'GitHub',
+  'bitbucket.org': 'Bitbucket',
+  'gitlab.com': 'GitLab',
+};
+
 function formatTokens(count) {
   if (count >= 1_000_000) return `${Math.round(count / 1_000_000)}M`;
   if (count >= 1_000) return `${Math.round(count / 1_000)}k`;
@@ -36,13 +45,103 @@ function parseInput(data) {
   }
 }
 
-function render(tokens, pct) {
+function parseRemoteUrl(url) {
+  let host = null;
+  let repo = null;
+
+  const sshMatch = url.match(/^git@([^:]+):(.+?)(?:\.git)?$/);
+  if (sshMatch) {
+    host = sshMatch[1];
+    repo = sshMatch[2].split('/').pop() || null;
+  } else {
+    try {
+      const u = new URL(url);
+      host = u.hostname || null;
+      const segments = u.pathname.replace(/^\//, '').replace(/\.git$/, '').split('/');
+      repo = segments.pop() || null;
+    } catch {
+      // unparseable remote URL
+    }
+  }
+
+  const platform = host ? (KNOWN_PLATFORMS[host] || host) : null;
+  return { platform, repo };
+}
+
+function detectVcs(cwd = process.cwd(), exec = execSync) {
+  const run = cmd => exec(cmd, { cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+
+  let branch;
+  try {
+    branch = run('git branch --show-current');
+  } catch {
+    return { type: 'none' };
+  }
+
+  let platform = null;
+  let repo = null;
+  try {
+    ({ platform, repo } = parseRemoteUrl(run('git remote get-url origin')));
+  } catch {
+    // no remote configured
+  }
+
+  let dirty = false;
+  try {
+    dirty = run('git status --porcelain').length > 0;
+  } catch {
+    // default to clean if git status fails
+  }
+
+  if (!branch) {
+    let hash = 'HEAD';
+    try { hash = run('git rev-parse --short HEAD'); } catch { /* use fallback */ }
+    return { type: 'detached', platform, repo, hash, dirty };
+  }
+
+  return { type: 'branch', platform, repo, branch, dirty };
+}
+
+function formatVcs(vcsState) {
+  if (vcsState.type === 'none') {
+    return `${GRAY} · [No version control]${RESET}`;
+  }
+
+  const { dirty } = vcsState;
+  const color = dirty ? CYAN : GRAY;
+  const star = dirty ? '*' : '';
+
+  if (vcsState.type === 'detached') {
+    const bracketParts = [vcsState.platform, vcsState.repo].filter(Boolean);
+    const bracket = bracketParts.length ? `[${bracketParts.join('/')}] ` : '';
+    const content = `${bracket}(HEAD detached at ${vcsState.hash})${star}`;
+    return dirty
+      ? `${GRAY} · ${RESET}${color}${content}${RESET}`
+      : `${GRAY} · ${content}${RESET}`;
+  }
+
+  const parts = [vcsState.platform, vcsState.repo, vcsState.branch].filter(Boolean);
+  const content = `[${parts.join('/')}${star}]`;
+  return dirty
+    ? `${GRAY} · ${RESET}${color}${content}${RESET}`
+    : `${GRAY} · ${content}${RESET}`;
+}
+
+function render(tokens, pct, vcsState = { type: 'none' }) {
   const formatted = formatTokens(tokens);
   const pctInt = Math.round(pct);
   const category = classify(tokens);
-  let line = `Context: ${formatted} (${pctInt}%)`;
-  if (category === 'red') line += RED_ZONE_MSG;
-  return `${ANSI[category]}${line}${RESET}`;
+  const zoneColor = ANSI[category];
+
+  let line = `${GRAY}Context: ${RESET}${zoneColor}${formatted} (${pctInt}%)${RESET}`;
+
+  if (category === 'red') {
+    line += `${GRAY} · Consider /compact or /clear${RESET}`;
+  }
+
+  line += formatVcs(vcsState);
+
+  return line;
 }
 
 if (require.main === module) {
@@ -51,8 +150,8 @@ if (require.main === module) {
   process.stdin.on('data', chunk => { data += chunk; });
   process.stdin.on('end', () => {
     const [tokens, pct] = parseInput(data);
-    console.log(render(tokens, pct));
+    console.log(render(tokens, pct, detectVcs()));
   });
 }
 
-module.exports = { formatTokens, classify, parseInput, render };
+module.exports = { formatTokens, classify, parseInput, detectVcs, formatVcs, render };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-context-meter",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Persistent context window usage meter for the Claude Code status line",
   "bin": {
     "claude-context-meter": "cli.js"