usage-statuslinelisted
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`, `flock` (from `util-linux`), and `git` on
`PATH`, plus an active Claude Code OAuth login (`~/.claude/.credentials.json`
must exist). Verify before installing:
```bash
command -v jq curl flock git >/dev/null && echo "deps ok" || echo "missing a dependency"
test -f ~/.claude/.credentials.json && echo "credentials ok" || echo "not logged in"
```
If `flock` is missing (common on macOS), tell the user to install `util-linux`
(e.g. `brew install util-linux` and add its `bin` to `PATH`) before continuing.
## 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.json`
Add (merge — do not overwrite existing keys) a `statusLine` block to
`~/.claude/settings.json`:
```json
{
"statusLi