crystools-statusline — Claude Code plugin: live session status line
Puts context usage, git state, session cost and rate limits into a two-line status bar in Claude. Useful when you keep guessing how much room is left.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install crystools-statusline@claude-communityWhat crystools-statusline does
The plugin swaps the default Claude status line for its own. Context window usage, git branch and changes, the running cost of the session, rate limits, cache stats — all in two lines. Run help after the command to see which monitors are available.
Setup happens through /crystools-statusline, which writes statusLine and CRYSTOOLS_SL_ICONS into ~/.claude/settings.json. Claude will ask permission to read and edit that file, plus a find call to locate statusline-command.sh inside the plugin directory. Three icon modes exist: nerd, emoji (the default) and none for plain text.
The script parses JSON with jq, so install it first: brew install jq on macOS, sudo apt install jq on Linux and WSL. Branch, status and ahead/behind numbers come from git. Windows under CMD or PowerShell is not supported — Linux, macOS and WSL are. Pick nerd mode only if your terminal already uses a Nerd Font, otherwise the icons render as garbage.
What it helps with
- see how much of the context window is used
- check the branch and uncommitted changes without leaving the session
- track what the current session costs
- watch rate limits while working
- read cache hit stats
Example prompts for the agent
- Set up the status line: run
/crystools-statusline - Show the monitor list:
/crystools-statusline help - Switch icons to nerd via
CRYSTOOLS_SL_ICONS
How to install crystools-statusline
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install crystools-statusline@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about crystools-statusline
How do I install crystools-statusline in Claude Code?
Add the marketplace first: /plugin marketplace add anthropics/claude-plugins-community, then install the plugin: /plugin install crystools-statusline@claude-community. Inside Claude, run /crystools-statusline to configure the status line.
What does crystools-statusline do?
It replaces the Claude status line with two lines covering context usage, git state, session cost, rate limits and cache stats. Run help after the command to list the monitors.
What does the plugin need to run?
jq to parse JSON input and git for branch and change info. Linux, macOS and WSL are supported; Windows in CMD or PowerShell is not.
Source text
SKILL.md · MIT
# Crystools-StatusLine Claude Code plugin with productivity tools: status line, utilities, and workflow enhancements.  ## Install ```bash claude plugin marketplace add crystian/mia-marketplace claude plugin install crystools-statusline@mia-marketplace ``` Then inside Claude Code, run `/crystools-statusline` to set up the status line. ### Status Line Preview Supports three icon modes: **nerd**, **emoji** (default), and **none** (plain text).  ### Help There are these monitors (use `help` after the command to see it):  ### Permissions During setup, Claude Code will ask for permission to: - **Read** `~/.claude/settings.json` — to check if the status line is already configured - **Edit** `~/.claude/settings.json` — to add the `statusLine` and `CRYSTOOLS_SL_ICONS` configuration - **Bash (find)** — to locate the [`statusline-command.sh`](./scripts/statusline-command.sh) script in the plugin installation directory ## Platform Support | Platform | Status | |----------|--------| | **Linux** | Supported | | **macOS** | Supported | | **WSL** | Supported (developed on WSL) | | **Windows (CMD/PowerShell)** | Not supported | ## Requirements ### jq The status line script requires [jq](https://jqlang.github.io/jq/) to parse JSON input. | Platform | Command | |----------|---------| | **macOS** | `brew install jq` | | **Linux / WSL** | `sudo apt install jq` | ### git Required for branch, status, and ahead/behind info. ## Nerd Font Install some Nerd Font from the [Nerd Font](https://www.nerdfonts.com/) on your system, and configure your terminal to use it. The status line will automatically use the appropriate icons when `CRYSTOOLS_SL_ICONS` is set to `nerd`. ## License MIT --- Made with <3 by [Crystian](https://github.com/crystian)
© crystian · MIT · crystian/crystools-statusline
