**ClaudeCodeStatusLine** banner
daniel3303 daniel3303

**ClaudeCodeStatusLine**

AI community intermediate

Description

A custom status line for [Claude Code](https://claude.com/claude-code) that displays model info, token usage, rate limits, and reset times in a single compact line. It runs as an external shell command, so it does not slow down Claude Code or consume any extra tokens.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Claude Code Status Line

A custom status line for [Claude Code](https://claude.com/claude-code) that displays model info, token usage, rate limits, and reset times in a single compact line. It runs as an external shell command, so it does not slow down Claude Code or consume any extra tokens.

Screenshot

What it shows

Segment Description
Model Current model name (e.g., Opus 4.6)
CWD@Branch Current folder name, git branch, and file changes (+/-)
Tokens Used / total context window tokens (% used)
Effort Reasoning effort level (low, med, high)
5h 5-hour rate limit usage percentage and reset time
7d 7-day rate limit usage percentage and reset time
Extra Extra usage credits spent / limit (if enabled)
Update Clickable link when a new version is available (checked every 24h)

Usage percentages are color-coded: green (<50%) → yellow (≥50%) → orange (≥70%) → red (≥90%).

Requirements

macOS / Linux

  • jq — for JSON parsing
  • curl — for fetching usage data from the Anthropic API
  • Claude Code with OAuth authentication (Pro/Max subscription)

Windows

  • PowerShell 5.1+ (included by default on Windows 10/11)
  • git in PATH (for branch/diff info)
  • Claude Code with OAuth authentication (Pro/Max subscription)

Installation

Quick setup (recommended)

Copy the contents of `statusline.sh` (or `statusline.ps1` on Windows) and paste it into Claude Code with the prompt:

Use this script as my status bar

Claude Code will save the script and configure `settings.json` for you automatically.

Manual setup — macOS / Linux

  1. Copy the script to your Claude config directory:

    cp statusline.sh ~/.claude/statusline.sh
    chmod +x ~/.claude/statusline.sh
  2. Add the status line config to `~/.claude/settings.json`:

    {
      "statusLine": {
        "type": "command",
        "command": "~/.claude/statusline.sh"

...