claude-blip 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 davebream
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# claude-blip
+
+A single-file statusline for Claude Code.
+
+Zero dependencies. Just a blip.
+
+```
+Fixing auth bug │ myapp │ main │ opus │ ━━━━━━──── 120K
+```
+
+## What you get
+
+```
+task │ project │ branch │ model │ context
+```
+
+- **Task** — what Claude is doing right now (bold, from todo list)
+- **Project** — directory name
+- **Branch** — current git branch
+- **Model** — opus, sonnet, haiku
+- **Context** — usage bar that goes from dim → yellow → red as you fill up
+
+Segments drop off the left when your terminal is narrow. Context bar always stays.
+
+## Install
+
+```sh
+npx claude-blip
+```
+
+That's it. Restart Claude Code.
+
+### Scopes
+
+```sh
+npx claude-blip              # global (recommended)
+npx claude-blip --project    # .claude/settings.json (shareable)
+npx claude-blip --local      # .claude/settings.local.json (gitignored)
+```
+
+### Uninstall
+
+```sh
+npx claude-blip --uninstall
+```
+
+## Examples
+
+Normal usage — everything is dim except the task:
+
+```
+Fixing auth bug │ myapp │ main │ opus │ ━━──────── 40K
+```
+
+Getting warm (yellow at 70%):
+
+```
+myapp │ main │ opus │ ━━━━━━━─── 140K
+```
+
+Running hot (red at 90%):
+
+```
+myapp │ main │ opus │ ━━━━━━━━━─ 180K
+```
+
+No task, no git — it adapts:
+
+```
+scripts │ sonnet │ ━━━━──────  80K
+```
+
+## How it works
+
+One file. 150 lines. Node.js only (ships with Claude Code).
+
+Claude Code pipes session JSON to your statusline script via stdin. This script reads it, picks out the useful bits, formats them, and writes one line to stdout.
+
+The context bar scales to 80% — that's roughly where Claude starts compressing context, so 100% on the bar means "you're about to lose history."
+
+## Debug
+
+Set `debug: true` in the CONFIG object at the top of `statusline.js` to dump the full JSON payload to stderr.
+
+## License
+
+MIT

package/bin/setup.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// claude-blip setup — one command, done.
+//
+// Usage:
+//   npx claude-blip              (global — recommended)
+//   npx claude-blip --project    (this project, shareable)
+//   npx claude-blip --local      (this project, gitignored)
+//   npx claude-blip --uninstall  (remove from all scopes)
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const HOOK_SOURCE = path.resolve(__dirname, "..", "statusline.js");
+
+const SCOPES = {
+  global: () => path.join(os.homedir(), ".claude", "settings.json"),
+  project: () => path.join(process.cwd(), ".claude", "settings.json"),
+  local: () => path.join(process.cwd(), ".claude", "settings.local.json"),
+};
+
+const args = process.argv.slice(2);
+const uninstall = args.includes("--uninstall");
+const scope = args.includes("--project")
+  ? "project"
+  : args.includes("--local")
+    ? "local"
+    : "global";
+
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const RESET = "\x1b[0m";
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+function getInstallDir() {
+  if (scope === "global") {
+    return path.join(os.homedir(), ".claude", "hooks");
+  }
+  return path.join(process.cwd(), ".claude", "hooks");
+}
+
+function install() {
+  const installDir = getInstallDir();
+  const dest = path.join(installDir, "statusline.js");
+  const settingsPath = SCOPES[scope]();
+  const settingsDir = path.dirname(settingsPath);
+
+  // 1. Copy the statusline script
+  fs.mkdirSync(installDir, { recursive: true });
+  fs.copyFileSync(HOOK_SOURCE, dest);
+  fs.chmodSync(dest, 0o755);
+
+  // 2. Update settings.json
+  fs.mkdirSync(settingsDir, { recursive: true });
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    } catch {
+      // Corrupted settings — start fresh
+    }
+  }
+
+  settings.statusLine = {
+    type: "command",
+    command: dest,
+  };
+
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+
+  console.log();
+  log(`${GREEN}${BOLD}blip${RESET} ${DIM}installed${RESET}`);
+  log(`${DIM}scope:  ${RESET}${scope}`);
+  log(`${DIM}hook:   ${RESET}${dest}`);
+  log(`${DIM}config: ${RESET}${settingsPath}`);
+  console.log();
+  log(`${DIM}Restart Claude Code to see it.${RESET}`);
+  console.log();
+}
+
+function removeStatusLine(settingsPath) {
+  if (!fs.existsSync(settingsPath)) return false;
+  try {
+    const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    if (!settings.statusLine) return false;
+    delete settings.statusLine;
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function uninstallAll() {
+  let removed = false;
+
+  // Remove from all settings scopes
+  for (const [name, getPath] of Object.entries(SCOPES)) {
+    if (removeStatusLine(getPath())) {
+      log(`${DIM}Removed statusLine from ${name} settings${RESET}`);
+      removed = true;
+    }
+  }
+
+  // Remove hook files
+  const locations = [
+    path.join(os.homedir(), ".claude", "hooks", "statusline.js"),
+    path.join(process.cwd(), ".claude", "hooks", "statusline.js"),
+  ];
+  for (const loc of locations) {
+    if (fs.existsSync(loc)) {
+      fs.unlinkSync(loc);
+      log(`${DIM}Removed ${loc}${RESET}`);
+      removed = true;
+    }
+  }
+
+  console.log();
+  if (removed) {
+    log(`${GREEN}${BOLD}blip${RESET} ${DIM}uninstalled${RESET}`);
+  } else {
+    log(`${DIM}Nothing to remove — blip wasn't installed.${RESET}`);
+  }
+  console.log();
+}
+
+// ─────────────────────────────────────────────────────────────
+
+if (uninstall) {
+  uninstallAll();
+} else {
+  install();
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "claude-blip",
+  "version": "1.0.0",
+  "description": "A single-file statusline for Claude Code. Zero dependencies. Just a blip.",
+  "license": "MIT",
+  "author": "davebream",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davebream/claude-blip.git"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "statusline",
+    "status-bar",
+    "cli",
+    "developer-tools"
+  ],
+  "bin": {
+    "claude-blip": "bin/setup.js"
+  },
+  "files": [
+    "statusline.js",
+    "bin/setup.js"
+  ]
+}

package/statusline.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+// claude-blip — a single-file statusline for Claude Code
+// Shows: task │ project │ branch │ model │ context usage
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+// ─────────────────────────────────────────────────────────────
+// Config
+// ─────────────────────────────────────────────────────────────
+const CONFIG = {
+  warnThreshold: 0.7,
+  criticalThreshold: 0.9,
+  barWidth: 10,
+  // Debug: set to true to log full input data to stderr
+  debug: false,
+};
+
+// ─────────────────────────────────────────────────────────────
+// ANSI
+// ─────────────────────────────────────────────────────────────
+const ANSI = {
+  dim: "\x1b[2m",
+  bold: "\x1b[1m",
+  reset: "\x1b[0m",
+  yellow: "\x1b[38;5;222m",
+  red: "\x1b[38;5;167m",
+};
+
+const dim = (s) => `${ANSI.dim}${s}${ANSI.reset}`;
+const bold = (s) => `${ANSI.bold}${s}${ANSI.reset}`;
+const color = (s, c) => `${c}${s}${ANSI.reset}`;
+const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+
+// ─────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Format token count (e.g., 12400 → "12.4K")
+ */
+function formatTokens(n) {
+  if (n >= 1000) return `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}K`;
+  return n.toString();
+}
+
+// ─────────────────────────────────────────────────────────────
+// Data Fetchers
+// ─────────────────────────────────────────────────────────────
+
+function getCurrentTask(sessionId) {
+  if (!sessionId) return null;
+
+  const todosDir = path.join(os.homedir(), ".claude", "todos");
+  if (!fs.existsSync(todosDir)) return null;
+
+  try {
+    const files = fs
+      .readdirSync(todosDir)
+      .filter(
+        (f) =>
+          f.startsWith(sessionId) &&
+          f.includes("-agent-") &&
+          f.endsWith(".json"),
+      )
+      .map((f) => ({
+        name: f,
+        mtime: fs.statSync(path.join(todosDir, f)).mtime,
+      }))
+      .sort((a, b) => b.mtime - a.mtime);
+
+    if (files.length === 0) return null;
+
+    const todos = JSON.parse(
+      fs.readFileSync(path.join(todosDir, files[0].name), "utf8"),
+    );
+    const inProgress = todos.find((t) => t.status === "in_progress");
+    return inProgress?.activeForm || null;
+  } catch {
+    return null;
+  }
+}
+
+function getContextDisplay(ctxWindow) {
+  const rawUsed = ctxWindow?.used_percentage;
+  const maxTokens = ctxWindow?.context_window_size || 200_000;
+  if (rawUsed == null) return null;
+
+  // Scale to 80% effective limit (Claude compresses around 80%)
+  const scaled = Math.min(100, Math.round((rawUsed / 80) * 100));
+  const ratio = scaled / 100;
+
+  // Bar: thin line (━ filled, ─ empty)
+  const filled = Math.round(ratio * CONFIG.barWidth);
+  const empty = CONFIG.barWidth - filled;
+  const bar = "\u2501".repeat(filled) + "\u2500".repeat(empty);
+
+  const tokenStr = formatTokens(Math.round(maxTokens * (rawUsed / 100)));
+
+  if (ratio < CONFIG.warnThreshold) {
+    return dim(`${bar} ${tokenStr}`);
+  } else if (ratio < CONFIG.criticalThreshold) {
+    return color(`${bar} ${tokenStr}`, ANSI.yellow);
+  } else {
+    return color(`${bar} ${tokenStr}`, ANSI.red);
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// Output Builder
+// ─────────────────────────────────────────────────────────────
+
+function buildStatusline(input) {
+  const data = JSON.parse(input);
+
+  if (CONFIG.debug) {
+    console.error("[blip]", JSON.stringify(data, null, 2));
+  }
+
+  const dir = data.workspace?.current_dir || process.cwd();
+  const sessionId = data.session_id || "";
+
+  const parts = [];
+
+  // 1. Current task (bold — only segment that stands out)
+  const task = getCurrentTask(sessionId);
+  if (task) {
+    parts.push(bold(task));
+  }
+
+  // 2. Project name
+  const project = path.basename(dir);
+  parts.push(dim(project));
+
+  // 3. Git branch
+  try {
+    const branch = execSync("git branch --show-current", {
+      cwd: dir,
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "ignore"],
+    }).trim();
+    if (branch) parts.push(dim(branch));
+  } catch {
+    // Not a git repo or git not available
+  }
+
+  // 4. Model
+  const model = data.model?.display_name;
+  if (model) {
+    parts.push(dim(model.toLowerCase()));
+  }
+
+  // 5. Context window (bar + token count)
+  const ctx = getContextDisplay(data.context_window);
+  if (ctx) {
+    parts.push(ctx);
+  }
+
+  // Truncate if wider than terminal — drops segments from the left (task first)
+  const sep = dim(" \u2502 ");
+  const cols = process.stdout.columns || 80;
+  while (parts.length > 1 && stripAnsi(parts.join(sep)).length > cols) {
+    parts.shift();
+  }
+  return parts.join(sep);
+}
+
+// ─────────────────────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────────────────────
+
+let input = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => (input += chunk));
+process.stdin.on("end", () => {
+  try {
+    const output = buildStatusline(input);
+    process.stdout.write(output);
+  } catch {
+    // Silent fail — a broken statusline should never interrupt your flow
+  }
+});