Status Line Generator

Generate a custom Claude Code status line script with your choice of columns and a color theme. Installs directly to

~/.claude/settings.json

How It Works

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.

Script Directory

Important: All scripts are located in the

scripts/

subdirectory of this skill.

Agent Execution Instructions:

Determine this SKILL.md file's directory path as
```
SKILL_DIR
```
Script path =
```
${SKILL_DIR}/scripts/<script-name>.mjs
```
Replace all
```
${SKILL_DIR}
```
in this document with the actual path

Script Reference:

Script	Purpose
`scripts/generate.mjs`	Generate and install status line script from chosen options

Prerequisites

jq — required by the generated status line script to parse JSON input from Claude Code
Bun — required to run the generator. Use
```
npx -y bun
```
if not installed globally.

Usage

bash

# Preview generated script
npx -y bun ${SKILL_DIR}/scripts/generate.mjs --elements model,context,effort,git,dir --theme gruvbox

# Generate and install
npx -y bun ${SKILL_DIR}/scripts/generate.mjs --elements model,context,effort,git,dir --theme dracula --install

Options

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`

Columns

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`

Color-changing elements

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)

Themes

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

Effort icons

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.

Invocation

This skill can be invoked with or without arguments:

No args (
```
/webup-statusline
```
): Interactive prompt via
```
AskUserQuestion
```
to pick columns and theme.
With args (
```
/webup-statusline dracula
```
): NLP parse for theme and column preferences.

Arg parsing (natural language)

The args string is free-form text. Use NLP to extract:

theme — match against: gruvbox, robbyrussell, minimal, dracula. Recognize aliases (暗黑=dracula, 极简=minimal, 复古=gruvbox, レトロ=gruvbox).
elements — look for mentions of: model, context/进度/コンテキスト, effort/推理强度/努力度, git/分支/ブランチ, dir/目录/ディレクトリ, worktree/工作树/ワークツリー, vim.

Unspecified fields use defaults:

model,context,effort,git,dir

columns,

gruvbox

theme.

Workflow

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.
- "Everything (Recommended)" —
```
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)
- "Default" —
```
model,context,effort,style,git,dir
```
  (balanced — drops cost and worktree; matches the skill's default flag value)
- "Essentials" —
```
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?
- "Dracula" — modern dark, purple/pink/cyan (Recommended)
- "Gruvbox Dark" — warm retro palette, 24-bit true color
- "Robbyrussell" — classic oh-my-zsh style, no icons
- "Minimal" — no decoration, dim separators only
If args provided: Parse theme and columns from args. Skip the prompt.

Map user selections to script flags:

Column preset → expand to the preset's canonical

--elements

list:

Everything

→

model,context,cost,effort,style,git,dir,worktree

Default

→

model,context,effort,style,git,dir

```
Essentials
```
→
```
model,context,git,dir
```
```
Other
```
(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 →

--theme

value (one of

gruvbox

dracula

robbyrussell

minimal

)

Run the generator with

--install

bash

npx -y bun ${SKILL_DIR}/scripts/generate.mjs --elements <list> --theme <theme> --install

Tell user to restart Claude Code to see the new status line.

Output Examples

Dracula (all columns), remaining=49%, cost=$0.42, effort=high, output style=Explanatory, inside a worktree:

◈ Opus 4.7 | [■■■■■■■■■■□□□□□□□□□□] 51% | $0.42 | ↯ high | ❋ Explanatory | ⌂ clawmaster | ⊕ worktree:46a6 | ⎇ feat/xyz

(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:

✦ Opus 4.7 | [■■□□□□□□□□□□□□□□□□□□] 12% | ↯ medium | ⌂ skills-cc | ⎇ main

(bar green — 88% remaining; effort "medium" yellow)

Minimal (model + effort + dir + git), effort=low:

Claude Opus 4.7 · low · skills-cc · main

(no prefix icons in minimal; effort "low" green)

Notes

Generated script is saved to
```
~/.claude/scripts/statusline.sh
```
Running the skill again overwrites the existing script — just re-run to change theme or columns
The script uses
```
jq
```
to parse JSON input — make sure it's installed
Git dirty detection uses
```
--no-optional-locks
```
to avoid interfering with other git operations

webup-statusline

NPX Install

Tags

SKILL.md Content