yas

YAS! (Yet Another Statusline)

🌈 Check out the official landing page here: YAS! Yet Another Statusline

Most common form is displaying the first few rows, which include the loaded plugins & skills. Extra sections appear below them as needed

Install/Update

Requires Python 3.10+, and a Nerd Font to render the icons.

curl -fsSL https://raw.githubusercontent.com/tmck-code/yet-another-statusline/main/ops/install.sh | bash

Or install manually:

claude plugin marketplace add tmck-code/yet-another-statusline
claude plugin install yas@yet-another-statusline
claude -p "/yas:init"

If you need to install non-interactively (e.g. in CI/docker)

curl -fsSL https://raw.githubusercontent.com/tmck-code/yet-another-statusline/main/ops/install.sh | YAS_NO_TTY=1 bash
# install with specific python version e.g. 3.15
curl -fsSL https://raw.githubusercontent.com/tmck-code/yet-another-statusline/main/ops/install.sh | YAS_NO_TTY=1 YAS_PYTHON=3.15 bash

Reconfigure later — /yas:config

Run /yas:config any time to re-run the wizard against the already-installed plugin — switch theme/glyph mode, toggle labels, change the soft limit, or move to Python 3.15. It re-wires settings.json without re-registering the marketplace or reinstalling the plugin.

Demo

A dummy session to demonstrate the layout:

Widths

The statusline also renders differently according to available width

mode	width	screenshot
"medium"	<=80 pixels
"narrow"	<=55 pixels

---

Configuration

Every configurable knob resolves through one fixed precedence chain (highest wins):

CLI flag  →  canonical YAS_* env var  →  legacy-alias env var  →  yas.toml  →  built-in default

The first source in that chain that is present and valid wins; an absent or invalid source falls through to the next (an empty-string env var counts as absent). Canonical YAS_* env vars always win over their deprecated legacy aliases when both are set — the aliases keep working but are deprecated.

Knobs

Knob	Env var	yas.toml key	Default	Legacy alias
max_width	YAS_MAX_WIDTH	[layout].max_width	140	—
full_width	YAS_FULL_WIDTH	[layout].full_width	false	—
soft_limit	YAS_SOFT_LIMIT	[tokens].soft_limit	150000	—
token_window	YAS_TOKEN_WINDOW	[tokens].token_window	60	STATUSLINE_TOKEN_WINDOW
theme	YAS_THEME (also --theme CLI)	[appearance].theme	claude-dark	CLAUDE_STATUSLINE_THEME
bg_shift	YAS_BG_SHIFT (also --bg-shift CLI)	[appearance].bg_shift	warm	—
glyph_mode	YAS_GLYPH_MODE (also --glyph-mode CLI)	[appearance.glyphs].mode	nerdfont	—
single_width	YAS_GLYPH_SINGLE_WIDTH (also --glyph-single-width CLI)	[appearance.glyphs].single_width	false	—
context_state	YAS_CONTEXT_STATE	[context].state	false	—
context_labels	YAS_CONTEXT_LABELS	[context].labels	Smart,Coasting,Foggy,Cooked,Dumb	—
context_thresholds	YAS_CONTEXT_THRESHOLDS	[context].thresholds	25,50,70,90	—
show_render_time	YAS_SHOW_RENDER_TIME	[layout].show_render_time	false	—

Valid values

• theme — 14 built-in themes; unknown or unset falls back to claude-dark:
  • Dark: claude-dark, catppuccin-mocha, dracula, gruvbox-dark, nord, one-dark, solarized-dark, tokyo-night, palenight
  • Light: claude-light, catppuccin-latte, gruvbox-light, one-light, solarized-light
• bg_shift — warm or cool.
• glyph_mode — all four modes preserve column geometry; an unknown value falls back to nerdfont:
  • nerdfont — default; full fidelity, needs a Nerd Font.
  • ascii — every non-ASCII glyph → width-1 ASCII; maximum compatibility.
  • unicode — only Nerd Font PUA icons → non-PUA Unicode; keeps box/block/arrow glyphs.
  • github — GitHub-paste-safe: folds every glyph a browser renders double-wide (the box-drawing frame, block/sparkline ramp, and EAW-ambiguous punctuation/icons) to a width-1, EAW-narrow/ASCII stand-in, so a render stays column-aligned when pasted into a GitHub markdown code block.

Behaviour notes