Claude Code status line

claude-code-statusline

A themeable status line with flexible layouts, cost tracking and MCP server monitoring.

479 stars 35 forksStatus lines Source

Install

From source
git clone https://github.com/rz1989s/claude-code-statusline.git

From the README

███████╗███╗   ██╗██╗  ██╗ █████╗ ███╗   ██╗ ██████╗███████╗██████╗
██╔════╝████╗  ██║██║  ██║██╔══██╗████╗  ██║██╔════╝██╔════╝██╔══██╗
█████╗  ██╔██╗ ██║███████║███████║██╔██╗ ██║██║     █████╗  ██║  ██║
██╔══╝  ██║╚██╗██║██╔══██║██╔══██║██║╚██╗██║██║     ██╔══╝  ██║  ██║
███████╗██║ ╚████║██║  ██║██║  ██║██║ ╚████║╚██████╗███████╗██████╔╝
╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═════╝

███████╗████████╗ █████╗ ████████╗██╗   ██╗███████╗██╗     ██╗███╗   ██╗███████╗
██╔════╝╚══██╔══╝██╔══██╗╚══██╔══╝██║   ██║██╔════╝██║     ██║████╗  ██║██╔════╝
███████╗   ██║   ███████║   ██║   ██║   ██║███████╗██║     ██║██╔██╗ ██║█████╗
╚════██║   ██║   ██╔══██║   ██║   ██║   ██║╚════██║██║     ██║██║╚██╗██║██╔══╝
███████║   ██║   ██║  ██║   ██║   ╚██████╔╝███████║███████╗██║██║ ╚████║███████╗
╚══════╝   ╚═╝   ╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚══════╝╚══════╝╚═╝╚═╝  ╚═══╝╚══════╝

Claude Code Enhanced Statusline

🎨 Transform your terminal with 28 atomic components across 1-9 configurable lines
*Block metrics • Burn rate monitoring • Cache efficiency • Cost projections • Atomic precision • Clean separators • Rich information display • Stunning themes • Real-time monitoring • MCP integration • Islamic prayer times • Ultimate customization*

🎥 Live Demo & Screenshots

🎨 Catppuccin Mocha Theme in VS Code Terminal

🚀 Installation (2 minutes)

📋 Platform Requirements: 100% compatible across all major platforms
- macOS (12+): brew install jq curl
- Ubuntu/Debian: sudo apt install jq curl
- Arch Linux: sudo pacman -S jq curl
- Fedora/RHEL: sudo dnf install jq curl
- Alpine Linux: apk add jq curl
- Windows: WSL recommended with Ubuntu distribution

Choose your preferred installation method:

Option 1: Quick Install (Recommended)

🔍 Quick Security Check: Open install.sh…
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

Repository
rz1989s/claude-code-statusline
Type
Status lines
Language
Shell
License
MIT
Last updated
1 August 2026
Topics
ai-toolsbashcachingclaude-codecli-toolcost-trackingcross-platformdeveloper-toolsgit-integrationislamic-prayer-timesmodular-architectureproductivity
Listed in
awesome-claude-code (extra)

FAQ

What is claude-code-statusline?

A themeable status line with flexible layouts, cost tracking and MCP server monitoring. It is a status line for Claude Code, from rz1989s/claude-code-statusline on GitHub.

How do I install claude-code-statusline?

Clone rz1989s/claude-code-statusline from GitHub and follow the setup steps in its README.

Is claude-code-statusline popular?

rz1989s/claude-code-statusline has 479 GitHub stars and 35 forks, and is included in 1 curated Claude Code list. It was last updated on 1 August 2026.

More status lines

model-effort-band

1.1k

YeonwooSung/my-claude-code-mods

A mod that shows the selected model and observed effort level in a coloured band above the prompt.

Status lines/plugin install

coralline

550

Nanako0129/coralline

A Powerlevel10k-inspired status line that Claude installs for you after a short interview about your preferences.

Status lines42

claude-statusbar

388

leeguooooo/claude-code-usage-bar

A one-line status line showing 5-hour and 7-day rate-limit usage, reset countdowns, model and context, with several styles and themes.

Status lines/plugin install27

Usage Pulse

471

NoobyGains/usage-pulse

A usage status bar showing session and weekly limits, cost, context and agents, with ten themes and no API calls.

Status lines/plugin install32

best-claude-hud

995

GaoSSR/best-claude-hud

A minimal Rust-powered status line HUD for Claude Code.

Status lines24

claude-code-mods

439

hamzafer/claude-code-mods

Mods that add a prompt-cache timer under the status line and a colour-coded context-window bar above the prompt.

Status lines/plugin install50

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