Statusline Generator

Configures the status line above Claude Code's prompt showing your working directory, model, and token usage. The common failure mode is a missing chmod +x that makes the whole thing go silently blank, so this includes a health check script that catches that and three other validation layers before you waste time debugging. Two layouts: minimal shows absolute counts like "ctx: 108K / 1M", full adds git status and session cost from ccusage if installed. The install script mandatorily runs verification at the end because "I wrote the file" and "the script actually works" are different things. Degrades gracefully when jq or git aren't available.

skills.sh installs: 1.5K
GitHub stars: 1.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add daymade/claude-code-skills --skill statusline-generator --agent claude-code

Installs into .claude/skills of the current project.

Files

Statusline Generator

A single-source-of-truth statusline for Claude Code. One script, two layouts, end-to-end self-verification.

Quick health check (start here when something is wrong)

Run this first whenever the statusline misbehaves. It catches the silent failures that account for most "configured but not working" reports:

bash scripts/health_check.sh

It validates four layers:

~/.claude/statusline.sh exists and is executable. Missing chmod +x is the single most common silent-failure cause — Claude Code runs the script, exec fails, statusline goes blank.
~/.claude/settings.json has a valid statusLine block pointing at the script.
Mock stdin tests covering complete data, zero tokens, missing fields, $HOME path shortening, and zero-fork git-branch rendering (via a synthetic .git/HEAD — no git binary required).
Real stdin replay from /tmp/.claude-statusline-last-stdin.json if you previously ran with CLAUDE_STATUSLINE_DEBUG=1.