kcchien

kcchien / claude-code-statusline

Public

A beautiful, information-dense status line for Claude Code — gradient progress bar, smart hiding, git status, cost tracking, and more.

68
7
100% credibility
Found Mar 25, 2026 at 67 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

This project enhances the status bar in Anthropic's Claude Code terminal tool with colorful progress indicators, cost tracking, git info, rate limits, and more for better visibility during AI-assisted coding sessions.

How It Works

1
🔍 Discover the enhancer

While chatting with your AI coding assistant in the terminal, you notice the plain status bar and search for a way to make it show more useful info like progress and costs.

2
📥 Grab the quick setup

You download the simple enhancer pack and run its one-click setup to place it in the right spot on your computer.

3
⚙️ Tell your assistant to use it

You open your assistant's preference file and add a short note to switch to the new fancy status display.

4
✨ Restart and watch it appear

You restart your AI assistant, and suddenly the status bar transforms into a colorful dashboard with progress bars, costs, git branch, and usage alerts that change from green to red as needed.

5
🎨 Customize if you want

Optionally tweak looks like adding icons or arrows by setting a couple of preferences in your shell setup.

👍 Work smarter every day

Now every session feels alive with real-time insights, helping you stay aware of context, spending, and project changes without slowing you down.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 67 to 68 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-code-statusline?

This Shell script transforms the blank status bar in Anthropic's Claude Code CLI into a real-time dashboard, displaying model name, context usage via a gradient progress bar, session cost, duration, git branch with dirty status, and rate limits. It solves the problem of flying blind during AI-assisted coding sessions by providing at-a-glance metrics like context_window used_percentage and total_cost_usd, all pulled from Claude Code's JSON hook. Setup is straightforward: clone the beautiful GitHub repo, run the installer, and tweak your settings.json for claude code status line setup.

Why is it gaining traction?

Developers love the smart hiding of zero values, dynamic coloring for high costs or near-full context (green-to-red bar), and sub-50ms speed that keeps the terminal snappy, even with git caching. Unlike basic alternatives, it offers true-color gradients with ASCII fallbacks, optional Nerd Font icons and Powerline arrows, plus Pro-specific rate limit tracking—making the claude code statusline UI information-dense without clutter. The beautiful GitHub page with previews and test mocks hooks users fast, showing claude code statusline examples for normal, warning, and danger states.

Who should use this?

Claude Code power users monitoring context usage or costs during long sessions, especially Claude Pro/Max subscribers tracking five-hour rate limits. Git-heavy workflows benefit from the branch and dirty indicators, ideal for AI-driven code review or worktree branches. Terminal enthusiasts tweaking claude code statusline config via env vars like CLAUDE_STATUSLINE_NERDFONT will appreciate the customizable bar.

Verdict

Grab it if you're deep into Claude Code—solid docs and one-click install make it worth the 30-second setup, despite 64 stars and 1.0% credibility score signaling early maturity. Test with the mock script first; it's a low-risk upgrade for better session awareness.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.