claudeers.
// Developer Tools

ClaudeCodeStatusLine

Custom status line for Claude Code showing model, tokens, rate limits, and git info in real-time

// Developer Tools[ cli ][ api ][ web ][ claude ]#claude#anthropic#claude-code#cli#developer-tools#powershell#rate-limiting#shell#devtools◷ MIT$open-sourceupdated 2 months ago
Slowing down
84/100
last commit 3 months ago
last release 3 months ago
releases 8
open issues 5
// star history+4 this week (+0.7%)
★ 593 github ↗website ↗

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up ClaudeCodeStatusLine (release-binary project) into my current project.
Found on https://claudeers.com/claudecodestatusline
Repo: https://github.com/daniel3303/ClaudeCodeStatusLine
Homepage/docs: https://danielapoliveira.com
Detected install method: release-binary → inspect the README
Category: devtools. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
slowing; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/daniel3303/ClaudeCodeStatusLine/releases
// or clone
git clone https://github.com/daniel3303/ClaudeCodeStatusLine

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageShell

Claude Code Status Line

A custom status line for 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

Status Line Screenshot

What it shows

SegmentDescription
ModelCurrent model name (e.g., Opus 4.7)
CWD@BranchCurrent folder name, git branch, and file changes (+/-)
TokensUsed / total context window tokens (% used)
EffortReasoning effort level (low, med, high, xhigh)
5h5-hour rate limit usage percentage and reset time
7d7-day rate limit usage percentage and reset time
ExtraExtra usage credits spent / limit (if enabled)
UpdateAppears when a new version is available (checked every 24h)

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

Installation

Ask Claude Code:

Clone https://github.com/daniel3303/ClaudeCodeStatusLine to ~/.claude/statusline/ (or %USERPROFILE%\.claude\statusline\ on Windows) and configure it as my status bar by following its INSTALL.md.

Claude will clone the repo to that path, pick the right script for your OS, and update settings.json. Full step-by-step instructions Claude follows live in INSTALL.md.

Restart Claude Code after Claude saves the configuration.

Updating

When the status line shows a new release is available, ask Claude:

Find my installed status bar and update it.

Or update it yourself:

git -C ~/.claude/statusline pull

No settings.json changes are needed — the path stays valid across versions.

Requirements

  • Claude Code with OAuth authentication (Pro/Max subscription for rate-limit and extra-usage data)
  • git in PATH
  • macOS / Linux: jq and curl
  • Windows: PowerShell 5.1+ (default on Windows 10/11)

Caching

Usage data from the Anthropic API is cached for 60 seconds at /tmp/claude/statusline-usage-cache-<hash>.json (or %TEMP%\claude\... on Windows). Release checks are cached for 24 hours. Both caches are shared across concurrent Claude Code instances to avoid rate limits.

Update Notifications

The status line checks GitHub for new releases once every 24 hours via an outbound HTTP request to api.github.com. When a newer version is available, a second line appears below the status line. The check fails silently if the API is unreachable.

To disable the update check entirely (no network calls):

export STATUSLINE_CHECK_UPDATES=false

License

MIT

Author

Daniel Oliveira

// faq

What is ClaudeCodeStatusLine?

Custom status line for Claude Code showing model, tokens, rate limits, and git info in real-time. It is open-source on GitHub.

Is ClaudeCodeStatusLine free to use?

ClaudeCodeStatusLine is open-source under the MIT license, so it is free to use.

What category does ClaudeCodeStatusLine belong to?

ClaudeCodeStatusLine is listed under devtools in the Claudeers registry of Claude-compatible tools.

0 views
★ 593 stars
unclaimed
updated 2 months ago

// embed badge

ClaudeCodeStatusLine on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claudecodestatusline.svg)](https://claudeers.com/claudecodestatusline)

// retro hit counter

ClaudeCodeStatusLine hit counter
[![Hits](https://claudeers.com/api/counter/claudecodestatusline.svg)](https://claudeers.com/claudecodestatusline)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓
ECC

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 240,305◷ MIT[ claude ]
🔓
gstack

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 128,278◷ MIT[ claude ]
🔓
graphify

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 109,277◷ MIT[ claude ]
🔓
ponytail

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 104,762◷ MIT[ claude ]
→ see how ClaudeCodeStatusLine connects across the ecosystem