Statusline Specification Skill

Statusline Specification

Create a statusline with this exact format:

Model │ ↑Tokens ↓Tokens $Cost │ Duration +Lines -Lines │ Context%

Example output:

Opus │ ↑15k ↓4k $1.23 │ 5m (2m) +156 -23 │ 42%

Data Sources

| Field | JSON Path | | -------------- | ------------------------------------- | | Model | .model.display_name | | Total duration | .cost.total_duration_ms | | API duration | .cost.total_api_duration_ms | | Input tokens | .context_window.total_input_tokens | | Output tokens | .context_window.total_output_tokens | | Cost | .cost.total_cost_usd | | Lines added | .cost.total_lines_added | | Lines removed | .cost.total_lines_removed | | Context % | .context_window.used_percentage |

Formatting Rules

Duration: Show as Xs, Xm, or Xh Ym — total time followed by API time in parentheses (always shown)

5m (2m) = 5 min total, 2 min waiting for API
1h 15m (45m) = 1 hour 15 min total, 45 min waiting for API
Empty state: 0s (0s)

Tokens:

Raw number if < 1,000 → 850
Lowercase k for thousands → 15k
Lowercase m with 1 decimal for millions → 1.2m

Cost:

4 decimal places if < $0.01 → $0.0012
2 decimal places if ≥ $0.01 → $0.12

Lines changed: Green for +added, Red for -removed

Model name: Reset/default terminal color (wrap with ${RESET})

Separators: Dim box-drawing character │ (U+2502)

General styling: Duration, tokens, and cost should be dim

Context % Color Thresholds

Auto-compact triggers at ~78%, so thresholds are calibrated accordingly:

| Range | Color | Meaning | | ------ | ------ | ------------------------- | | 0-49% | Green | Plenty of room | | 50-64% | Yellow | Getting used | | 65-74% | Orange | Approaching auto-compact | | 75%+ | Red | Near auto-compact trigger |

ANSI Color Definitions (Bash)

Define colors using $'...' syntax so escape sequences are interpreted. Use 24-bit true color format \033[38;2;R;G;Bm for precise colors:

DIM=$'\033[38;2;153;153;153m'      # #999999
GREEN=$'\033[38;2;55;166;96m'      # #37A660
YELLOW=$'\033[33m'
ORANGE=$'\033[38;5;208m'
RED=$'\033[38;2;187;106;122m'      # #BB6A7A
RESET=$'\033[0m'

Always wrap colored output with ${COLOR}text${RESET}.

Null Handling

Default to 0 for numeric fields when null/missing:

Tokens: 0
Cost: $0.0000
Duration: 0s (0s)
Lines: +0 / -0
Context: 0%

Only show -- for non-numeric fields like model name if truly unavailable.

Platform Notes

macOS/Linux: Use bash with the ANSI definitions above
Windows: Use PowerShell 7+ (pwsh). Use backtick syntax instead:

$Dim = "`e[38;2;153;153;153m"      # #999999
$Green = "`e[38;2;55;166;96m"      # #37A660
$Yellow = "`e[33m"
$Orange = "`e[38;5;208m"
$Red = "`e[38;2;187;106;122m"      # #BB6A7A
$Reset = "`e[0m"

Install to ~/.claude/ and update ~/.claude/settings.json with the statusLine configuration.

Agent Skills: Statusline Specification

Install this agent skill to your local

Skill Files