Claude Code Status Line

A beautiful, configurable status line for Claude Code that displays workspace info, git status, model name, context usage, 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, 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

📚 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

⚠️ Known Issues

• Notification overlap - Claude Code notifications may obstruct the statusline
• Powerline characters - Require special fonts; not supported in default terminals
• Context value differences - May differ from /context due to different data sources

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