stephenleo/cship

⚡ A beautiful, fully customizable statusline for Claude Code - Starship-style TOML config, themeable colours, Nerd Font glyphs, and tunable cost/context/usage thresholds.

What it solves

CShip provides a highly customizable, live statusline for Claude Code sessions. It solves the problem of lacking visibility into real-time session metrics—such as cost, context window usage, and API limits—directly within the terminal interface.

How it works

Written in Rust for high performance (rendering in under 10ms), CShip integrates with Claude Code's live JSON feed. It parses this data and renders a statusline based on a TOML configuration file. It also supports "Starship Passthrough," allowing users to embed standard Starship prompt modules (like git branch or directory) alongside native CShip metrics.

Who it’s for

Developers using Claude Code who want a visual, real-time dashboard of their AI session's resource consumption and environment status.

Highlights

  • Real-time Session Insights: Tracks session cost, context window usage, model name, and API limits.
  • Customizable Thresholds: Set custom colors for "warn" and "critical" states based on cost or usage percentages.
  • Starship Integration: Embed any Starship module directly into the statusline.
  • High Performance: Built in Rust to ensure minimal latency during rendering.
  • Flexible Styling: Supports Nerd Font glyphs and hex color codes for deep theme customization.

Related

  • Project
  • Project
  • Project
  • Project
  • Project