Claude Code Statusline

Free

Transform your Claude Code terminal with atomic precision statusline. Features flexible layouts, real-time cost tracking, MCP monitoring, prayer times, and beautiful themes.

FreeFree tier

#Shell

Type

Saas

Visit Website GitHub (439 stars)

About Claude Code Statusline

Claude Code Statusline is an open-source, highly customizable terminal statusline for Claude Code sessions. It offers 28 atomic components that can be arranged across 1 to 9 configurable lines. Key capabilities include real-time cost tracking (burn rate, cost projections), cache efficiency monitoring, MCP (Modal Context Protocol) integration, block metrics, and Islamic prayer times. The tool supports beautiful themes (e.g., Catppuccin Mocha) and provides atomic precision with clean separators. It is cross-platform (macOS, Linux, Windows via WSL) and requires jq and curl for installation. The repository includes installation scripts, thorough documentation, and examples for rapid setup.

Key Features

28 atomic components for granular status information

1 to 9 configurable lines for flexible layouts

Real-time cost tracking (burn rate, cost projections)

Cache efficiency monitoring

MCP (Modal Context Protocol) integration

Islamic prayer times display

Customizable themes including Catppuccin Mocha

Block metrics and clean separators

Cross-platform support (macOS, Linux, Windows WSL)

Pros & Cons

Pros

100% free and open source (MIT license)
Highly customizable with 28 atomic components
Real-time cost and performance monitoring
Cross-platform: macOS, Linux, Windows via WSL
Easy installation via quick install script
Beautiful preset themes available
Active community and documentation

Cons

Requires jq and curl dependencies
Windows support requires WSL
Limited to Claude Code terminal (not a generic terminal statusline)
Manual security inspection recommended before running install script

Best For

Monitoring API costs and token usage during Claude Code developmentEnhancing terminal productivity with real-time metricsAdding Islamic prayer time notifications within the terminalCustomizing the Claude Code terminal appearance with themesTracking MCP tool performance and cache efficiency

FAQ

What are the platform requirements?

100% compatible across all major platforms: macOS (12+), Ubuntu/Debian, Arch Linux, Fedora/RHEL, Alpine Linux, and Windows via WSL with Ubuntu distribution. Requires jq and curl.

How do I install Claude Code Statusline?

The recommended method is to download the installer script, review it for safety, then run it. The script only creates files in ~/.claude/statusline/ and downloads from the GitHub repo. A one-line install is also available.

Is this tool safe to run?

Yes, the installer script is open for review. It only creates directories in ~/.claude/, downloads files from the official GitHub repo, does not use sudo or modify system files, and uses proper GitHub raw URLs with no external network calls.

Can I customize the layout?

Yes, the statusline supports 1-9 configurable lines with 28 atomic components, allowing you to arrange metrics like cost, cache, MCP, and prayer times as desired.