sd0xdev/sd0x-harness/statusline-config
Claude Code and agent skill by sd0xdev/sd0x-harness
- community
Checking that the SKILL.md file is still in the repository.
Customize Claude Code statusline. Use when: user says 'statusline', 'status line', 'customize statusline', 'modify statusline', 'statusline settings', 'statusline theme', 'change theme', 'color scheme', wants to add/remove/change segments (cost, git, model, context), switch color themes (catppuccin, dracula, nord), or asks what can be shown in the statusline.
Install
npx vskill@latest install sd0xdev/sd0x-harness/statusline-configSKILL.md
The same SKILL.md was published earlier as sd0xdev/sd0x-harness/statusline-config.
StatusLine Config
Customize ~/.claude/statusline-command.sh — segments, themes, and colors.
When NOT to Use
| Scenario | Use Instead | |
|---|---|---|
| Setting statusline for the first time (no customization needed) | Built-in statusline-setup agent (Claude Code agent type) — applies defaults automatically | |
Editing settings.json directly | Manual edit — this skill manages statusline-command.sh, not settings.json | |
| Debugging Claude Code startup issues | /claude-health — config health check |
Segments
| Segment | JSON Field | Default | Notes | |
|---|---|---|---|---|
| Directory | workspace.current_dir | ON | Truncate deep paths: ~/.../last-dir | |
| Git branch | shell git | ON | --no-optional-locks, cache 5s | |
| Agent | agent.name | ON (conditional) | Show when present; color: C_MODEL | |
| Model | model.display_name + context_window.context_window_size | ON | Smart tier suffix: Opus 4.6 (1M) — auto-skip if display_name already contains context info | |
| Context % | context_window.remaining_percentage + context_window_size | ON | ctx 60% left (600k/1M) — Green >40%, Yellow 20-40%, Red <=20% | |
| Token Usage | context_window.total_input_tokens + total_output_tokens | ON (conditional) | {in}k/{out}k session cumulative; color: C_COST | |
| Cost | cost.total_cost_usd | ON | Show when >= $0.005, est $X.XX | |
| Rate Limits | rate_limits.five_hour.used_percentage + seven_day.used_percentage | ON (conditional) | 5h: 85% left · 7d: 82% left — displays remaining (100 - used); color thresholds match context %: Green >40%, Yellow 20-40%, Red <=20%; OAuth users only | |
| Worktree | worktree.name + worktree.branch | ON (conditional) | [WT:{name}] {branch} or [WT:{name}] if branch absent; replaces Directory + Git branch when present; color: C_BRANCH |
For full JSON schema, see json-schema.md.
Themes
| Theme | Type | Default | Notes | |
|---|---|---|---|---|
ansi-default | ANSI 16 | ✅ | Safe fallback, works everywhere | |
catppuccin-mocha | TrueColor | — | Recommended — pastel, WCAG AA >=4.5:1 | |
dracula | TrueColor | — | Vibrant purple/pink accents | |
nord | TrueColor | — | Arctic blue, muted tones | |
none | — | — | No colors (NO_COLOR auto-triggers) |
Switch via: export CLAUDE_STATUSLINE_THEME=catppuccin-mocha
For complete token→hex mappings, see themes.md.
Semantic Tokens
Scripts use semantic tokens instead of hardcoded colors:
| Token | Role | Example | ||
|---|---|---|---|---|
C_CWD | Directory path | blue / sapphire | ||
C_BRANCH | Git branch name | magenta / mauve | ||
C_MODEL | Model display name | cyan / teal | ||
C_CTX_OK | Context >= 41% | green | ||
C_CTX_WARN | Context 21-40% | yellow | ||
C_CTX_BAD | Context <= 20% | red | ||
C_COST | Cost display | muted text | ||
C_ALERT | >200k token warning (legacy, segment removed) | orange/peach + bold | ||
C_SEP | Pipe separator `\ | ` | dim/overlay | |
C_MUTED | Secondary info | subtext | ||
C_TEXT | General text | foreground | ||
C_RESET | Reset all formatting | \033[0m |
Workflow
No args → Apply best-practice defaults (all ON segments + ansi-default theme). Go to step 4.
Theme change (e.g. "use catppuccin-mocha", "switch to dracula") → Read themes.md, apply requested theme. Go to step 4. Aliases: catppuccin → catppuccin-mocha.
Custom requests (e.g. "add cost", "remove git", "no colors") → Interactive flow:
- Read current script:
cat ~/.claude/statusline-command.sh - Ask segments to enable/disable (AskUserQuestion multiSelect)
- Ask theme preference (AskUserQuestion with theme options)
- Generate script following Script Rules + selected theme from themes.md
- Write to
~/.claude/statusline-command.sh - Verify:
echo '{"model":{"display_name":"Opus 4.6"},"workspace":{"current_dir":"/tmp/test"},"context_window":{"remaining_percentage":55},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false}' | ~/.claude/statusline-command.sh
Script Rules
- Shebang:
#!/bin/sh(POSIX) - Read stdin:
input=$(cat) - Parse JSON:
jq -r '.field // fallback' - Theme from env:
theme="${CLAUDE_STATUSLINE_THEME:-ansi-default}" - NO_COLOR:
[ -n "${NO_COLOR:-}" ] && theme="none" - Theme aliases:
catppuccin→catppuccin-mocha - Invalid theme: fallback to
ansi-default - Color output:
printf "%b"for ANSI/TrueColor,printf "%s"for none - TrueColor format:
\033[38;2;R;G;Bm(24-bit foreground) - Git:
git --no-optional-locks -C "$dir" - Git cache:
/tmp/claude-statusline-git-cache-$(id -u), 5s TTL,stat -f %m(macOS) /stat -c %Y(Linux) - CWD truncation: depth >2 →
~/.../basename - Cost: only when
>= 0.005, formatest $X.XX - Alert style:
C_ALERT+ bold (\033[1m) to distinguish fromC_CTX_BAD - Token format:
%.1fkvia awk (e.g. 8500 →8.5k); values < 1000 show raw number - Tier format:
>=1M → (1M),>=1000 → ({N}k), else raw; used for model suffix + context absolute - Model tier suffix: append
(1M)or(200k)fromcontext_window_size; skip if `display_name` already containscontext,1M, or200k - Context absolute:
ctx 60% left (600k/1M)— remaining tokens calculated fromremaining_percentage * context_window_size / 100 - Sanitize free-text: strip control chars (
tr -d '[:cntrl:]') + truncate 30 chars foragent.name,worktree.name,worktree.branch - Worktree replace: when
worktree.namepresent, replace Directory + Git branch with[WT:{name}] {branch}(or[WT:{name}]ifworktree.branchabsent — hook-based worktrees) - Rate limits: show when
rate_limitspresent; display remaining % (100 - used_percentage) with "left" suffix; format5h: {rem}% left · 7d: {rem}% left; color by worst remaining — Green >40% (C_CTX_OK), Yellow 20-40% (C_CTX_WARN), Red <=20% (C_CTX_BAD); thresholds match context %; OAuth users only - Rate limits
resets_at: extracted but not displayed in v1 (too verbose for statusline) - Render order (normal):
Directory | Git branch | Agent? | Model (tier) | Context % (abs) · Token Usage? · Cost? · Rate Limits? - Render order (worktree):
[WT:name] branch | Agent? | Model (tier) | Context % (abs) · Token Usage? · Cost? · Rate Limits?
Script Structure
Example Output
Output
| Artifact | Path | Description | |
|---|---|---|---|
| StatusLine script | ~/.claude/statusline-command.sh | POSIX shell script consuming JSON stdin |
Verification
After generating the script, verify:
- [ ]
~/.claude/statusline-command.shexists and is executable (chmod +x) - [ ] v2 test passes:
echo '{"model":{"display_name":"Opus 4.6"},"cwd":"/tmp/test","workspace":{"current_dir":"/tmp/test","project_dir":"/tmp/test"},"context_window":{"remaining_percentage":55,"used_percentage":45,"context_window_size":200000,"total_input_tokens":85000,"total_output_tokens":12000,"current_usage":{"input_tokens":8500,"output_tokens":1200,"cache_creation_input_tokens":5000,"cache_read_input_tokens":2000}},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false,"session_id":"test","version":"2.1.80","output_style":{"name":"default"},"rate_limits":{"five_hour":{"used_percentage":42.5,"resets_at":"2026-03-21T14:30:00Z"},"seven_day":{"used_percentage":18.2,"resets_at":"2026-03-25T00:00:00Z"}}}' | ~/.claude/statusline-command.sh - [ ] Output contains expected segments (directory, model, context %, token usage
8.5k/1.2k) - [ ] Agent test:
echo '{"model":{"display_name":"Opus 4.6"},"workspace":{"current_dir":"/tmp/test"},"context_window":{"remaining_percentage":55},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false,"agent":{"name":"security-reviewer"}}' | ~/.claude/statusline-command.shshowssecurity-reviewersegment - [ ] Worktree test:
echo '{"model":{"display_name":"Opus 4.6"},"worktree":{"name":"fix-123","branch":"bugfix/issue-123"},"context_window":{"remaining_percentage":55},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false}' | ~/.claude/statusline-command.shshows[WT:fix-123] bugfix/issue-123replacing directory/branch - [ ] Rate limits test: output contains
5h: 58% left · 7d: 82% leftwith green color - [ ] Rate limits absent:
echo '{"model":{"display_name":"Opus 4.6"},"workspace":{"current_dir":"/tmp/test"},"context_window":{"remaining_percentage":55},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false}' | ~/.claude/statusline-command.shproduces valid output without rate limits segment (no errors) - [ ] v1 backward compat:
echo '{"model":{"display_name":"Opus 4.6"},"workspace":{"current_dir":"/tmp/test"},"context_window":{"remaining_percentage":55},"cost":{"total_cost_usd":0.42},"exceeds_200k_tokens":false}' | ~/.claude/statusline-command.shproduces valid output without errors - [ ] Theme matches user selection (check color codes in script)
- [ ]
NO_COLOR=1produces uncolored output
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/statusline-config/SKILL.md
Popularity
- Repository stars
- 191
- Repository forks
- 26
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sd0xdev/sd0x-harness/statusline-config)