Claude Code status line

claude-statusline

A minimal personal status line setup for Claude Code.

1,402 stars 107 forksStatus lines Source

Install

Install
npx @kamranahmedse/claude-statusline
From source
git clone https://github.com/nilbuild/claude-statusline.git

From the README

claude-statusline

Configure your Claude Code statusline to show limits, directory and git info

Install

Run the command below to set it up

It backups your old status line if any and copies the status line script to ~/.claude/statusline.sh and configures your Claude Code settings.

Requirements

- jq — for parsing JSON
- curl — for fetching rate limit data
- git — for branch info

On macOS:

Uninstall

If you had a previous statusline, it restores it from the backup. Otherwise it removes the script and cleans up your settings.

License

MIT
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
nilbuild/claude-statusline
Type
Status lines
Language
Shell
License
MIT
Last updated
3 April 2026

FAQ

What is claude-statusline?

A minimal personal status line setup for Claude Code. It is a status line for Claude Code, from nilbuild/claude-statusline on GitHub.

How do I install claude-statusline?

Run npx @kamranahmedse/claude-statusline, then follow the setup in the README.

Is claude-statusline popular?

nilbuild/claude-statusline has 1,402 GitHub stars and 107 forks. It was last updated on 3 April 2026.

More status lines

claude-powerline

1.2k

Owloops/claude-powerline

A vim-style powerline status line with usage tracking, git integration and custom themes.

Status lines/plugin install85

cc-statusline

645

chongdashu/cc-statusline

Generates an informative status line script for Claude Code through an interactive setup.

Status lines62

CCometixLine

3.5k

Haleclipse/CCometixLine

A fast status line for Claude Code written in Rust, with git info, model and usage segments and a TUI configurator.

Status lines225

claude-dashboard

586

uppinote20/claude-dashboard

A status line plugin showing context usage, API rate limits and session cost.

Status lines/plugin install66

ccstatusline

14k

sirmalloc/ccstatusline

A highly configurable status line for Claude Code with powerline styling, themes and an interactive setup tool.

Status lines606

best-claude-hud

995

GaoSSR/best-claude-hud

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

Status lines24

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