claude-statusline

Configure your Claude Code statusline to show limits, directory and git info. Fork of @kamranahmedse/claude-statusline with customizable progress bar styles.

Install

bunx @zynoo/claude-statusline

With a custom bar style:

bunx @zynoo/claude-statusline --bar-style diamond

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:

brew install jq

Configuration

Bar Style

Use the --bar-style flag during install to set the progress bar style:

| Value | Preview | |-------|---------| | diamond (default) | ▰▰▰▱▱▱▱▱▱▱ | | block | ████░░░░░░ | | dot | ●●●○○○○○○○ |

To change the style later, just re-run the install command:

bunx @zynoo/claude-statusline --bar-style block

You can also set it via environment variable in your .zshrc or .bashrc:

export CLAUDE_STATUSLINE_BAR_STYLE=diamond

Color Schemes

Each section uses a distinct color palette for easy visual separation:

| Section | < 50% | 50-70% | 70-90% | > 90% | |---------|-------|--------|--------|-------| | Context window (amber) | Light grey | Amber | Peach | Orange-red | | Current rate (warm) | Green | Orange | Yellow | Red | | Weekly rate (cool) | Teal | Sapphire | Mauve | Pink |

Color palettes inspired by Catppuccin Mocha.

Uninstall

bunx @zynoo/claude-statusline --uninstall

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

Credits

Based on claude-statusline by Kamran Ahmed. Thanks for the great work!

License

MIT — see LICENSE for details.