<div align="center"
<pre | | | | | () / / / | / | | | | / | | | ' \ / \ | (| (\ \ || (| | || || \ \ | | | | | / \\|/\\,|\|\,|/||| ||\|
</pre
ccstatusline
🎨 A highly customizable status line formatter for Claude Code CLI Display model info, git branch, token usage, and other metrics in your terminal
</div <br /
📚 Table of Contents
- Recent Updates
- Features
- Localizations
- Quick Start
- Windows Support
- Usage
- Development
- Contributing
- License
- Related Projects
<br /
🆕 Recent Updates
v2.2.27 - Portable configuration import and export
- 📦 Config import/export - Export the current TUI configuration to JSON, validate and preview imports, then replace all settings or merge only supplied fields while preserving local installation metadata and leaving the result unsaved for review.
v2.2.25 - v2.2.26 - Fable usage, migrated usage API support, compaction accuracy, and rendering reliability
- 🪄 Weekly Fable usage - Added a Weekly Fable Usage widget with percentage, progress-bar, remaining-mode, and time-cursor controls.
- 📊 Reshaped usage API support - Session and all-model weekly usage can fall back to the newer limits[] response, while Sonnet, Opus, and Fable weekly widgets read authoritative weeklyscoped entries so migrated accounts do not show stale or frozen values.
- 🧠 Correct post-compaction context - Context length and percentage widgets reset immediately from compactboundary.postTokens after /compact, then switch to the first new turn instead of retaining the pre-compaction size.
- 🧹 Reliable hidden-widget separators - Manual separators now look past widgets that render empty, preserve the intended visible boundary, and inherit colors from the actual preceding visible widget.
- ⚡ Non-blocking Git PR/CI refreshes - Git PR and CI widgets render from a versioned disk cache while stale data refreshes in the background, preventing slow gh calls from blocking the status line.
v2.2.22 - v2.2.24 - Powerline flex mode, cache/CI/sandbox visibility, layout controls, composable metrics, and safer config
- ⏳ Prompt cache timer - Added a Cache Timer widget with live HOT state, TTL countdown, configurable 5-minute/1-hour windows, and customizable state glyphs.
- ✅ GitHub CI status - Added a Git CI Status widget that summarizes failing, pending, and successful checks for the current branch's pull request.
- 🔒 Sandbox status - Added a Sandbox Status widget with glyph, text, and Nerd Font formats that follows Claude Code's layered sandbox setting on each refresh.
- ↔️ One-sided default padding - Default widget padding can now apply to both sides, the left only, or the right only in standard and Powerline layouts.
- ⚡ Powerline flex mode - Flex separators now work in Powerline mode, letting Powerline status lines right-align content or absorb available width.
- 🌗 Per-widget dim styling - The color editor can dim an entire widget or only parenthesized text, with reset and clear-all actions covering dim state.
- 🧯 Safer settings recovery - Invalid settings.json files are left untouched, defaults render in memory, and the status line shows an invalid-config warning.
- 🧭 Selective Powerline alignment - Press x in the line editor to let a widget and the rest of its line keep their natural widths while earlier Powerline columns stay auto-aligned.
- 📏 Git widget width limits - Git Branch and Git Root Dir can cap their visible width with ellipsis-safe truncation while preserving hyperlink targets.
- 🔣 Current directory glyphs - Current Working Dir can prepend an optional custom glyph, including in raw-value mode.
- 🧠 Configurable context fallback - CCSTATUSLINECONTEXTSIZEFALLBACK overrides the default 200k last-resort context window when Claude Code and the model name do not report one.
- 🧩 Composable compaction metrics - Compaction Counter can render count, auto, manual, unknown, or reclaimed-token values independently for custom layouts.