coralline

A Powerlevel10k-inspired statusline for Claude Code with one installer entrypoint for humans and AI: run it directly, or ask Claude to run it and handle the setup for you.

繁體中文說明

What you get

╭ ~/side-project/coralline  ⬢ coralline  ⎇ main+!  ◆ Fable 5  ψ high  ⬡ ▰▰▰▱▱ 62% ↑1.2M ↓45.6k  5h ▰▰▱▱▱ 41% ↺2h44m  7d ▰▰▰▰▱ 79% ↺1d11h  +321 −87  $1.23  ✎ Explanatory  ⧖ 47m  ⚑ 1  ⊙ 02:45 pm ╮

Gauges change color as they fill: green → yellow at 50% → red at 75% (thresholds configurable).

Subagent panel

Claude Code shows an agent panel below the prompt while subagents run; each row defaults to name · description · token count. coralline can theme the subagent rows and add the per-task model, a context gauge, and elapsed time:

 scout · Explore config sources ◆ gpt-5.6-luna ⬡ ▰▰▱▱▱ 21% 42.0k ⧖ 2m05s
 executor · Apply R2 fixes ◆ Fable 5 ⬡ ▰▰▰▰▱ 77% 155.0k ⧖ 45s

Claude Code v2.1.211 does not include its internal agentType role in the subagentStatusLine payload, but local Agent tasks have a small metadata sidecar next to the session transcript. coralline reads that local file without starting another process, so roles such as scout and executor return. The row keeps both identity and task label: an explicit per-task name is retained alongside the role when both exist, followed by label or description. If the sidecar is absent or unreadable, the payload fields still render normally.

The model comes directly from Claude Code's per-task model payload field; coralline never infers it from the main-session model or the agent role. Known Claude IDs are shortened (claude-haiku-4-5-… → Haiku 4.5), while unknown or gateway IDs such as gpt-5.6-luna are shown verbatim.

Enable or disable the renderer directly:

bash ~/.claude/coralline/configure.sh --subagent-rows=on
bash ~/.claude/coralline/configure.sh --subagent-rows=off

The setup wizard offers the same toggle. Disabling removes only the subagentStatusLine entry and preserves every other Claude setting. On PowerShell-only Windows, rerun the native one-line installer below with $subagentRows="on" or $subagentRows="off". Its default $subagentRows="preserve" leaves any existing subagentStatusLine untouched.

Per-task model and contextWindowSize need Claude Code v2.1.205+. Missing fields degrade one segment at a time: no model hides only the model segment; tokenCount still renders as a bare count without contextWindowSize; and the rest of the row remains themed. Refresh is panel-event-driven rather than a fixed one-second poll, so elapsed time changes when Claude Code redraws the panel.

Live payloads currently expose no per-task effort. coralline does not reuse the main-session effort or guess from the role; effort can be added only if Claude Code exposes it later. The panel's native main-session row remains visible because it is outside the subagentStatusLine protocol; only the subagent rows are replaced and themed.

VL_SUB_SEGMENTS (default "name model ctx elapsed") picks and orders the row segments. These four are the complete set:

The renderer shares your config file but reads only the knobs that shape a row: VL_STYLE with its per-style knobs — the pill caps and separator (VL_CAP_L, VL_CAP_R, VL_SEP) and the lean/classic family (VL_LEAN_SEP, VL_LEAN_BG, VL_LEAN_CAP_L/VL_LEAN_CAP_R, VL_LEAN_FG, VL_BG_BAR) — VL_ASCII, VL_NAME_MAX (recommended — panel labels are long, and overlong rows are clipped from the right, hiding model/ctx first), the gauge knobs (VL_BAR_WIDTH, VL_BAR_FILL, VL_BAR_EMPTY, VL_CTX_GLYPH, VL_WARN_PCT, VL_HOT_PCT), the shared palette (VL_FG_TEXT, VL_FG_DIM, VL_FG_OK, VL_FG_WARN, VL_FG_HOT), the row colors VL_BG_SUB_NAME / VL_BG_SUB_MODEL / VL_BG_SUB_CTX / VL_BG_SUB_ELAPSED (empty = fall back to VL_BG_DIR / VL_BG_MODEL / VL_BG_CTX / VL_BG_DURATION), and the name pill's per-status text colors VL_FG_SUB_TEXT / VL_FG_SUB_OK / VL_FG_SUB_HOT / VL_FG_SUB_DIM (empty = fall back to VL_FG_TEXT / VL_FG_OK / VL_FG_HOT / VL_FG_DIM). The main palette is tuned for the gauge segments' dark ground, so the built-in defaults and every bundled theme give the name pill that same dark ground via VL_BG_SUB_NAME and keep the theme's own light inks; without it the completed, failed, and unknown tints drop as low as 1.0:1 on a light pill. The targets are checked against both that pill and the uniform bar VL_STYLE="classic" paints instead. Setting VL_BG_SUB_NAME="" restores the light pill. Everything else — VL_SEGMENTS*, layout (VL_LAYOUT, VL_MAX_LINES, VL_WRAP_MARGIN), clock, cost, lines, float, limit-sync, burn, git, and the runtime segments — is main-bar-only and ignored here. To theme panel rows independently of the main bar, point the registration at its own config file. For example, the Bash registration can use: CORALLINE_CONFIG=~/.claude/coralline-subagent.conf bash ~/.claude/coralline/statusline.sh --subagent. The native renderer honors the same CORALLINE_CONFIG environment variable.

Install

On macOS, Linux, and Windows environments with Bash, the install routes use install.sh. PowerShell-only Windows uses the recommended native install.ps1 route under Windows without Git Bash. It needs only Windows PowerShell 5.1: no Bash, Git, jq, WSL, or archive extractor.

Bash requirements: jq and a Nerd Font terminal. No Nerd Font? Set VL_ASCII=1 in your config for a glyph-free rendering. The native PowerShell renderer below does not require jq.

Ask Claude (recommended)

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 checks the environment first. In a Bash environment it uses install.sh, interviews you, and can open the visual wizard. On PowerShell-only Windows it uses install.ps1, which installs the native renderer and themes but does not provide a wizard or create coralline.conf.

If your Claude flags the playbook and wants to inspect things first, that is the right instinct, not an obstacle: see Trust and security.

Install it yourself

Run the Bash installer in your terminal:

curl -fsSL https://raw.githubusercontent.com/Nanako0129/coralline/main/install.sh | bash

When run interactively it asks which version to install — the latest tagged release (recommended) or main (latest development). To skip the prompt, pin one explicitly with --ref, e.g. ... | bash -s -- --ref v0.9.1 or --ref main.

Manual

git clone https://github.com/Nanako0129/coralline ~/.claude/coralline-src
mkdir -p ~/.claude/coralline/themes
cp ~/.claude/coralline-src/statusline.sh ~/.claude/coralline/
cp ~/.claude/coralline-src/configure.sh ~/.claude/coralline/
cp ~/.claude/coralline-src/install.sh ~/.claude/coralline/
cp ~/.claude/coralline-src/themes/claude-coral.conf ~/.claude/coralline/themes/

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bash ~/.claude/coralline/statusline.sh",
    "refreshInterval": 1
  }
}

Note: the commands above copy only the claude-coral theme. The Ask-Claude and one-line installers bundle every theme; after a manual install, copy the rest of ~/.claude/coralline-src/themes/*.conf into ~/.claude/coralline/themes/ to switch themes.

Windows without Git Bash

statusline.sh needs a bash to run it, so a P