Registry / devops / ccstatusline-usage

ccstatusline-usage

library2.4.4jsnpmunverified

ccstatusline-usage v2.4.4 is a fork of ccstatusline that adds API usage widgets for Claude Code CLI. It provides a highly customizable status line displaying model info, git branch, token usage, session/weekly Anthropic API utilization bars with progress, weekly pace indicator, reset timer, context window display, and off-peak status. It supports multi-provider routing: Anthropic models hit the usage API; opencode/local models (GLM, Kimi, MiniMax, Qwen, Ollama) skip the fetch to avoid unnecessary API calls. Released under MIT license, maintained on GitHub.

devops

npm install ccstatusline-usage

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CCSTATUSLINE-USAGE

ccstatusline-usage

devopsjavascriptv2.4.4

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.

ccstatusline-usage

✓ npx -y ccstatusline-usage@latest

✗ npm install -g ccstatusline-usage

This package is designed to be run via npx as a Claude Code status line command, not installed globally or imported as a module.

Shows how to set ccstatusline-usage as the status line in Claude Code CLI configuration.

// Configure ~/.claude/settings.json: { "statusLine": { "type": "command", "command": "npx -y ccstatusline-usage@latest", "padding": 0 } }

Debug

Known issues

gotchaPackage is meant to be run via npx, not installed globally. Running npm install -g may lead to version conflicts or unexpected behavior.

fix

Use npx -y ccstatusline-usage@latest in the statusLine command field.

affects: >=0.0.0

gotchaMulti-provider routing requires exact model IDs to match the resolver patterns. Mistyped model IDs will be treated as unknown and hide usage widgets.

fix

Ensure model IDs contain expected substrings (e.g., glm, kimi, mm-, qwen, owen, mimo) for opencode routing.

affects: >=2.0.0

breakingAPI usage fetching requires a valid ANTHROPIC_API_KEY in the environment. Without it, usage widgets will fail silently or show no data.

fix

Set ANTHROPIC_API_KEY in your environment before running Claude Code.

affects: >=1.0.0

deprecatedUpstream package 'ccstatusline' (by sirmalloc) does not include API usage widgets. Users migrating from the upstream should update their Claude Code configuration.

fix

Change the statusLine command to use ccstatusline-usage@latest instead of ccstatusline.

affects: <1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'ccstatusline-usage'

Node.js tries to require a locally installed package instead of using npx.

fix

Run the package via npx: npx -y ccstatusline-usage@latest

npx: command not found: ccstatusline-usage

npx is not installed or outdated, or the package name is mistyped.

fix

Ensure npm/npx is installed (Node.js >=14) and use the correct package name: ccstatusline-usage

Upgrade

Version history

2.4.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/pcvelz/ccstatusline-usage ↗

packageccstatusline-usage ↗

homepagehttps://github.com/pcvelz/ccstatusline-usage#readme ↗