I built Claude Statusline to make Claude Code sessions easier to read at a glance.

When you are deep into a workflow, it is useful to know how much context you have left, what branch you are on, how long the session has been running, and how close you are to your usage limits. This project brings all of that into a small, minimal status line directly in the terminal.

What it shows

Claude Statusline surfaces the most useful session details without adding noise:

  • Current model
  • Remaining context window
  • Current directory and git branch
  • Session duration
  • Changed lines
  • Remaining usage in the current 5-hour window
  • Remaining usage in the 7-day rolling window

It also uses color progression to make the current session state easier to understand instantly.

Why I made it

Claude Code is great, but during longer sessions I wanted better visibility into what was happening without breaking focus.

This project solves that with a small Bash-based status line that combines Claude session data with rate limit information from the Anthropic API, using the existing OAuth token already available in macOS Keychain.

Installation and setup

The installer is designed to be safe by default.

It creates backups, updates the Claude configuration carefully, reuses jq if it is already installed, and falls back to a local binary when necessary. If something looks incompatible with an existing setup, it asks before replacing anything.

Try Claude Statusline

If you use Claude Code regularly and want better visibility into your current session, Claude Statusline is a simple way to bring that information directly into your terminal.

Lightweight, practical, and easy to install, it is built to help you stay aware of your session without breaking your workflow.

View the project on GitHub to explore the code and installation steps.