coralline
A Powerlevel10k-inspired statusline for Claude Code.
Ten themes, three styles, a themed subagent panel, and rate-limit forecasting. Pure Bash on macOS, Linux, and Git Bash, plus a native PowerShell renderer for Windows.
English · 繁體中文
Quick start · Themes · Styles · Segments · Subagent panel · Rate-limit tools · Configuration · Install options · Update
Quick start
Requirements: the Bash renderer needs
jqand a Nerd Font (setVL_ASCII=1for a glyph-free rendering). Git is optional and only enables git-backed segments. On Windows without Git Bash, use the native PowerShell installer instead.
Ask Claude. Paste this into Claude Code:
Please install coralline for me:
fetch https://raw.githubusercontent.com/Nanako0129/coralline/main/INSTALL.md
and follow the playbook in it.
Claude routes by environment, asks before changing preferences, and uses the appropriate installer. This fetches a mutable main/INSTALL.md; review it first or pin the playbook, installer, and payload to the same audited commit as described under Trust and security.
Or run the installer yourself on macOS, Linux, or Git Bash:
curl -fsSL https://raw.githubusercontent.com/Nanako0129/coralline/main/install.sh | bash
It recommends the latest tagged release or lets you choose mutable main. Skip the prompt with --ref v0.19.0 or another ref. If the one-line path cannot run, use the manual fallback in INSTALL.md.
After installing, a setup menu offers the defaults, an import from ~/.p10k.zsh, or a visual wizard that previews themes, styles, and segments before it writes your config. Reopen the wizard any time:
bash ~/.claude/coralline/configure.sh
Themes
Bundled themes: claude-coral, catppuccin-mocha, nord, gruvbox-dark, tokyo-night, mono, dracula, lunar-pink, reverie, and morning-haze. A theme is a .conf file assigning VL_BG_* and VL_FG_*; the wizard discovers .conf files recursively under themes/.
Your ~/.claude/coralline.conf usually starts by sourcing one:
. "$HOME/.claude/coralline/themes/claude-coral.conf"
To make your own, copy any theme file, change the colors, and source yours instead.
Styles and layout
VL_STYLE changes the shape of the bar without touching the theme's colors, so any theme works with any style.
| Style | Result |
|---|---|
pill |
powerline pills with per-segment backgrounds |
lean |
flat colored text with optional separators, uniform background, and caps |
classic |
one-word preset for the p10k uniform dark bar and trailing cap (PR #40) |
The installer can import selected style, color, and clock values from ~/.p10k.zsh; see the INSTALL.md mapping.
VL_LAYOUT="auto" measures display columns and wraps up to VL_MAX_LINES; Claude Code v2.1.153+ supplies $COLUMNS, with a terminal fallback outside Claude Code. The display-width implementation and portability rationale live in PR #10.
Segments
The default bar is dir git model ctx limit5h limit7d cost clock; every other segment is opt-in. List segments in VL_SEGMENTS, or pick and reorder them in the wizard.
| Segment | Default | Shows |
|---|---|---|
dir |
yes | current directory, with long paths collapsed |
project |
no | repository name, stable across worktrees; hidden outside git |
git |
yes | branch, staged +, modified !, untracked ?, ahead ⇡, behind ⇣ |
node |
no | active Node version from a pin file, or PATH with VL_RUNTIME_PROBE=1; hidden when undetected |
python |
no | active virtualenv, conda, or pinned Python version, or PATH with VL_RUNTIME_PROBE=1; hidden when undetected |
model |
yes | active Claude model |
effort |
no | reasoning effort: low, med, high, xhigh, or max |
ctx |
yes | context gauge and input, output, and cache token counts |
cache |
no | prompt-cache hit ratio, and the countdown to the cache expiring or cold once it has |
toks |
no | decode speed of the last response in output tokens per second, prefill excluded; ≥ marks the prefill-inclusive fallback |
ttft |
no | time to first token of the last response; hidden when it cannot be derived |
limit5h |
yes | five-hour rate-limit gauge and reset countdown |
limit7d |
yes | seven-day rate-limit gauge and reset countdown |
burn |
no | projected time until the binding 5h or 7d limit reaches 100% |
lines |
no | lines added and removed in this session |
cost |
yes | session cost in USD |
style |
no | active output style |
duration |
no | session wall-clock duration |
stash |
no | git stash count |
clock |
yes | 12- or 24-hour clock |
Gauges change from green to yellow at 50% and red at 75%; both thresholds are configurable. cache reads the same thresholds inverted, because a high hit ratio is the good outcome: it turns yellow at 50% and red at 25%.
cache needs Claude Code v2.1.263 or newer, which is where prompt_cache appears in the statusline payload. It hides itself before the session's first request. Below an hour the countdown carries seconds (10m12s, 42s), above it does not (1h06m); once the cache has gone cold, or if it never went warm, the countdown is replaced by cold. The percentage is the session's cumulative hit ratio, so it stays accurate either way and is never zeroed: what the marker tells you is whether there is still a cache behind it. The countdown is the value at the last render, not a live clock: Claude Code refreshes the statusline on payload events (and once at the expiry itself), not every second, unless you set statusLine.refreshInterval in your settings.
toks is the decode speed of the last response: its output tokens, thinking tokens included, over the time from its first token to its last. ttft is the wait before that first token. The statusline payload carries neither, so when