coralline

A Powerlevel10k-inspired statusline for Claude
Code that installs itself through your AI — paste one prompt, answer a few questions
about colors and layout, done.

繁體中文說明

Install (the fun way)

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 will ask you to pick a theme (with previews), choose which segments you want, decide
between a one-line or two-line layout, then wire everything up and verify it. No manual
config editing required.

What you get

╭ ~/side-project/coralline  ⎇ main+!  ◆ Fable 5  ⬡ ▰▰▰▱▱ 62% ↑1.2M ↓45.6k  5h ▰▰▱▱▱ 41% ↺2h44m  $1.23  ⊙ 02:45 pm ╮

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

Why it's fast

The statusline runs every second (refreshInterval: 1), so the script is built to be cheap:
one jq invocation extracts every field at once, and one git status --porcelain=v2 --branch
call provides branch, dirty state, and ahead/behind together. No bc, no per-field subprocess
spam. Works on stock macOS bash 3.2 and any Linux bash.

Manual install

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/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: requires jq and a Nerd Font terminal.
No Nerd Font? Set VL_ASCII=1 in your config for a glyph-free rendering.

Configuration

Everything lives in ~/.claude/coralline.conf (plain bash, sourced by the script):

Responsive layout

With VL_LAYOUT="auto" the bar stays on a single line while it fits, and greedily wraps into
up to VL_MAX_LINES rows when the window gets narrow. Width is read from $COLUMNS, falling
back to stty size on the controlling terminal; if neither is available the bar stays on one
line. Once the line cap is reached, remaining segments overflow on the last line.

wide window:    ~/dev/app  ⎇ main  ◆ Fable 5  ⬡ ▰▰▰▱▱ 62%  5h ▰▰▱▱▱ 41%  $1.23  ⊙ 14:45

narrow window:  ~/dev/app  ⎇ main  ◆ Fable 5
                ⬡ ▰▰▰▱▱ 62%  5h ▰▰▱▱▱ 41%  $1.23  ⊙ 14:45

Prefer a layout that never moves? Keep VL_LAYOUT="fixed" and pin rows with
VL_SEGMENTS / VL_SEGMENTS2 / VL_SEGMENTS3.

Lean style

Prefer Powerlevel10k's lean look — no backgrounds, just colored text? Set
VL_STYLE="lean" and each segment's VL_BG_* color becomes its text accent instead:

Tip: already a p10k user? Tell the AI installer to import your ~/.p10k.zsh — it will
carry over your style, colors, and time format. See the
Powerlevel10k import step in INSTALL.md.

Themes

claude-coral — steel blue · mauve · Claude coral (default)	catppuccin-mocha — soft pastels on dark
nord — arctic frost	gruvbox-dark — warm retro
tokyo-night — neon on deep navy	mono — grayscale minimalism

A theme is just a .conf file assigning VL_BG_* / VL_FG_* — copy one, change the colors,
and source yours from coralline.conf instead. PRs with new themes are welcome.

Tip: the preview images are generated from the real script by
tools/render-screenshots.py — after adding a theme, add it
to the THEMES list there and re-run it to get a matching preview.

Acknowledgements

The visual language of coralline — segmented pills, powerline transitions, the ⇡⇣ git
glyphs, gauges that shift color as they fill — is a loving tribute to
Powerlevel10k by
@romkatv, which set the bar for what a fast, beautiful prompt
can be. Thanks also to the wider powerline lineage
that started it all, and to Nerd Fonts for the glyphs that make
the pill shapes possible.

As for the name: coralline algae build reefs one thin, colorful layer at a time —
and coral·line is exactly what this is: a line, in Claude's coral.

License

MIT