sirmalloc/ccstatusline
Ccstatusline
ccstatusline is a CLI status bar framework and ANSI terminal UI library used to render dynamic, multi-line interfaces within terminal emulators. It functions as a customizable system for displaying real-time metrics, system data, and configuration settings through a widget-based composition model.
The framework specializes in Powerline-style status lines, utilizing arrow separators and columnar alignment to create structured headers. It includes specialized dashboards for monitoring Git repository metadata, such as branch names and commit IDs, as well as LLM usage monitors that track API token consumption, session costs, and prompt cache hit rates.
The library handles visual styling via hex colors and ANSI gradients, while managing responsive layouts through dynamic terminal width detection. It employs a state-driven layout system to organize, reorder, or hide modular widgets based on active data and periodic poll-based refreshes.
Features
- Powerline Styling - Constructs Powerline-style status lines using interlocking glyphs and arrow-shaped separators.
- ANSI Color Rendering - Translates hex colors and style definitions into ANSI escape sequences to create gradients and highlighted visual elements.
- Dynamic Width Detection - Implements dynamic terminal width detection to recalculate content alignment and separator spacing during render cycles.
- ANSI Escape Sequence Renderers - Translates hex codes and styles into ANSI escape sequences for terminal color rendering.
- Screen Composition Widgets - Assembles the status line by chaining modular widgets that manage their own data and formatting.
- ANSI Terminal UI Libraries - Provides a library for rendering dynamic content with hex colors, gradients, and adaptive layouts.
- Terminal Status Lines - Provides a customizable status bar framework for displaying real-time metrics within the terminal.
- Terminal UI Layouts - Arranges console output into structured multi-line displays with dynamic width adjustment.
- Widget Layout Management - Provides a state-driven system to organize, reorder, and conditionally hide modular widgets within the status line.
- LLM Usage Metrics - Tracks token consumption, latency, and financial costs for LLM API integrations.
- Repository State Monitoring - Monitors root paths and head status to display branch names and commit IDs in the status line.
- Real-Time Status Displays - Displays real-time Git branch names, commit IDs, and file change counts.
- Git Status Indicators - Displays version control state and branch information as visual indicators in the terminal.
- Model Inference Metrics - Visualizes resource usage and prompt cache hit rates for LLM API calls.
- Usage Monitors - Tracks and displays current consumption of AI model quotas, billing windows, and usage limits.
- Real-Time Session Monitors - Provides real-time monitoring of model names, token counts, and session costs.
- Periodic Refreshers - Implements periodic refreshers to update metrics and version control status at set intervals.
- Window Dimension Polling - Recalculates content alignment by polling current terminal window dimensions during each render cycle.
- Data-Driven Layouts - Determines widget visibility and layout based on active data and configuration flags.
