yas

YAS! (Yet Another Statusline)

Most common form is displaying these stats, which include the loaded plugins & skills. Extra sections appear as needed

Install/Update

Via Claude Code plugin (Requires Python 3.10+, and a Nerd Font to render the icons)

# add the marketplace
claude plugin marketplace add tmck-code/yet-another-statusline

# to install or update
claude plugin install yas@yet-another-statusline
claude -p "/yas:init"

Demo

A dummy session to demonstrate the layout:

Layout Reference

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

• Valid theme values: claude-dark, claude-light, catppuccin-latte, catppuccin-mocha.
• Valid bg_shift values: warm or cool.
• full_width, when true, makes the box fill the terminal and ignore max_width.
• The --theme NAME / --bg-shift DIR CLI flags also accept the --theme=NAME / --bg-shift=DIR form. Pass them in the statusLine.command of your ~/.claude/settings.json.
• The legacy ~/.claude/statusline-theme file (contents = a theme name) still works as the lowest-priority theme fallback, below [appearance].theme.

yas.toml

yas.toml lives in CLAUDE_CONFIG_DIR (defaults to ~/.claude/). It is not auto-created — its absence simply means all-defaults — and /yas:init never writes it. See yas.example.toml for a fully-commented template; copy it to ~/.claude/yas.toml and uncomment what you want.

[layout]
max_width = 140

[tokens]
soft_limit = 150000
token_window = 60

[appearance]
theme = "claude-dark"
bg_shift = "warm"

yas.toml requires Python 3.11+ — it is parsed with the stdlib tomllib. On Python 3.10 the file is silently skipped; environment variables work on every Python version.

Bad config never crashes the statusline. A malformed yas.toml is ignored wholesale, and a single bad / out-of-range / wrong-type value drops only that one knob back to its default. When any yas.toml value is rejected, a compact warning row — ⚠ yas.toml: N values ignored (...) — appears at the bottom of the box listing the rejected knob names. Detailed per-value reasons go to stderr only when YAS_DEBUG is set.

Per-model soft_limit overrides

Beyond the global [tokens].soft_limit, you can declare per-model overrides as an inline array under [tokens]:

[tokens]
model = [
    { match = "opus",         soft_limit = 200000 },   # the whole Opus family
    { match = "opus-4-8[1m]", soft_limit = 1000000 },  # 1M-context variant (longer match wins)
]