cship

⚓ CShip (pronounced "sea ship")

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

cship renders a live statusline for Claude Code sessions, showing session cost, context window usage, model name, API usage limits, and more — all configurable via a simple TOML file.

Key features:
- 🎨 Fully Customizable: Configure every module with Starship-compatible TOML. Colors, symbols, thresholds — your statusline, your rules.
- ⚡ Blazing Fast: Written in Rust with a ≤10ms render budget.
- 🔌 Starship Passthrough: Embed any Starship module (git_branch, directory, language runtimes) right next to native CShip modules.
- 💰 Session Insights: Track cost, context window usage, API limits, vim mode, agent name, and more — all from Claude Code's live JSON feed. Implement custom warn and critical thresholds with custom colors for each.

🚀 Install

⚡ Method 1a: curl installer (macOS / Linux)

Auto-detects your OS and architecture (macOS arm64/x86_64, Linux x86_64/aarch64), downloads the binary to ~/.local/bin/cship, creates a starter config at ~/.config/cship.toml, and wires the statusLine entry in ~/.claude/settings.json.

Optional dependencies (Starship for passthrough modules, and libsecret-tools on Linux for usage limits) are handled as follows:

- Interactive terminal — the installer prompts you for each.
- --yes / -y — auto-installs all optional deps without prompting:

- Non-interactive (Docker RUN, CI pipelines, no TTY) — optional deps are skipped automatically; the installer prints instructions for manual installation.

🪟 Method 1b: PowerShell installer (Windows)

Run this one-liner in PowerShell (5.1 or later):

Installs to…