Introduction
The Statusline Editor for Claude Code is a visual configuration tool designed to simplify the customization of the Claude Code terminal interface.
By default, Claude Code provides raw data about your session via JSON. This editor allows you to transform that data into a high-density, color-coded statusline without writing complex Bash scripts or manually handling ANSI escape codes.
Overview
The editor provides a web-based GUI where you can drag, drop, and style functional "blocks" to build your ideal terminal HUD. Once configured, the tool generates a portable Bash script that you can plug directly into your Claude Code settings.
Key Capabilities
- Visual Configuration: Toggle and reorder status segments like Model name, Token counts, and Context usage.
- Intelligent Thresholds: Automatically change colors based on context window usage (e.g., green at 30%, red at 80%).
- Usage Monitoring: Integrated blocks for tracking your 5-hour and Weekly Anthropic API usage limits, including "time until reset" countdowns.
- Real-time Preview: A live-updating terminal mock-up that supports both Dark and Light UI themes.
- Git Integration: Display the current working directory and active Git branch status.
How it Works
The generated script acts as a middleware between Claude Code and your terminal.
- Input: Claude Code passes a JSON object to the script via
stdinon every prompt. This object contains metadata about the current model, token counts, and context window. - Processing: The script uses
jqto parse the JSON andpython3to perform time-based calculations for rate limits. - Output: The script prints a single line of formatted text using ANSI 256-color codes, which Claude Code displays at the bottom of the terminal.
Core Blocks
| Block | Description |
| :--- | :--- |
| Model | Displays the active Claude model (e.g., Sonnet 4.6). |
| Context % | Shows how much of the context window is full, with custom color thresholds. |
| Rate Limits | Displays a visual progress bar and percentage for your 5h/Weekly usage. |
| Tokens | Tracks input and output tokens consumed in the current session. |
| Directory | Displays the current path and Git branch status. |
System Requirements
To use the generated statusline script, your environment must have:
- Bash: The shell environment (Linux, macOS, or Windows via Git Bash/WSL).
- jq: A lightweight command-line JSON processor.
- python3: Used for calculating usage reset times and token formatting.
- Credential Manager: For Rate Limit blocks, the script requires access to your local credential store (Keychain on macOS,
libsecreton Linux, or PowerShell Credential Manager on Windows) to securely retrieve the Anthropic access token.
Getting Started
No installation or server is required to use the editor.
- Open
index.htmlin any modern web browser. - Arrange and style your blocks in the Editor panel.
- Copy the generated code from the Output panel.
- Follow the Setup Guide to link the script to your
~/.claude/settings.json.