Claude Code Statusline

English | 简体中文

PyPI MIT License

A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reasoning effort, directory, Git, context, usage limits, tokens, and task timing at a glance. Configure the main line and individual subagent rows through an in-session editor, a terminal UI, a wizard, or the CLI.

Features · Screenshots · Quick installation · Common configuration · User guide · Troubleshooting

Features

• Choose what to show: 60 main-line items and 14 subagent items; enable, hide, search, and reorder them.
• Track the right scope: session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
• Adjust presentation: model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
• Start from a preset: minimal, developer, monitoring, and multi-agent presets expand into editable settings; import and export portable JSON.
• Choose an editor: Main, Subagents, Settings, and Layout pages share the same configuration. Claude appearance and behavior preferences use a separate Apply action.
• Enable optional live metrics: runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.

Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See field definitions for data sources and availability.

Screenshots

The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. Image sources and archive.

In-session TUI

Run /statusline-configure-native inside the current Claude Code session, then click the Client region once before using the keyboard.

Linux: Main and the status line

External TUI

Run /statusline-configure in Claude Code, or claude-statusline configure in a standalone terminal.

Earlier screenshots and terminal reconstructions remain in the archive.

Supported platforms

Windows ARM devices can use x64 Python emulation; native ARM64 Python is outside the current support contract. Git information requires git.

Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See requirements.

Quick installation

Install Python, Claude Code CLI, and pipx. All supported platforms use the same wheel.

Install the package

Bash, Zsh, and PowerShell:

pipx install fbincon-claude-code-statusline
pipx ensurepath

Integrate with Claude Code

Reopen the terminal so PATH changes take effect, then run:

claude-statusline --version
claude-statusline install --dry-run
claude-statusline install
claude-statusline doctor

On Windows, use claude-statusline.exe. Restart Claude Code in a trusted terminal after integration.

Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing metadata defaults on for Claude Code 2.1.289+; advanced live metrics remain opt-in. Package installation and Claude integration are separate steps; install does not open an editor. Existing conflicting resources require explicit handling.

pipx install "git+https://github.com/fbincon/claude-code-statusline.git@main"

Common configuration

Native configuration editor

Click the Client region once. Use Tab to change pages, Space to toggle, arrows to select or reorder, Ctrl+E for item formatting, and / to search. S saves and stays, F saves and closes, and Q discards unsaved changes; lowercase letters work too. Footer controls follow the current page or input mode. Ctrl+G cancels input. Claude preferences apply separately.

External and standalone terminal TUI

Use Tab to change pages, Space to toggle, and arrows to select or reorder. Ctrl+S saves after field input is finished; Enter saves on item and original settings rows, or edits/confirms advanced fields. Esc cancels input first, then cancels the editor; Ctrl+C interrupts without saving. The minimum terminal size is 64×18.

The external entry uses tmux or GNOME Terminal on Linux, tmux or Terminal.app on macOS, and the system's new-console launcher on Windows. For SSH or unavailable launchers, run claude-statusline configure in the current terminal.

Define a compact main line:

claude-statusline config set-items model-with-effort current-dir git context-remaining task-timer
claude-statusline config set directory-style home
claude-statusline config show

Configuration is per user. set-items replaces the enabled set; enable and disable make incremental changes. See recipes, formatting and layouts, and the CLI reference.

Upgrading and uninstalling

Upgrade the package, synchronize integration, then restart Claude Code:

pipx upgrade fbincon-claude-code-statusline
claude-statusline install
claude-statusline doctor

Existing wheel installations from this repository should first follow the package-name migration. Saved display settings, runtime state, and integration preferences remain. For older display schemas or package downgrade, follow version compatibility.

Remove Claude integration before uninstalling the package:

claude-statusline uninstall --dry-run
claude-statusline uninstall
pipx uninstall fbincon-claude-code-statusline

Display settings and backups remain available; see uninstalling.

Project structure

claude-code-statusline/
├── .github/workflows/
│   ├── ci.yml
│   ├── native.yml
│   └── publish.yml
├── README.md / README.zh-CN.md
├── CHANGELOG.md / CHANGELOG.zh-CN.md
├── LICENSE
├── MANIFEST.in
├── pyproject.toml
├── docs/
│   ├── USER_GUIDE.md / USER_GUIDE.zh-CN.md
│   ├── reference/                  # CLI and configuration reference
│   ├── images/                     # Current screenshots and archive
│   │   ├── tui/
│   │   │   ├── native/
│   │   │   └── external/
│   │   └── archive/
│   ├── development/                # Setup, architecture and validation
│   └── releases/                   # Historical release notes
├── src/
│   ├── build_native.py
│   └── claude_statusline/
│       ├── config/
│       ├── integration/
│       ├── platforms/
│       ├── rendering/
│       ├── runtime/
│       │   ├── live/
│       │   ├── tasks/
│       │   ├── timing/
│       │   └── turns/
│       ├── resources/
│       └── ui/
├── mods/
│   ├── statusline-native/
│   └── statusline-runtime/
├── tests/
│   ├── config/
│   ├── integration/
│   ├── platforms/
│   ├── rendering/
│   ├── runtime/
│   └── ui/
└── tools/
    ├── inspect_dist.py
    ├── publish_package.py
    └── check_docs.py

Documentation and help

• User guide: installation, editors, recipes, upgrades, and troubleshooting.
• CLI reference: commands, options, fields, files, and exit codes.
• Display items and metric definitions: scope, sources, and availability.
• Development guide · Release process.
• Changelog · GitHub Releases.
• GitHub Issues: include versions, reproduction steps, and diagnostic results; remove private paths and session content.

License

MIT License. Copyright (c) 2026 fbincon.