# statusline-pro

> A configurable status line for Claude Code. Model, context, rate limits, git and cost under the prompt, with per-segment settings and a drop-in folder for badges from other mods.

Status: Open source, 2026
Stack: TypeScript, Bun, Claude Code
Page: https://alexcloudstar.com/projects/statusline-pro/
Source: https://github.com/alexcloudstar/statusline-pro


A configurable status line for Claude Code: model, context, rate limits, git and cost under the prompt, with per-segment settings and a drop-in folder for badges from other mods.

Unlike a `statusLine` script, it ships as a Claude Code plugin with a settings pane, so there is no JSON to parse and no script to write.

## Install

Inside Claude Code:

```bash
/plugin marketplace add alexcloudstar/statusline-pro
/plugin install statusline-pro@statusline-pro
```

Or from a terminal:

```bash
claude plugin marketplace add alexcloudstar/statusline-pro
claude plugin install statusline-pro@statusline-pro
```

Open the settings pane with `/statusline-pro settings`. statusline-pro replaces the hint row under the prompt ("? for shortcuts") and leaves any `statusLine` entry in `settings.json` alone. Delete that entry if you want this to be your only status line. It needs a Claude Code build that supports mods. Mods are Claude Code's function-hook extension point, so check your build supports them before installing.

## What the Claude Code status line shows

Each segment can be set to `auto`, `always` or `never`:

- **Model:** the active model.
- **Effort:** reasoning effort, when the model reports one.
- **Context:** context window use.
- **5-hour limit:** the 5-hour rate limit and its reset.
- **7-day limit:** the weekly rate limit, shown in `auto` once usage reaches 60%.
- **Directory:** the working directory, shortened.
- **Git:** branch, dirty flag and unpushed commits, inside a git repo.
- **Cost:** session cost, shown in `auto` once it reaches $1.

New to status lines? Read the [Claude Code status line guide](/blog/claude-code-status-line-guide-2026/) for how the `statusLine` setting works and how statusline-pro compares to other tools.