⚡ Awesome Statusline

A beautiful statusline for Claude Code — context, usage limits, cost & reasoning ⚡effort, all at a glance. One line to install on macOS, Linux & Windows.

🇰🇷 한국어 · Quick Install · Presets · What it shows · FAQ

_{▶ Interactive live demo}

🆕 What's new

Built to keep pace with Claude Code — recent updates:

Why this one?

Built on Claude Code's official statusline JSON, so ⚡effort reflects live /effort changes (Opus 4.x) and disappears on models that don't support it.

🚀 Quick Install

You don't need to install jq, Git, or anything first — the installer does it for you.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/AwesomeJun/CC-statusline/main/install.sh | bash -s -- xl

Windows (PowerShell)

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/AwesomeJun/CC-statusline/main/install.ps1))) xl

Or clone and run (interactive size picker if you omit the size):

git clone https://github.com/AwesomeJun/CC-statusline.git && cd CC-statusline
./install.sh            # macOS / Linux
./install.ps1           # Windows PowerShell

Swap xl for any size — abbreviation or full name: xs/xsmall, s/small, m/medium, l/large, xl/xlarge.
Then restart Claude Code. That's it.

📐 Five Presets

One word picks how much you see. Smallest → largest:

🔤 Curious how it looks in your font? See the 15-font showcase → — including your OS's default (SF Mono, Menlo, Cascadia, Consolas…), JetBrains Mono, Fira Code, D2Coding, and more.

Colors render live in your terminal:

xsmall ─ 2 lines
🤖Opus ⚡high 💡 📂~/project 🌿(main)
🧠████░░░░░░ 5H████░░░░░░ 7D██░░░░░░░░

small ─ 2 lines
🤖 Opus 4.8 ⚡high 💡 | 🎨 default | 📂 ~/project 🌿(main)
🧠 Context ████░░░░░░ 43% | 5H ████░░░░░░ 42% | 7D ██░░░░░░░░ 18%

medium ─ 4 lines
🧠 Opus 4.8 ⚡high 💡 | 🚧 dirty | no conda | 🎨 default
📂 ~/project 🌿(main)
📝 Context █████████████████░░░░░░░░░░░░░░░░░░░░░░░ 43% used
🚀 Usage 5H ████░░░░░░ 42% | 7D ██░░░░░░░░ 18%

large ─ 5 lines
🤖 Opus 4.8 ⚡high 💡 | 📝 +5 !12 | 🐍 venv | 🎨 default
📂 ~/project 🌿(main) | 💰 1.23$ | ⏰ 1h2m
🧠 Context  █████████░░░░░░░░░░░ 43% used (87k/200k)
🚀 Usage 5H ████████░░░░░░░░░░░░ 42% (Reset 2h15m left)
⭐ Usage 7D ████░░░░░░░░░░░░░░░░ 18% (Reset Thu 19:00)

xlarge ─ 5 lines
🤖 Opus 4.8 ⚡high 💡 | 🎨 default | 📝 dirty +5 !12 | 🐍 venv
📂 ~/project 🌿(main) | 💰 1.23$ | ⏰ 1h2m
🧠 Context  █████████████████░░░░░░░░░░░░░░░░░░░░░░░ 43% used (87k/200k)
🚀 5H Limit █████████████████░░░░░░░░░░░░░░░░░░░░░░░ 42% (Resets in 2h15m)
🌟 7D Limit ███████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 18% (Resets Dec 31 at 7pm)

🎨 What it shows

All colors follow the Catppuccin palette. No Nerd Font required — every glyph is a standard emoji/Unicode block.

🔧 Change size or remove

Change size — just re-run the installer with a new size:

./install.sh m          # or: curl … | bash -s -- m

Uninstall — remove the statusLine entry from ~/.claude/settings.json (a timestamped backup is created on every install) and delete ~/.claude/awesome-statusline.sh.

✅ Requirements (auto-installed)

On Windows, Claude Code runs the statusline through Git Bash when present, otherwise PowerShell — so the installer makes sure Git Bash exists and your .sh just works.

🙋 FAQ

Does it slow Claude Code down? No — it's a small Bash script that runs per refresh.

I don't see ⚡effort. Your current model doesn't expose the effort parameter, so the field is intentionally hidden. Switch to a model that supports /effort (e.g. Opus 4.x).

Why emoji instead of Nerd Font icons? So it looks right out of the box on any terminal, with zero font setup.

Where are my old settings? Every install backs up settings.json to settings.json.backup-<timestamp> before touching it.

🧩 Or install via the plugin marketplace

Prefer Claude Code's plugin system? It's also published as a marketplace plugin:

/plugin marketplace add AwesomeJun/CC-statusline
/plugin install awesome-statusline

Then run /statusline-setup xl (or any size) to apply it. The one-line install.sh above is the primary path; this is just an alternative.