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.

✨ 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

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
• 🔄 Updating - How to upgrade
• 💻 Development - Contributing and building from source

🆘 Quick Help

Update to latest version:

/update-statusline

Check version:

claude-code-status-line --version

Configuration files:

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

Note: The arrow field in settings.json contains a Powerline character (U+E0B0) that may display as a box or question mark in text editors without Powerline fonts. This is normal and doesn't affect functionality. See Configuration Reference for details.

🤝 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