claude-statusline

A status bar that works for both Claude Code and GitHub Copilot CLI — plus a high-contrast/neon output proxy for Copilot CLI specifically.

1. statusline.js — a single, dual-compatible status line script (model, tokens, context %, peak/off-peak marker, cwd), rendered in vivid neon truecolor. Works unmodified as the statusLine command for either Claude Code or GitHub Copilot CLI — it reads whichever tool's stdin JSON schema is actually present (see How it works).
2. copilot-hc.js — a PTY-wrapping proxy that intercepts all of Copilot CLI's own output and rewrites its hardcoded, washed-out gray colors into a brighter, higher-contrast, neon color scheme in real time. Copilot-CLI-specific; not used with Claude Code. This also affects the status line's colors when running under Copilot CLI, since Copilot CLI renders the statusLine command's stdout as part of its own output.

The peak/off-peak indicator includes a live countdown to the next state change.

Prerequisites: Node.js (18+) and Claude Code.

1. Keep this folder wherever you like (this README uses C:\projects\claude-statusline; adjust the path below if you put it elsewhere). No install step — statusline.js has no dependencies of its own.

2. Add the statusLine key to ~/.claude/settings.json (merge into the existing JSON object, don't replace it):

   macOS / Linux

   {
     "statusLine": {
       "type": "command",
       "command": "node /home/your-username/projects/claude-statusline/statusline.js"
     }
   }

   Windows

   {
     "statusLine": {
       "type": "command",
       "command": "node C:/projects/claude-statusline/statusline.js"
     }
   }

   (Use forward slashes even on Windows.)

3. Restart Claude Code (or start a new session). The status bar updates on every turn.

Claude Code's stdin JSON schema is stable and documented at code.claude.com/docs/en/statusline: context_window.total_input_tokens, context_window.remaining_percentage, model.display_name, cwd. example-input.json in this repo is a sanitized real payload matching that schema, useful for building/testing against without a live session.

Prerequisites: Node.js (18+) and GitHub Copilot CLI (copilot.exe).

1. Keep this folder at C:\projects\claude-statusline (or update the path below if you move it).

2. In C:\Users\<you>\.copilot\settings.json, add/merge:

   {
     "statusLine": {
       "type": "command",
       "command": "node C:/projects/claude-statusline/statusline.js"
     }
   }

   (Use forward slashes even on Windows.)

3. Restart Copilot CLI / open a new session.

GitHub Copilot CLI's statusline payload isn't pinned by a stable public schema the way Claude Code's is — field names below were confirmed from copilot help config (statusLine section), EncodeTS/copilot-statusline (a real third-party Copilot CLI statusline implementation requiring current_context_tokens / displayed_context_limit under context_window), and blog.madkoo.net's defensive field-probing statusline script, which enumerates every field-name variant seen across Copilot CLI versions.

Spawns the real copilot.exe inside a pseudo-console (via node-pty) so it still detects a TTY and emits color, then intercepts its output byte-for-byte and rewrites every color-setting SGR sequence (truecolor 38;2;/48;2;, 256-color 38;5;/48;5;, and standard 16-color 30-37/90-97/40-47/100-107) through a transform. This step is specific to Copilot CLI's own output and isn't used with Claude Code.

Copilot CLI's built-in themes (default, github, dim, high-contrast, colorblind) are baked into the copilot.exe binary as hardcoded 24-bit truecolor (and some standard 16/256-color) ANSI codes — no terminal color scheme change can fix low contrast, since Copilot CLI's colors bypass the terminal's palette entirely. copilot-hc.js patches this at the byte-stream level:

• Grayish foreground colors are blended sharply towards white (bright, legible labels/text), snapping to pure white once close enough.
• Prompt-input border glyphs (▄▀╻╹┃) receive an explicit subdued gray foreground, then the previously active text color is restored so following text cannot inherit a darker terminal default, including across delayed redraw chunks.
• Foreground resets (39, 0, and bare SGR resets) become explicit white, so uncolored text remains high contrast even when the terminal's default-color handling is unavailable.
• Dark gray backgrounds are left untouched (passed through unchanged). Copilot's overall canvas background is already forced to pure black via the separate OSC 11 rewrite below, so panel backgrounds (e.g. the prompt input box, ~20,27,34) keep their natural, slightly-lighter tone — this is what makes the box's right edge read as a border, since that edge has no explicit border glyph and relies purely on background contrast against the canvas. Mid/light gray and near-white backgrounds are safely darkened so delayed redraws or light themes cannot turn the canvas white or create unreadable white-on-white text collisions.
• Non-gray hues (diff green/red, status line colors, etc.) get a saturation + lightness boost for a vivid neon look, capped so text stays readable and backgrounds stay dark enough for overlaid text.
• Your own submitted prompt line (❯ <text> in the feed) is detected by its distinct near-white RGB(240,246,252) and recolored to bright neon teal, so your messages visually stand out from Copilot's replies.
• OSC 10/11 & Color Scheme Interception: Terminal color/theme queries (\x1b[?996n, \x1b]11;?, \x1b]10;?) are intercepted and answered immediately with dark-mode parameters (\x1b[?997;1n, black background, white foreground). This prevents newer versions (v1.0.84-6+) from timing out and falling back to native OS light themes.
• Supervised /restart Lifecycle: Runs Copilot under supervision (COPILOT_SUPERVISED="1" and COPILOT_LOADER_PID), catching exit code 75 on /restart and seamlessly respawning the PTY session with session state intact, so statusline and high-contrast improvements persist across restarts.

All the brightness/saturation constants live near the top of the file (DARK_BACKGROUND_MAX_AVG, TEXT_BLEND_FACTOR, WHITE_SNAP_THRESHOLD, and the neonify() saturation/lightness math) — tune them there if you want a different intensity.

• Node.js on PATH (or a known absolute path — see Setup).
• node-pty installed in this folder (npm install node-pty). It has a native module with an install script (node-gyp rebuild); if npm blocks it, run npm approve-scripts --allow-scripts-pending, or otherwise permit node-pty's install script to run.

1. cd C:\projects\claude-statusline && npm install (installs node-pty; already done if node_modules\node-pty exists).

2. Edit REAL_COPILOT at the top of copilot-hc.js if your copilot.exe isn't at C:\Users\<you>\AppData\Local\Microsoft\WinGet\Links\copilot.exe (find it with (Get-Command copilot).Source in PowerShell, resolving any symlink with Get-Item <path> | Select-Object -Expand Target).

3. Add a copilot function or alias to your shell profile(s) so plain copilot ... transparently runs through the wrapper.

   • Windows PowerShell 5.1: C:\Users\<you>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
   • PowerShell 7 (pwsh): C:\Users\<you>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

   function copilot {
       & "C:\Program Files\nodejs\node.exe" "C:\projects\claude-statusline\copilot-hc.js" @args
   }

   • Git Bash (~/.bashrc):

   alias copilot='node "C:/projects/claude-statusline/copilot-hc.js" --yolo'

4. Open a brand new terminal tab/window (existing tabs won't pick up profile changes) and run copilot as usual.

• This is a wrapper around the official binary, not a patch to it — it doesn't touch or modify copilot.exe itself, so CLI auto-updates are unaffected.
• The wrapper only rewrites color-related SGR/OSC sequences (including foreground resets/defaults); it does not otherwise alter Copilot CLI's behavior, input handling, or output content.
• If Copilot CLI changes its internal color palette in a future version, the specific RGB values referenced here (e.g. the user-prompt-line detection color 240,246,252) may need to be re-captured. To recapture, spawn copilot.exe directly under node-pty and dump the raw byte stream to a file (see the constants/comments in copilot-hc.js for the exact colors currently matched).

statusline.js is a single self-contained Node.js file, no build step, no dependencies.

Find the isPeak assignment and edit the hour bounds or the timezone string:

// Change 5 and 11 to your preferred window, or swap the timezone
const isPeak = isWeekday && ptHour >= 5 && ptHour < 11;
// timeZone: 'America/Los_Angeles'  ← change this

if (used >= 95)      color = FG.red;
else if (used >= 80) color = FG.orange;
else if (used >= 60) color = FG.yellow;
else                 color = FG.green;

Change 95, 80, 60 to whatever breakpoints suit your workflow.

Comment out the matching parts.push(...) call near the bottom of the file.

statusline-debug.js captures the raw JSON payload piped to the status line command and writes it to disk — handy when building or troubleshooting a status line against either tool.

1. Temporarily point the relevant settings.json at the debug script instead of statusline.js:

   {
     "statusLine": {
       "type": "command",
       "command": "node C:/projects/claude-statusline/statusline-debug.js"
     }
   }

2. Run Claude Code or Copilot CLI for one turn. The status bar shows DEBUG: wrote ....

3. Open the output file (default: ~/statusline-capture.json). Override the path with the STATUSLINE_DEBUG_PATH environment variable.

example-input.json in this repo shows a sanitized example of the Claude Code payload schema, so you can build against it without running a live session.

Both Claude Code and Copilot CLI pipe a JSON payload to the status line command via stdin on every turn. The script parses context-window metrics and model info defensively — trying Claude Code's documented field names first, falling back to Copilot CLI's field-name variants — builds an ANSI-colored string, and writes it to stdout. The host tool renders that string in its status bar.

Claude Code / Copilot CLI  ──stdin──▶  node statusline.js  ──stdout──▶  status bar
                              JSON                             ANSI string

The 3-second setTimeout exits the process if stdin never closes — without it, Node processes stack up across long sessions.

MIT