# Install

> Install the cosmobar status line for Claude Code — downloads the binary and runs guided setup. Use when the user wants to install or set up cosmobar for the first time (when it is not yet installed).

- Skill: `oleksbard/install` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oleksbard/install`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oleksbard/install/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oleksbard (https://skillmd.com/u/oleksbard)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oleksbard/install

---


# Install cosmobar

Install the cosmobar status line and walk the user through setup. cosmobar is a single static Go binary (macOS/Linux). Follow these steps in order.

## Steps

1. **Check whether it's already installed.** Run `command -v cosmobar`.
   - If found: tell the user cosmobar is already installed, run `cosmobar upgrade --check` to report whether a newer release exists, and skip to step 5 (offer to configure). Do **not** re-download.

2. **Install the binary.** Run the official installer:
   ```
   curl -sS https://raw.githubusercontent.com/oleksbard/cosmobar/main/install.sh | sh
   ```
   The user will see the normal Bash permission prompt for this command — that is expected and intentional. Show the installer's output. If the download fails (network error, non-zero exit), report the failure and give the user the same `curl … | sh` command to run themselves, then stop.

3. **Verify the install.** Run `cosmobar --version`.
   - If it prints a version, continue.
   - If it reports "command not found", the binary was installed to `~/.local/bin`, which is not on the user's `PATH`. Tell the user to add it (`export PATH="$HOME/.local/bin:$PATH"` in their shell profile) and, for the next step, use the full path `~/.local/bin/cosmobar`.

4. **Initialize.** Run `cosmobar init` (or `~/.local/bin/cosmobar init` if it wasn't on `PATH`). This wires `~/.claude/settings.json`, writes a default config to `~/.config/cosmobar/config.toml`, and installs the `/cosmobar` guided-setup skill.

5. **Hand off to guided setup.** The `/cosmobar` skill is now available. Continue directly into the cosmobar guided configuration (discover segments and themes, interview the user, apply) so install and configuration happen in one flow.

## Notes
- macOS/Linux only.
- Everything is reversible: `cosmobar uninstall` removes the wiring (add `--purge` to also delete the config and binary).