⚡ 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:

Highlights

• ⚡ Reasoning effort & thinking — shows /effort (high/xhigh/max) and extended thinking, live from Claude Code's official statusline JSON (and hidden on models that don't support effort).
• 📊 5h / 7d usage — limit bars from the official rate-limit API, so you can see how much budget is left.
• 🖥️ No Node, no Nerd Font — Bash on macOS/Linux, native PowerShell on Windows, standard emoji everywhere.
• 📦 No Windows extras — Windows uses built-in PowerShell; macOS/Linux auto-install jq if needed.
• 📐 Five size presets (xs–xl) — pick how much you see with one word.

There are several great Claude Code statuslines out there — this one leans into reasoning-effort/thinking visibility and zero-setup, cross-platform install.

🚀 Quick Install

You don't need Node. On Windows, you also don't need jq, Git, or Git Bash — the installer uses PowerShell.

macOS / Linux

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

Windows (PowerShell)

irm https://raw.githubusercontent.com/AwesomeJun/CC-statusline/main/install.ps1 | iex

If your security software blocks irm | iex, download the installer first, inspect it, then run it:

Invoke-WebRequest -Uri https://raw.githubusercontent.com/AwesomeJun/CC-statusline/main/install.ps1 -OutFile .\install.ps1
notepad .\install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

To choose a specific size, append it explicitly:

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

Or clone and run:

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

Use any size explicitly — 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 12-font showcase → — 10 cross-platform mono fonts plus Menlo and MesloLGS.

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 or ~/.claude/awesome-statusline.ps1.

✅ Requirements

On Windows, the installer writes a native awesome-statusline.ps1 and points Claude Code at powershell -NoProfile .... That avoids Git Bash, .sh file association issues, and jq PATH problems.

🙋 FAQ

Does it slow Claude Code down? No — it's a small local 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.

Statusline is blank, or blank terminal windows keep popping up (Windows)? Re-run ./install.ps1 — it now installs a native PowerShell renderer and removes the Git Bash / jq dependency from the statusline path. Details: TROUBLESHOOTING.md.

Characters stack vertically inside tmux? Enable truecolor in ~/.tmux.conf (set -ga terminal-overrides ",xterm-256color:RGB") and reload tmux. Details: TROUBLESHOOTING.md.

🧩 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 to apply it, or pass any size like /statusline-setup xl. The one-line install.sh above is the primary path; this is just an alternative.

Built with 🩵 for the Claude Code community · Catppuccin theme · MIT License

⭐ Star it if it made your terminal nicer.

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "awesome-statusline",
  "description": "Awesome Statusline — the effort & thinking statusline for Claude Code",
  "owner": {
    "name": "AwesomeJun",
    "email": "sjkang89@gmail.com"
  },
  "plugins": [
    {
      "name": "awesome-statusline",
      "version": "3.3.2",
      "description": "A Claude Code statusline that shows reasoning effort and thinking. 5 presets (xsmall-xlarge), Catppuccin, no Node/Nerd Font, native PowerShell on Windows.",
      "author": {
        "name": "AwesomeJun",
        "email": "sjkang89@gmail.com"
      },
      "source": "./",
      "category": "tools",
      "keywords": [
        "statusline",
        "catppuccin",
        "effort",
        "thinking",
        "context-window",
        "api-usage"
      ],
      "homepage": "https://github.com/AwesomeJun/CC-statusline"
    }
  ]
}