Claude Code status line

claude-statusline

An aesthetic, decorative status line for Claude Code.

208 stars 19 forksStatus lines Plugin marketplace Source

Install

Inside Claude Code
/plugin marketplace add awesomezun/claude-statusline
From source
git clone https://github.com/awesomezun/claude-statusline.git

From the README

⚡ Awesome Statusline

A statusline for Claude Code that shows model · reasoning effort · context · usage limits at a glance.
One line to install on macOS, Linux and Windows.

🇰🇷 한국어 · At a glance · Install · Presets · Plan · Mods · What it shows · FAQ

▶ Live demo · 15 presets: 5 sizes × 3 styles · Pro · Max · Ultra, automatic · 🧩 Mods (beta): also in the desktop app → Changelog

🧭 At a glance

15 presets: 5 sizes × 3 styles. When you install, you pick a size (how much you see) and a style (how it looks). Your plan isn't a choice: Ultra included, it's applied automatically.

- Emoji is the default: icons and gradient bars. A size on its own means this style (large).
- No emoji (-plain) keeps the layout and the bars and drops only the emoji. It's the steadiest choice where emoji widths drift: tmux, SSH, Windows consoles.
- Simple text (-simple) is text and numbers only, so the fields differ a little by size. Its colors compare usage with how much of the limit window has passed: green = under pace, yellow = on pace, red = ahead of time (or ≥ 90%).
- Sizes can be abbreviated (xs · s · m · l · xl): l-plain = large-plain. The older names simple and oneline are small-simple and xsmall-simple.
- New here? Start with large. You can switch any time.

Want it in the Claude desktop app too? Install it as a mod (beta).

Ultra is applied automatically. Ultra has no 5-hour limit, so on Ultra every preset shows one weekly line with a per-day budget in place of the 5H and 7D lines. There's nothing to pick, and changing plans never needs a reinstall. → Plan

🚀 Install

Option 1. Ask your AI agent (easiest)

Tell Claude Code:

It asks for a size, a style and where to show it, then installs. Name a preset up front (… with large-plain) and it installs straight away.

Option 2. One…
Read the full README on GitHub

How status lines work

  • A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
  • Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
  • Or run /statusline inside Claude Code and describe what you want.
Claude Code docs

Details

Language
Shell
License
MIT
Last updated
2 November 2026
Topics
anthropicawesomecatppuccinclaudeclaude-codecli-toolsdeveloper-toolspluginproductivitystatuslineterminal

FAQ

What is claude-statusline?

An aesthetic, decorative status line for Claude Code. It is a status line for Claude Code, from awesomezun/claude-statusline on GitHub.

How do I install claude-statusline?

Run /plugin marketplace add awesomezun/claude-statusline inside Claude Code, then follow the setup in the README.

Is claude-statusline popular?

awesomezun/claude-statusline has 208 GitHub stars and 19 forks. It was last updated on 2 November 2026.

More status lines

Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.