Claude Code Status Line

A beautiful, configurable status line for Claude Code that displays workspace info, git status, model name, context usage, worktree and added-directory scope hints, quota limits with timers, and optional API costs.

🌐 Visit the official site for easy installation

✨ Features

• 📊 Rich Information Display - Working directory, git branch, model name, context usage, worktree/scope hints, quota tracking (5h/7d)
• 🎨 Fully Customizable - Per-section colors, Powerline arrows or custom separators, multiline mode
• 📱 Responsive Design - Automatically drops low-priority sections on narrow terminals
• 🔐 Secure Token Management - macOS Keychain, system keyring, or environment variables
• 🚀 Easy Installation - One-line installer for all platforms (macOS, Linux, Windows)

🚀 Quick Start

Install the automated installer with one command:

macOS / Linux:

mkdir -p ~/.claude/commands && curl -o ~/.claude/commands/install-statusline.md https://raw.githubusercontent.com/ndave92/claude-code-status-line/master/.claude/commands/install-statusline.md

Windows (PowerShell):

New-Item -Path "$env:USERPROFILE\.claude\commands" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ndave92/claude-code-status-line/master/.claude/commands/install-statusline.md" -OutFile "$env:USERPROFILE\.claude\commands\install-statusline.md"

Then restart Claude Code and run:

/install-statusline

If the statusline does not appear after installation, make sure Claude Code trusts the workspace. Recent Claude Code versions will not execute custom statusLine commands until the workspace is trusted.

For the richest Claude Code integration, use Claude Code 2.1.69+ for worktree metadata and 2.1.47+ for /add-dir scope hints. Claude project config and auto-memory can be shared across git worktrees, while the statusline keeps its own user config in ~/.claude/statusline/.

📚 Documentation

• 🌐 Official Site - Quick install and overview

Complete documentation is available in the GitHub Wiki:

• 📦 Installation Guide - All installation methods
• ⚙️ Configuration Reference - Complete config options
• 🎨 Customization Examples - Themes and styling
• 🔧 Troubleshooting - Common issues and solutions
• ⚠️ Known Issues - Limitations and platform notes
• 🔄 Updating - How to upgrade
• 💻 Development - Contributing and building from source

🆘 Quick Help

Customize settings:

/customize-statusline

Update to latest version:

/update-statusline

Uninstall completely:

/uninstall-statusline

Check version:

claude-code-status-line --version

Configuration files:

• ~/.claude/statusline/settings.json - Feature toggles and settings
• ~/.claude/statusline/colors.json - Color customization

Quota behavior:

• The statusline caches quota for 60 seconds by default to avoid usage-endpoint rate limits
• Set sections.quota.cache_ttl lower only if you explicitly want more aggressive quota polling

⚠️ Known Issues

• Notification overlap - Claude Code notifications may obstruct the statusline
• Powerline characters - Require special fonts; not supported in default terminals

See Known Issues for details and workarounds.

🤝 Contributing

Contributions are welcome! Please see the Development Guide in the wiki.

📄 License

MIT License - see LICENSE file for details.

Made with ❤️ for the Claude Code community