oleksbard/cosmobar

cosmobar

<p align="center"> <img src="assets/cosmobar.png" alt="cosmobar mascot" width="160" height="160"> </p>

A fast, dependency-light, starship-inspired status line for Claude Code.

• Single static Go binary — no runtime, no jq, no Nerd Font required
• Themed segments: context gauge, git status, cost, model, clock, and more
• TOML config, instant local preview, one-command self-update

<p align="center"> <img src="assets/gallery.png" alt="cosmobar preview --gallery showing the coral/lean, nord/tick, catppuccin/blocks, and gruvbox/blocks presets"> </p>

Install

curl -sS https://raw.githubusercontent.com/oleksbard/cosmobar/main/install.sh | sh
cosmobar init

init wires cosmobar into ~/.claude/settings.json, writes a default config to ~/.config/cosmobar/config.toml, and installs the guided-setup skill. Restart Claude Code (or send a message) to see the status line.

From inside Claude Code

cosmobar also ships as a Claude Code plugin (macOS/Linux):

/plugin marketplace add oleksbard/cosmobar
/plugin install cosmobar@cosmobar

Then say "install cosmobar" (or run /cosmobar:install) — Claude downloads the binary, wires it in, and walks you through setup, no shell command to copy.

Configure

Run /cosmobar in Claude Code (or just ask "set up cosmobar") for guided setup, or edit ~/.config/cosmobar/config.toml directly:

theme            = "coral"            # coral | catppuccin | nord | gruvbox
order            = ["dir", "git", "model", "context", "cost", "clock"]
separator        = " · "
max_rows         = 2
gauge_width      = 8
gauge_thresholds = [70, 90]
glyphs           = "auto"             # auto | unicode | ascii
style            = "lean"             # lean | tick | blocks
block_caps       = "soft"             # soft | square  (blocks style only)

[clock]
format = "24h"                        # 24h | 12h | off

[dir]
style = "basename"                    # basename |