Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Statusline Generator

Install, customize, and self-verify the Claude Code statusline — path, git branch, model, absolute token counts, and optional cost.

UtilitiesBeginner★ 1,323⑂ 212AI score 9/10Last updated: Aug 8, 2026

What it does

Gives you a single-source-of-truth statusline script for Claude Code, plus an installer and a health check that proves it actually works.

  • One-command install: install_statusline.sh backs up any existing ~/.claude/statusline.sh and settings.json, copies the script, chmod +xs it, and patches only the statusLine block with jq.
  • Two layouts: minimal one-liner by default (~/code/myproject [main] Opus 4.7 ctx: 108K / 1M); set CLAUDE_STATUSLINE_LAYOUT=full for a 3-line version with user, ccusage session/daily cost, color-coded context percentage, and git dirty markers.
  • Four-layer health check: executable bit, settings.json wiring, mock stdin tests (zero tokens, missing fields, $HOME shortening, zero-fork git branch), and replay of real captured stdin — each failure prints a one-line fix.
  • Performance discipline: reads .git/HEAD as a plain file instead of forking git, and bans bunx/npx @latest in statusLine.command; ~0.01s per refresh vs ~0.4s for package-runner statuslines.
  • Debuggability: CLAUDE_STATUSLINE_DEBUG=1 dumps the stdin JSON Claude Code passes to /tmp/.claude-statusline-last-stdin.json.

Who it's for

  • Anyone whose statusline is blank, stuck, or says "permission denied" after an edit
  • Users who want absolute token counts instead of a percentage
  • Users who want session cost (ccusage) or git branch in the bar
  • Heavy multi-session users worried about CPU churn and battery drain

Examples

  1. First-time setup: ask "configure my statusline" → installer runs, health check passes, restart Claude Code and see path, branch, model, tokens.
  2. Blank statusline rescue: "status line not showing" → the health check pinpoints the missing chmod +x and prints the exact fix command.
  3. Add cost tracking: "show session cost in the statusline" → add CLAUDE_STATUSLINE_LAYOUT=full to your shell rc and verify ccusage integration.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the daymade-claude-code/statusline-generator folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/statusline-generator/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/daymade/claude-code-skills.git /tmp/ccs && cp -r /tmp/ccs/daymade-claude-code/statusline-generator ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and make sure the skills folder exists: mkdir -p ~/.claude/skills
  2. Clone the repo: git clone https://github.com/daymade/claude-code-skills.git /tmp/ccs
  3. Copy just this skill: cp -r /tmp/ccs/daymade-claude-code/statusline-generator ~/.claude/skills/
  4. Install helpers (recommended): macOS brew install jq; Debian/Ubuntu sudo apt install jq
  5. Restart Claude Code and say "configure statusline" — the skill triggers automatically.
  6. To do it manually, cd into the skill folder and run bash scripts/install_statusline.sh, then confirm every health check line passes.
  7. For cost and git segments, add export CLAUDE_STATUSLINE_LAYOUT=full to ~/.zshrc or ~/.bashrc and restart your shell.
  8. If anything breaks later, run bash scripts/health_check.sh and follow the printed fix command.
View source on GitHub ↗License: MIT