cyberneticlibrary
← library

Format Claude Code status lines

ccstatuslineskillsetup L1★0
sirmalloc/ccstatusline ↗
What it does

Format Claude Code terminal status line with customizable widgets

Best for

Displaying live Claude Code usage, git status, and model info in a single terminal line, with persistent git caching to avoid repeated subprocess work.

Inputs
  • · Widget configuration (ccstatusline.config.json)
  • · Optional: terminal width override (CCSTATUSLINE_WIDTH)
Outputs
  • · Custom status line string
  • · Cached git output (git-cache/)
  • · Model info, usage, branch, timer widgets
Requires
  • · Git (with --no-optional-locks)
  • · Claude Code API
  • · Ollama (optional)
  • · Nerd Fonts (optional)
Preconditions
  • · ccstatusline installed globally or pinned
  • · Claude Code >= 2.1.97 (for refresh interval support)
  • · Terminal width auto-detectable or override provided
Failure modes
  • · Git command hangs (.git/index.lock race)
  • · Terminal width detection fails
  • · Nerd Font fallback missing characters
  • · Model info API unavailable
Trust signals
  • · Version pinning support documented
  • · Git lock avoidance (--no-optional-locks) implemented
  • · Cache TTL configurable with .git mtime checks