YAS! Yet Another Statusline plugin

A Claude Code status line in the spirit of terminal monitors: loaded plugins and skills, tokens, cost, context and subagents

  • 246 ★ on the repository
  • Last commit
  • BSD-3-Clause
Plugin

Extended access

Why this level

  • The plugin changes `statusLine.command` and adds a `UserPromptSubmit` hook to Claude Code settings
  • Installing through `curl | bash` runs a network script on your machine
  • The hook records timestamps of your prompts
All reasons and checks

tmck-code/yet-another-statusline

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/yas-yet-another-statusline

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The plugin changes `statusLine.command` and adds a `UserPromptSubmit` hook to Claude Code settings
  • Installing through `curl | bash` runs a network script on your machine
  • The hook records timestamps of your prompts

This is third-party code. Review the repository files before installing.

What it does

YAS draws a multi-row panel in the style of terminal monitors below the Claude Code input. The first rows show loaded plugins and skills, and further sections appear as needed: tokens and cost, context window fill, request rate limits, a sparkline of usage, tool-call counts and running subagents. You can turn on a context state word at the top that rates the window fill on a scale from Smart to Coasting, Foggy, Cooked and Dumb. The panel adapts to terminal width and is configured by flags, `YAS_*` variables and a `yas.toml` file with a fixed precedence order. For accurate per-turn subagent display the plugin installs a `UserPromptSubmit` hook. Installation takes one `curl` and script command or the Claude Code marketplace, and `/yas:init` and `/yas:config` run a wizard for theme, glyphs and a soft token limit.

Who it is for. Claude Code users who sit in long sessions and want to see token spend, context fill and running subagents without leaving the terminal.

Good fit when

  • A session has run for an hour and you need to know how many tokens and how much money went and when the context limit nears
  • Several subagents run and you want to see which ones work in the current turn
  • A request limit is near and you want to watch its burn rate ahead of time
  • The terminal is narrow or lacks a Nerd Font and you need a line that shrinks itself

Not a fit when

  • You need a simple one-line status: the panel takes several rows below the input
  • You have no Python 3.10 or Nerd Font: without them icons do not render
  • Another plugin already set your status line: YAS replaces the `statusLine.command` value

Example request

/yas:config

Limitations

Python 3.10 or newer and a Nerd Font for the icons are required. The `curl` installer runs a script from the network with your rights, so read it before running. YAS writes the status line setting and the `UserPromptSubmit` hook to `~/.claude/settings.json`. Uninstall in this order: first `/yas:uninstall` or the script with `--uninstall --full`, then `claude plugin uninstall`, or the status line keeps looking for the missing script. After an upgrade to the new `yas/` folder layout part of the cache is rebuilt, and the metrics are empty for the first minutes.

How to disable. Run `claude -p "/yas:uninstall"`, then `claude plugin uninstall yas@yet-another-statusline`. The install script with `--uninstall --full` does the same. Order matters: otherwise `settings.json` keeps a reference to the removed script.

FAQ

How do I install YAS?

Run `claude plugin marketplace add tmck-code/yet-another-statusline#main`, then `claude plugin install yas@yet-another-statusline` and `claude -p "/yas:init"`. A `curl` script install also exists.

How do I change settings later?

Run `/yas:config`: the wizard reconfigures theme, glyph mode, labels and the soft token limit without reinstalling the plugin.

How is the panel configured?

The precedence is: command-line flag, `YAS_*` variable, legacy alias, `yas.toml`, built-in default. The first valid source wins.

What is the context state word?

An optional word on the context line naming how full the window is: Smart, Coasting, Foggy, Cooked, Dumb. Enable it with `YAS_CONTEXT_STATE=1` or `[context].state = true`.

How do I uninstall correctly?

First `/yas:uninstall` or the script with `--uninstall --full`, then `claude plugin uninstall yas@yet-another-statusline`. In reverse order the status line is left without a script.

Discussion

No questions or reviews yet.

Plugins

A Claude Code statusline with 15 presets: model, reasoning effort, context and Pro, Max and Ultra usage limits at a glance

PluginExtended access215Repository stars

28 components, up to nine lines and 227 settings: a Claude Code status panel with tokens, cache and session price.

CLIExtended access480Repository stars

A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets

CLIExtended access13.6KRepository stars

A Claude Code status line with 5-hour and weekly limit usage, reset countdowns, model and prompt cache lifetime

PluginExtended access391Repository stars

A statusline for Claude Code: token and cost usage, context left, rate limits and git branch in four styles and six themes

PluginExtended access1.2KRepository stars

A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai

PluginBroad access587Repository stars

README in short

The project description covers installation and upgrade, the reconfiguration wizard, the move of files into a `yas/` subfolder, a demo and panel widths. Next come the settings precedence chain, the parameter table, the context state word, the `yas.toml` file, uninstall steps and development commands.

README badge

Report a problem