usage-statuslinelisted

Install a live Claude Code statusline showing 5h session and 7d weekly usage against elapsed-time pace, an optional scoped weekly cap, and a rolling count of Claude-co-authored commits. Use when the user wants usage/budget visibility in the prompt line, or asks to set up, fix, or explain the usage statusline.
jedarden/jeds-curated-skills · ★ 1 · AI & Automation · score 74

Install: claude install-skill jedarden/jeds-curated-skills

# Usage Statusline Skill A `statusLine` command for Claude Code that renders live quota usage and pace directly in the prompt — no need to run `/usage` or check a dashboard mid-session. See `README.md` in this folder for the full visual walkthrough and legend. The detection/rendering core is a plain, dependency-only bash script (`scripts/usage-statusline.sh`) — this skill is a thin wrapper that installs and wires it up. The script never mutates anything except its own on-disk cache and (when refreshing an expiring OAuth token) `~/.claude/.credentials.json`. ## Step 1: Check Requirements The script needs `bash`, `jq`, `curl`, and `git` on `PATH`, plus an active Claude Code OAuth login (`~/.claude/.credentials.json` must exist). `flock` (from `util-linux`) and `timeout` are used when present and skipped when not — they only prevent duplicate background fetches and cap runaway commit scans. Verify before installing: ```bash command -v jq curl git >/dev/null && echo "deps ok" || echo "missing a dependency" test -f ~/.claude/.credentials.json && echo "credentials ok" || echo "not logged in" ``` On macOS, `brew install util-linux coreutils` (and adding their `bin` to `PATH`) restores the locking and timeouts, but the statusline works without them. ## Step 2: Install the Script ```bash mkdir -p ~/.claude cp ~/.claude/skills/usage-statusline/scripts/usage-statusline.sh ~/.claude/usage-statusline.sh chmod +x ~/.claude/usage-statusline.sh ``` ## Step 3: Wire It Into `settings.