Claude Code · Status Line
Issue 01 · 11 languages · 144 specimens GitHub

StatusLine A catalog of terminal status lines for Claude Code

★ NEW · The #1 reason people install this

Limit control.
Maximum productivity.
Zero surprises.

Bought a Pro plan and now you keep hitting the 5-hour or 7-day cap mid-task? The default status line never warns you. This one does. Live 5h / 7d meters, ⚠️ alert above 50 %, baked into every theme.

5-hour limit
0%
7-day limit
0%

⚠ Visual alert above 50 % — never hit the wall mid-session.

Install in 30s → See 144 specimens View on GitHub ↗
Live preview · cycling through 10 themes
Context Control

Clear context above 60% — stay sharp.

More context = slower Claude + faster limit burn. Compact early, work efficiently.

Context window
0%

…

View on GitHub
Vibe-chill install

Why touch a terminal
when you have Claude Code?

Paste this one prompt into your Claude Code session. Say "y" when it asks for permission. Done.

No git, no jq install dance, no settings.json hunt — Claude handles every step and asks before each command.

you paste in Claude Code: 
Install claude-code-statusline by amazopic for me. Clone the repo at github.com/amazopic/claude-code-statusline, back up my current ~/.claude/status-line.sh if any exists, copy statusline-bundle.sh to ~/.claude/status-line.sh and make it executable, also copy commands/statusline.md to ~/.claude/commands/. Then show me what to add to ~/.claude/settings.json so Claude Code wires up the new statusLine. Finally run ~/.claude/status-line.sh use developer to test the developer theme and tell me to restart Claude Code.

↳ Just say y (yes) at every permission prompt — Claude will run each command one by one.

Editor's Note

Claude Code ships with a sparse status line. A model name. Maybe a directory. That's it. Meanwhile your context fills up, your 5h and 7d limits tick down, your session quietly accrues cost — and you find out only when you've blown past the window.

This project is the dashboard that should have been there. Forty themes. Eighteen composable blocks. One bash file. Pick something pretty — or build your own.

View on GitHub

By the numbers

2⚠
limit warnings (5h + 7d)
40
themes
18
composable blocks
1.25%
bar precision
11
documented languages
0
runtime deps (just bash + jq)
View on GitHub
Contents · 144 specimens

The Catalog
in two volumes — detailed & compact

Twenty themes, each in two trims. Tap a name to jump to its specimen page.

View on GitHub

Specimens

Loading specimens…

View on GitHub
A side-by-side

vs. the default
status line

Capability Default Claude Code This project
View on GitHub

Compose
your own

Click blocks to add them to your status line. Watch it render live. Copy the bash and ship.

Live preview
Your recipe
Generated bash 

                

              

            

          

        

      


      

        
        
           View on GitHub 
        
        
      


      
      

        

          Get going
          
Install in 30 seconds

          
A single bundled script does both jobs: it renders your status line when Claude Code calls it, and it acts as a CLI configurator when you call it with arguments.


          

            

              

                
01

                
Clone & copy

                
Drop the bundle into ~/.claude/status-line.sh.

              

              

                
02

                
Pick a theme

                
Or compose blocks via custom.

              

              

                
03

                
Wire it up

                
Tell Claude Code about it in settings.json, restart.

              

            


            


              
              

                
                  ★
                  Or in Claude Code — easiest
                
                
Have Claude Code open? Paste these two prompts and you're done — no terminal needed.


                

                  

                    01
                    
                  

                  

                    you
                    Run: git clone https://github.com/amazopic/claude-code-statusline.git claude-code-statusline / cp claude-code-statusline/statusline-bundle.sh ~/.claude/status-line.sh — back up the existing ~/.claude/status-line.sh if there is one.
                  

                


                

                  

                    02
                    Then test it:
                    
                  

                  

                    you
                    /statusline developer
                  

                

              


              

                macOS / Linux / WSL
                
                
# 1 — clone & copy
git clone https://github.com/amazopic/claude-code-statusline.git
cp claude-code-statusline/statusline-bundle.sh ~/.claude/status-line.sh
chmod +x ~/.claude/status-line.sh

# 2 — pick a theme
~/.claude/status-line.sh use cyberpunk

# 3 — register in ~/.claude/settings.json
# { "statusLine": { "type": "command",
#   "command": "/Users/<you>/.claude/status-line.sh" } }

# 4 — restart Claude Code (or /config reload)

              


              

                Optional: /statusline slash command
                
                
mkdir -p ~/.claude/commands
cp claude-code-statusline/commands/statusline.md \
   ~/.claude/commands/statusline.md

# inside Claude Code:
/statusline cyberpunk
/statusline custom model context-bar git cost
/statusline list

              

            

          

        

      


      

        
        
           View on GitHub 
        
        
      


      
      

        

          Q & A
          
Frequently
Asked

          

        

      


      

        
        
           View on GitHub