skills.rest
sd0xdev
sd0xdevCOMMUNITY
Explore all skills by this author →
𝕏@Develop0xGitHub

statusline-config

Generates and customizes the Claude Code statusline shell script with segments and color themes.

189|25|Updated Jan 30, 2026
Search Tags:#claude code#configuration#terminal#shell script#theme#statusline#customize
One-click install
npx skills add https://github.com/sd0xdev/sd0x-harness --skill statusline-config-sd0xdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: statusline-config
Source: https://github.com/sd0xdev/sd0x-harness/tree/main/skills/statusline-config
Command: npx skills add https://github.com/sd0xdev/sd0x-harness --skill statusline-config-sd0xdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes references (resource) components.

What problem does it solve? Customizing the Claude Code statusline requires writing a POSIX shell script that parses JSON from stdin, handles color themes, and formats segments correctly, which is tedious and error-prone to do by hand. ## Core Features & Use Cases - Segment Management: Enable or disable statusline segments such as directory, git branch, agent, model tier, context percentage, token usage, cost, rate limits, and worktree info. - Theme Switching: Apply color themes including ansi-default, catppuccin-mocha, dracula, and nord, with NO_COLOR support and semantic color tokens. - Script Generation & Verification: Writes a POSIX-compliant statusline-command.sh to ~/.claude/ and verifies it with test JSON payloads covering v1/v2 schemas, agents, worktrees, and rate limits. - Use Case: Ask to switch your statusline to the catppuccin theme and add a cost segment, and the skill regenerates the script, applies the theme tokens, and validates the output. ## Quick Start Ask the assistant to customize your Claude Code statusline, for example to switch to the catppuccin-mocha theme and add cost and rate limit segments.

Frequently Asked Questions about statusline-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the Claude Code statusline?▼

The statusline is customized by generating a statusline-command.sh script in ~/.claude that reads JSON from stdin and prints formatted segments. You can enable or disable segments like directory, git branch, model, context percentage, cost, and rate limits, then verify the output with test JSON payloads.

How do I change the Claude Code statusline theme or colors?▼

Set the CLAUDE_STATUSLINE_THEME environment variable to ansi-default, catppuccin-mocha, dracula, or nord. The script maps semantic tokens like C_CWD and C_BRANCH to ANSI or TrueColor escape codes, and setting NO_COLOR disables all colors.

What segments can the Claude Code statusline display?▼

Available segments include current directory, git branch, agent name, model with context tier suffix, context remaining percentage with absolute tokens, session token usage, estimated cost, OAuth rate limits for 5-hour and 7-day windows, and worktree name with branch.

Does the statusline script work without jq installed?▼

No, the generated script relies on jq to parse the JSON payload piped to stdin, using jq -r with fallback operators for nullable fields. Without jq the JSON fields cannot be extracted, so jq must be installed on the system.

Why is my statusline not showing rate limit information?▼

Rate limit segments only appear for OAuth users on Pro or Max plans, since the rate_limits field is absent from the JSON payload for other accounts. The script hides the segment when the field is undefined, which is expected behavior.

When should I not use this statusline customization skill?▼

Use the built-in statusline-setup agent for first-time setup with defaults, edit settings.json manually for settings changes since this skill only manages statusline-command.sh, and use a config health check for Claude Code startup issues.

Related Skills

Explore More Software Engineering Skills→
jcwleojcwleo
10

install-statusline

Install a developer statusline and subagent monitor into Claude Code configuration.

Community
Intermediate
taloncjonestaloncjones

dotfiles-validation-and-qa

Validate dotfiles configuration and tests on macOS and Linux.

Community
Advanced
chrono-metachrono-meta
7

harness-doctor

Diagnose structural health, complexity, drift, and pattern issues in Claude Code project harnesses.

Community
Advanced
Sampi314Sampi314
1

cs-customize-statusline

Guide PowerShell statusline customization with live terminal previews and automatic settings patching.

Community
Advanced