Registry / devops / copilot-statusline

copilot-statusline

JSON →
library0.1.19jsnpmunverified

A customizable status line formatter for GitHub Copilot CLI, based on ccstatusline. Version 0.1.19, released under MIT license. Requires Node.js >=14.0.0 (or Bun). Provides real-time metrics like model info, git branch, token usage, and AI Credits. Features Powerline-style rendering, multi-line support, and an interactive TUI for configuration. Fully independent from ccstatusline, with its own config paths and npm package. Release cadence: active development with frequent updates.

devops
npm install copilot-statusline
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · COPILOT-STATUSLINE
C
copilot-statusline
devopsjavascriptv0.1.19
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (run TUI)
✓ npx -y copilot-statusline@latest
✗ npx copilot-statusline
Use npx or bunx to run the TUI directly. The package does not export a programmatic API; it's a CLI tool. Using npx without -y may prompt for installation.
bunx
✓ bunx -y copilot-statusline@latest
✗ bunx copilot-statusline
Bun users should use bunx for faster execution. The -y flag skips confirmation.
run without install
✓ bunx -y copilot-statusline@latest
✗ npx copilot-statusline --no-install
The package is intended to be run via npx/bunx without global install. Local install is possible but not recommended.

Launch the interactive TUI to configure status line widgets for GitHub Copilot CLI.

npx -y copilot-statusline@latest
Debug
Known issues
gotchaRequires GitHub Copilot CLI >= 1.0.35 for live context widgets. Older versions will render those widgets blank.
fix
Update GitHub Copilot CLI to version 1.0.35 or later.
affects: <1.0.35 (GitHub Copilot CLI)
gotchaThe package is based on ccstatusline but has different config paths and npm package. Do not confuse them.
fix
Use copilot-statusline's own config (created via TUI). Do not copy ccstatusline config.
affects: all
gotchaWidgets like Context %, Context Bar, Context Length, Remaining Tokens rely on underlying fields from Copilot CLI. Missing fields render blank.
fix
Ensure Copilot CLI is updated and these fields are present in the payload.
affects: all
Errors
Common errors & fixes
Error: Cannot find module 'react'
Missing dependencies when installed locally without npm install.
fix
Run the tool via npx or bunx instead of local install. If local install needed, run 'npm install' in the package directory.
Command 'copilot-statusline' not found
Global install not performed or not in PATH.
fix
Use 'npx -y copilot-statusline@latest' or 'bunx -y copilot-statusline@latest' instead of global install.
Widget 'Context %' shows blank
GitHub Copilot CLI version < 1.0.35 missing required fields.
fix
Update GitHub Copilot CLI to version 1.0.35 or later.
Upgrade
Version history
0.1.19latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
8 hits · last 30 days
node
8
Resources
githubhttps://github.com/EncodeTS/copilot-statusline ↗
packagecopilot-statusline ↗
homepagehttps://github.com/EncodeTS/copilot-statusline ↗
copilot-statusline — npm install copilot-statusline · libregistry