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

The statusline is configured through CLI arguments and environment variables, plus a couple of optional files under your Claude config dir (~/.claude by default).

CLI arguments

Pass these in the statusLine.command of your ~/.claude/settings.json:

arg	values	default	description
--theme NAME	claude-dark, claude-light, catppuccin-latte, catppuccin-mocha	claude-dark	colour theme
--bg-shift DIR	warm, cool	warm	direction of the background gradient shift

Both also accept the --theme=NAME / --bg-shift=DIR form.

Environment variables

var	default	description
CLAUDE_CONFIG_DIR	~/.claude	base dir for config/state files (theme file, width file, token-rate log, output payloads)
CLAUDE_STATUSLINE_THEME	(unset)	theme name; overrides the config file, overridden by --theme
STATUSLINE_TOKEN_WINDOW	60	seconds; rolling window used to compute the token throughput rate
COLUMNS	(unset)	terminal-width fallback when tmux / width-file detection fail

Theme resolution

The theme is chosen by the first of these that names a known theme:

1. --theme NAME CLI arg
2. CLAUDE_STATUSLINE_THEME env var
3. ~/.claude/statusline-theme file (contents = theme name)
4. built-in default (claude-dark)

Terminal width

Width is detected by the first source that returns a positive value:

1. tmux display-message -p '#{pane_width}'
2. ~/.claude/terminal-width file
3. COLUMNS env var
4. shutil.get_terminal_size() / /dev/tty ioctl

---

Uninstalling

claude -p "/yas:uninstall"
claude plugin uninstall yas@yet-another-statusline

claude plugin uninstall only deletes the plugin cache — it leaves statusLine.command in ~/.claude/settings.json pointing at the now-missing script, so the statusline keeps trying to run. Run /yas:uninstall first to remove that config (it backs up settings.json, and skips a custom non-yas statusLine) and clear the renderer's runtime logs. Reload Claude Code afterwards.

---

Commands

make test            # run pytest suite
make demo            # animated demo at current terminal width
make statusline/test # same as demo — use during development
make demo/img        # render snapshots into demo/
make mon/run         # launch multi-session monitor TUI

Contributing

Enable the git pre-commit hooks (runs ruff / mypy / pytest on staged Python before each commit):

make hooks

Installing via git clone

Edits to the checkout take effect immediately — no reinstall step.

git clone https://github.com/tmck-code/yet-another-statusline
cd yet-another-statusline

Wire statusLine.command in ~/.claude/settings.json to point at the checkout:

"statusLine": {
  "async": true,
  "command": "python3 \"/path/to/yet-another-statusline/claude/statusline_command.py\"",
  "type": "command"
}

Note: if you also have the plugin installed, claude plugin install will overwrite statusLine.command back to the plugin cache path. Either uninstall the plugin or bump the version in .claude-plugin/plugin.json before reinstalling to keep your local path.

This prompts before setting core.hooksPath. CI runs the same checks on every push, so the hook is fast local feedback rather than the gate.