OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add webup/skills-cc --skill webup-statusline
Generate and install a custom Claude Code status line with selectable columns (model, context, effort level, git, dir, worktree, vim) and a color theme. Context and effort elements color-change based on level. Triggers on "status line", "statusline", "customize status", "status bar", "effort level display", "状态栏", "ステータスライン", or similar.
npx skills add webup/skills-cc --skill webup-statusline
Generate a custom Claude Code status line script with your choice of columns and a color theme. Installs directly to ~/.claude/settings.json.
Claude Code supports custom status lines via a shell script configured in ~/.claude/settings.json. The script receives session JSON on stdin (model, context window, workspace, vim, worktree, etc.) and prints formatted text to stdout.
This skill generates a bash script tailored to your preferences and installs it automatically.
Important: All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions:
SKILL_DIR${SKILL_DIR}/scripts/<script-name>.mjs${SKILL_DIR} in this document with the actual pathScript Reference:
| Script | Purpose |
|---|---|
scripts/generate.mjs | Generate and install status line script from chosen options |
npx -y bun if not installed globally.| Flag | Default | Description |
|---|---|---|
--elements <list> | model,context,cost,effort,style,git,dir | Comma-separated columns to display |
--theme <name> | gruvbox | Color theme — see table below |
--effort-icon <preset> | arrow (↯) for iconic themes, none otherwise | Override the effort prefix icon. Presets: arrow, bolt, flash, reason, dot, none. A raw character is also accepted. |
--install | off | Write script to ~/.claude/scripts/statusline.sh and update settings.json |
| Column | Description | Data source |
|---|---|---|
model | Active model name (e.g. "Opus 4.7") | model.display_name |
context | Progress bar + percentage — color changes with remaining capacity | context_window.remaining_percentage |
cost | Session API spend formatted as $X.XX in gold — hidden when rounds to $0.00 | cost.total_cost_usd from input JSON |
effort | Reasoning effort level — color changes with level | effortLevel in ~/.claude/settings.local.json → ~/.claude/settings.json |
style | Output style name (e.g. Explanatory, Learning) — hidden when "default" | output_style.name from input JSON |
git | Git branch name (yellow when dirty) | worktree.branch → git CLI |
dir | Repo basename (original repo when in a worktree) | worktree.original_repo_dir → workspace.current_dir |
worktree | Bold worktree:<id> label (hidden outside a worktree) | worktree.name → parent-dir basename via git CLI |
vim | Vim mode indicator (hidden when inactive) | vim.mode |
context — bar fill + percentage color scale with remaining capacity:
| Remaining | Color | Meaning |
|---|---|---|
| > 50% | green | plenty of context |
| 20–50% | yellow | watch out |
| < 20% | red | nearly full — compact soon |
effort — value + optional prefix icon color by level:
| Level | Color |
|---|---|
max, xhigh, high | bold red |
medium | yellow |
low, xlow, minimal | green |
| other / unset | dim (or hidden when completely unset) |
| Theme | Vibe | Icons rendered in bar |
|---|---|---|
gruvbox | Warm retro, muted | ✦ model · ↯ effort · ❋ style · ⌂ dir · ⊕ worktree · ⎇ git · ⌨ vim |
dracula | Modern dark, high saturation | ◈ model · ↯ effort · ❋ style · ⌂ dir · ⊕ worktree · ⎇ git · ⌨ vim |
robbyrussell | Classic oh-my-zsh | no prefix icons — colors + labels only |
minimal | Default terminal colors | no prefix icons — plain text |
The context column intentionally skips a prefix icon — the colored progress bar is already visually rich. The effort prefix (↯) is baked into iconic themes and can be overridden with --effort-icon.
Pass --effort-icon <preset> to swap the glyph in front of the effort value. Presets:
| Preset | Glyph | Notes |
|---|---|---|
arrow | ↯ | Electric arrow — default, narrow |
bolt | ϟ | Greek koppa — narrow lightning |
flash | ⚡ | Classic lightning — wide in emoji-presentation fonts |
reason | ∴ | Therefore |
dot | ◉ | Filled circle |
none | (hidden) | Drop the icon entirely |
You can also pass any raw character as --effort-icon <char>.
Worktree behavior: When inside a git worktree (detected via the input JSON's worktree.* fields or via git rev-parse --git-common-dir fallback), the worktree column shows a bold worktree:<id> label using the parent dir name (e.g. ~/.codex/worktrees/46a6/clawmaster → worktree:46a6). The git column prefers worktree.branch from the input JSON; the dir column prefers worktree.original_repo_dir so the repo identity stays stable across worktrees.
This skill can be invoked with or without arguments:
/webup-statusline): Interactive prompt via AskUserQuestion to pick columns and theme./webup-statusline dracula): NLP parse for theme and column preferences.The args string is free-form text. Use NLP to extract:
Unspecified fields use defaults: model,context,effort,git,dir columns, gruvbox theme.
If no args provided: Use AskUserQuestion to ask 2 questions in a single prompt. AskUserQuestion caps each question at 4 options, so offer curated presets for columns rather than an exhaustive toggle list. If the user picks "Other", interpret their free text as a comma-separated column list (or a natural-language description that maps to one).
Q1 — Column preset (single): Which columns to display? Offer these 3 curated presets — AskUserQuestion will auto-append an "Other" option that lets the user type a free-text column list or description.
model,context,cost,effort,style,git,dir,worktree (all columns that have a useful signal today; vim is excluded because most users don't use vim keybindings)model,context,effort,style,git,dir (balanced — drops cost and worktree; matches the skill's default flag value)model,context,git,dir (lean; no effort, no style, no cost)If the user picks the auto-added "Other", treat their free text as a comma-separated column list, or as a natural-language description to map to columns. Fall back to Default if parsing is ambiguous.
Q2 — Theme (single): Color theme?
If args provided: Parse theme and columns from args. Skip the prompt.
Map user selections to script flags:
--elements list:
Everything → model,context,cost,effort,style,git,dir,worktreeDefault → model,context,effort,style,git,dirEssentials → model,context,git,dirOther (auto-added by AskUserQuestion) → parse the user's free text; keep only recognized column names (model,context,cost,effort,style,dir,worktree,git,vim). If parsing is ambiguous, fall back to Default.--theme value (one of gruvbox, dracula, robbyrussell, minimal)Run the generator with --install:
Tell user to restart Claude Code to see the new status line.
Dracula (all columns), remaining=49%, cost=$0.42, effort=high, output style=Explanatory, inside a worktree:
(bar yellow — 49% remaining; $0.42 gold session spend next to the bar; effort "high" bold red; purple ❋ Explanatory sits between effort and dir; context carries no prefix icon — the bar is already visual enough)
Gruvbox Dark (model + context + effort + dir + git), remaining=88%, effort=medium:
(bar green — 88% remaining; effort "medium" yellow)
Minimal (model + effort + dir + git), effort=low:
(no prefix icons in minimal; effort "low" green)
~/.claude/scripts/statusline.shjq to parse JSON input — make sure it's installed. On Windows, the script auto-detects WinGet and scoop jq paths; if jq is still not found, add it to PATH manually.--no-optional-locks to avoid interfering with other git operations