From statusline-creator
Creates and customizes Claude Code statusline scripts from composable items. Use when: (1) user wants to add or change their statusline, (2) user asks to show cost, git, context, or other info in the status bar, (3) user says 'customize my statusline' or 'add X to my statusline', (4) user wants to create a statusline from scratch, (5) debugging statusline display issues.
npx claudepluginhub abhattacherjee/claude-code-skills --plugin statusline-creatorThis skill uses the workspace's default tool permissions.
Creates Claude Code statusline scripts from composable items with full JSON schema awareness.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Creates Claude Code statusline scripts from composable items with full JSON schema awareness.
# List available items
~/.claude/skills/statusline-creator/scripts/generate-statusline.sh --list
# Generate 2-line statusline with common items
~/.claude/skills/statusline-creator/scripts/generate-statusline.sh \
--items "model,dir,git,git-sync,context-bar,cost,duration" \
--lines 2 --install
# Test with mock data
echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/tmp/test"},"context_window":{"used_percentage":42,"context_window_size":200000},"cost":{"total_cost_usd":0.05,"total_duration_ms":120000}}' | bash ~/.claude/statusline-command.sh
statusLine to ~/.claude/settings.json:
{"statusLine": {"type": "command", "command": "bash ~/.claude/statusline-command.sh"}}
echo/printf = one row in the status barTiming: runs after each assistant message, debounced at 300ms. Cancelled if new update triggers while running.
| Item | Category | Description |
|---|---|---|
model | Display | Model name ("Opus") |
model-full | Display | Model + 1M context indicator |
dir | Display | Working directory basename |
session-id | Display | Short session ID (8 chars) |
style | Display | Output style name |
vim-mode | Display | Vim mode ([N]/[I]) |
agent | Display | Agent name when using --agent |
worktree | Display | Worktree name indicator |
context-bar | Context | Progress bar with color thresholds |
context-pct | Context | Percentage number only |
tokens | Context | Detailed in/out token counts (K) |
warn-200k | Context | Warning when >200K tokens |
cost | Metrics | Session cost ($X.XX) |
cost-color | Metrics | Cost with green/yellow/red thresholds |
duration | Metrics | Wall-clock time (Xm Ys) |
api-duration | Metrics | API response time only |
lines-changed | Metrics | Lines +added -removed |
git | Git | Branch + staged/modified (5s cache) |
git-sync | Git | Upstream ahead/behind arrows |
git-link | Git | Clickable OSC 8 repo link |
If the generator doesn't cover your use case, write items manually. See references/item-recipes.md for copy-paste bash snippets for each item.
For the complete JSON schema with all available fields, see references/json-schema.md.
jq -r '.field // 0' or jq -r '.field // empty'\033[32m green, \033[33m yellow, \033[31m red, \033[0m reset\033]8;;URL\aText\033]8;;\a (iTerm2, Kitty, WezTerm only)/tmp/statusline-* with 5s TTLprintf '%b' over echo -e for reliable escape handlingMinimal (1-line):
generate-statusline.sh --items "model,context-pct,cost" --lines 1
Standard (2-line, recommended):
generate-statusline.sh --items "model,dir,git,git-sync,context-bar,cost-color,duration" --lines 2
Full (3-line):
generate-statusline.sh --items "model-full,dir,git,git-sync,worktree,agent,context-bar,tokens,warn-200k,cost-color,duration,lines-changed" --lines 3
| Symptom | Fix |
|---|---|
| Not appearing | chmod +x the script; check disableAllHooks isn't true |
Shows -- or empty | Fields null before first API call; use // 0 fallbacks |
| Colors garbled | Use printf '%b' instead of echo -e |
| Links not clickable | Terminal must support OSC 8 (iTerm2, Kitty, WezTerm) |
| Stale values after edit | Changes appear on next assistant message, not immediately |
| Script errors → blank | Non-zero exit or no output = blank status bar |
context-bar skill — quick context usage display (subset of this skill)