Claude Code Statusline

> Ridiculously simple. Surprisingly rich.

💡 What You Get

More context in Claude Code's statusline: directory, git status, file changes, model, context usage with progress bar, and cost — all visible at once.

Install with one command. Works immediately. Configure when you need it.

✨ Quick Install

macOS / Linux / WSL

curl -fsSL https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.sh | bash

Windows — PowerShell

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.ps1)))

Custom install directory

Override where the binary and config are installed (default: ~/.claude):

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.sh | bash -s -- --install-dir /custom/path

# Windows — PowerShell
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.ps1'))) -InstallDir "C:\Custom\Path"

Install a specific version

To install a specific release (e.g. for testing an unstable build):

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.sh | bash -s -- --version v1.1.0-dev.6f31b35

# Windows — PowerShell
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.ps1'))) -Version v1.1.0-dev.6f31b35

Both parameters can be combined:

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.sh | bash -s -- --install-dir /custom/path --version v1.1.0-dev.6f31b35

# Windows — PowerShell
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/glauberlima/claude-code-statusline/main/install.ps1'))) -InstallDir "C:\Custom\Path" -Version v1.1.0-dev.6f31b35

Release tags are listed on the GitHub releases page.

Features

• 📁 Directory name
• 🌿 Git branch
• ✏️ File changes
• 🤖 Model name
• 📊 Context usage with progress bar and funny messages
• 💰 Cost tracking

⚙️ Configuration

Edit ~/.claude/statusline.toml to customize features. Generate the default config:

macOS / Linux / WSL

~/.claude/statusline --print-defaults > ~/.claude/statusline.toml

Windows — PowerShell

& "$env:USERPROFILE\.claude\statusline.exe" --print-defaults | Set-Content "$env:USERPROFILE\.claude\statusline.toml"

Available options: cost, messages, messages_language (en/pt/es), usage_bar_style (plain/rainbow/gradient/gsd).

🛠️ Development

Testing

cargo test

Contributing

1. Fork and create a feature branch
2. Make changes and run tests
3. Submit a pull request

See CLAUDE.md for architecture details and development commands.

Inspirations

• Fatih Arslan
• Frank Dilo

License

MIT License