claude-simple-status 1.3.1 → 1.4.0

package/README.md

@@ -21,8 +21,8 @@ A simple, no-frills statusline for [Claude Code](https://docs.anthropic.com/en/d
 - **Cross-platform** — works on macOS, Linux, and Windows
 - **Non-blocking** — returns cached data instantly, refreshes quota in the background
 - **Color-coded** — green/orange/red percentages at a glance
-- **Context velocity** — estimates remaining turns until context compaction (`42% →~8t`), with directional arrows showing if burn rate is accelerating (↑), steady (→), or decelerating (↓)
-- **Quota pressure** — reset time changes color based on projected burn rate: green (safe), orange (cutting it close), red (will hit the limit before reset). The 7d percentage color is also overridden when the projection says danger
+- **Context velocity** *(opt-in)* — estimates remaining turns until context compaction (`42% →~8t`), with directional arrows showing if burn rate is accelerating (↑), steady (→), or decelerating (↓)
+- **Quota pressure** *(opt-in)* — reset time changes color based on projected burn rate: green (safe), orange (cutting it close), red (will hit the limit before reset). The 7d percentage color is also overridden when the projection says danger
 - **Project name** — bold uppercase project directory name so you never mix up sessions
 - **Git-aware** — shows the current branch name in repos (cached 30s to reduce overhead)
 - **API cost tracking** — pay-as-you-go API users see cumulative session cost instead of quota
@@ -92,6 +92,24 @@ To uninstall, remove `~/.claude/statusline/` and the `"statusLine"` block from s
 
 </details>
 
+## Configuration
+
+Create `~/.config/claude-simple-status.json` to enable optional features:
+
+```json
+{
+  "contextVelocity": true,
+  "quotaBurnRate": true
+}
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `contextVelocity` | `false` | Show estimated turns remaining until context compaction (`42% →~8t`) |
+| `quotaBurnRate` | `false` | Color reset time and 7d quota based on projected burn rate |
+
+Without this file, you get a clean statusline showing just project, branch, model, context %, reset time, and quota percentages.
+
 ## Requirements
 
 - Claude Code CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-simple-status",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "A simple statusline for Claude Code — project name, git branch, model, context usage, quota, and API costs at a glance",
   "type": "module",
   "bin": {

package/statusline.mjs

@@ -46,7 +46,7 @@ const CACHE_STALE_AGE = 300; // seconds - when to show "--" instead of old value
 const GIT_BRANCH_CACHE = join(tmpdir(), 'claude-statusline-branches.json');
 const GIT_BRANCH_MAX_AGE = 30; // seconds
 const CONTEXT_HISTORY_FILE = join(tmpdir(), 'claude-statusline-context.json');
-const CONTEXT_COMPACT_THRESHOLD = 95; // % at which compaction typically fires
+const CONTEXT_COMPACT_THRESHOLD = 83; // % at which autocompact typically fires
 const CONTEXT_MAX_SAMPLES = 20; // rolling window of turn deltas
 const QUOTA_HISTORY_FILE = join(tmpdir(), 'claude-statusline-quota-history.json');
 const QUOTA_MAX_READINGS = 30; // ~1h of data at 120s refresh intervals
@@ -81,6 +81,12 @@ function readJsonFile(filepath) {
     }
 }
 
+// User config — features off by default, opt-in via ~/.config/claude-simple-status.json
+const CONFIG_FILE = join(homedir(), '.config', 'claude-simple-status.json');
+const userConfig = readJsonFile(CONFIG_FILE) || {};
+const SHOW_CONTEXT_VELOCITY = userConfig.contextVelocity === true;
+const SHOW_BURN_RATE = userConfig.quotaBurnRate === true;
+
 // Clean up stale lock (older than 30s)
 function cleanStaleLock() {
     if (existsSync(LOCK_DIR) && getFileAge(LOCK_DIR) > 30) {
@@ -233,8 +239,9 @@ function getContextVelocity(projectDir, contextUsed) {
     history[projectDir] = entry;
     try { writeFileSync(CONTEXT_HISTORY_FILE, JSON.stringify(history)); } catch {}
 
-    // Need at least 2 turn deltas to estimate
-    if (entry.deltas.length < 2) return null;
+    // Need at least 5 turn deltas to estimate — fewer gives noisy results
+    // (especially right after compaction when early turns inflate context quickly)
+    if (entry.deltas.length < 5) return null;
 
     // Weighted average: recent deltas matter more
     let weightSum = 0;
@@ -399,8 +406,8 @@ async function main() {
         hasError = errContent.length > 0;
     } catch {}
 
-    // Get context velocity estimate
-    const velocity = getContextVelocity(projectDir, contextUsed);
+    // Get context velocity estimate (opt-in)
+    const velocity = SHOW_CONTEXT_VELOCITY ? getContextVelocity(projectDir, contextUsed) : null;
 
     // Get rig name (claude-rig sets CLAUDE_CONFIG_DIR to ~/.claude-rig/rigs/<name>)
     const rigProfile = (() => {
@@ -425,15 +432,15 @@ async function main() {
         contextDisplay += ` ${turnsColor}${velocity.arrow}${turnsStr}${RESET}`;
     }
 
-    // Color the reset time based on 5h quota burn rate projection
-    const fiveHourPressure = getQuotaPressure('5h', fiveHourPct, fiveHourResetsAt);
+    // Color the reset time based on 5h quota burn rate projection (opt-in)
+    const fiveHourPressure = SHOW_BURN_RATE ? getQuotaPressure('5h', fiveHourPct, fiveHourResetsAt) : null;
     let resetDisplay = resetLocal;
     if (fiveHourPressure === 'danger') resetDisplay = `${RED}${resetLocal}${RESET}`;
     else if (fiveHourPressure === 'tight') resetDisplay = `${ORANGE}${resetLocal}${RESET}`;
     else if (fiveHourPressure === 'safe') resetDisplay = `${GREEN}${resetLocal}${RESET}`;
 
-    // Override 7d percentage color when burn rate projects exhaustion before reset
-    const sevenDayPressure = getQuotaPressure('7d', sevenDayPct, sevenDayResetsAt);
+    // Override 7d percentage color when burn rate projects exhaustion before reset (opt-in)
+    const sevenDayPressure = SHOW_BURN_RATE ? getQuotaPressure('7d', sevenDayPct, sevenDayResetsAt) : null;
     let sevenDayDisplay = colorPct(sevenDayPct);
     if (sevenDayPressure === 'danger') sevenDayDisplay = `${RED}${sevenDayPct}%${RESET}`;
     else if (sevenDayPressure === 'tight') sevenDayDisplay = `${ORANGE}${sevenDayPct}%${RESET}`;