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	Legacy alias	yas.toml key	Default
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	STATUSLINE_TOKEN_WINDOW	[tokens].token_window	60
theme	YAS_THEME (also --theme CLI)	CLAUDE_STATUSLINE_THEME	[appearance].theme	claude-dark
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 theme values (14 built-in themes):
  • 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