/pulse

Configure your Claude status bars — themes, colours, animations, widgets, and more. $ARGUMENTS

---

**Finding the script:** Before running any command below, you need the full path to `claude_status.py`. Do this ONCE at the start:

1. Read `~/.claude/settings.json`. If `statusLine.command` contains `claude_status.py`, extract the full script path from that string. 2. If not found, use the Glob tool to search for `**/claude_status.py` inside `~/.claude/plugins/` — pick the result containing `claude-pulse`. 3. If neither works, tell the user: "Run `/claude-pulse:setup` first to install the status bar."

Save the found path as SCRIPT_PATH. Use `python "SCRIPT_PATH"` for all commands below.

---

ROUTING — decide what to do based on $ARGUMENTS

Direct commands (skip the menu, run immediately):

If $ARGUMENTS matches a **theme name** (`default`, `ocean`, `sunset`, `mono`, `neon`, `pride`, `frost`, `ember`, `candy`, `rainbow`): -> Run `python "SCRIPT_PATH" --theme <name>` directly, no menu. -> Confirm: "Theme set to **<name>**. The status line will update on the next refresh."

If $ARGUMENTS is `pick`, `picker`, or `pick-theme`: -> This is the **live arrow-key theme picker**: one screen, scroll through all 10 themes, and the status-bar preview recolours live. It needs an interactive terminal, so the **user must launch it themselves** — you cannot drive the keypresses for them. -> Tell the user to type this in their prompt to launch it: `!python "SCRIPT_PATH" --pick-theme` -> Explain the controls in one line: "↑/↓ (or j/k) to move · Enter to keep · Esc to cancel — your bar recolours live as you move." -> Add the fallback note: "If you see a static coloured list instead of a moving cursor, this terminal isn't interactive here — just note the name you like and run `/pulse <name>`."

If $ARGUMENTS is `config` or `settings`: -> Run `python "SCRIPT_PATH" --config` silently. -> Summarise the settings in your response text (don't show raw ANSI output).

If $ARGUMENTS is exactly `show` (no parts after it), or `show all`, or `colors`, or `colours`, or `preview`: -> Run TWO separate Bash commands (in parallel): 1. `python "SCRIPT_PATH" --show-themes` 2. `python "SCRIPT_PATH" --show-colors` -> Show the raw output to the user (coloured ANSI text with live previews). -> After both commands, say ONLY: "Press **Ctrl+O** to expand and see the colours."

If $ARGUMENTS contains `hide <parts>` or `show <parts>` (with specific parts): -> Run the corresponding `--hide` or `--show` command directly. -> Valid parts: session, weekly, context, timer, weekly_timer, cost, model, branch, heartbeat, activity, update, claude_update, opus, sonnet, effort, worktree, pomodoro, context_warning, staleness, plan, extra, burn_rate, sessions, last_tool, sparkline, runway, status_message, streak, pace, git_drift, files_changed

If $ARGUMENTS matches `animate <mode>` (where mode is `off`, `rainbow`, `pulse`, `glow`, `shift`, `on`): -> Run `--animate <mode>` directly. -> Explain what the mode does:

• **off** — Static, no animation
• **rainbow** — Flowing rainbow gradient across the entire bar
• **pulse** — Bars cycle through vivid colours each refresh
• **glow** — Per-character gradient that shifts across the bar
• **shift** — Bright highlight slides across the bar

If $ARGUMENTS matches `text-color <name>` or `text-colour <name>`: -> Run `--text-color <name>` directly.

If $ARGUMENTS matches `currency <symbol>` (e.g. `currency £`, `currency €`, `currency $`): -> Run `--currency <symbol>` directly. -> Explain: cost is auto-converted from USD using a live exchange rate (cached 24h).

If $ARGUMENTS matches `bar-size <size>`: -> Run `--bar-size <size>` directly.

If $ARGUMENTS matches `bar-style <name>` or `style <name>`: -> Run `--bar-style <name>` directly.

If $ARGUMENTS matches `layout <name>`: -> Run `--layout <name>` directly.

If $ARGUMENTS matches `animation-speed <speed>` or `speed <speed>`: -> Run `--animation-speed <speed>` directly.

If $ARGUMENTS matches `focus start [minutes]` or `focus stop` or `focus status`: -> Run `--focus <action> [minutes]` directly. -> Default is 25 minutes if no duration given.

If $ARGUMENTS matches `effort-format <value>`: -> Run `--effort-format <value>` directly. -> Values: `labeled` (default, "Effort: Medium"), `full` ("Medium"), `short` ("med")

If $ARGUMENTS matches `clock <format>` (where format is `12h` or `24h`): -> Run `--clock-format <format>` directly.

If $ARGUMENTS matches `preset <name>` or `minimal` or `default preset`: -> Run the corresponding `--preset` command.

If $ARGUMENTS is `update`: -> Run `python "SCRIPT_PATH" --update` and show the output.

If $ARGUMENTS is `hooks` or `install-hooks`: -> Run `python "SCRIPT_PATH" --install-hooks` and show the output. -> Remind user to restart Claude Code.

If $ARGUMENTS is `stats`: -> Run `python "SCRIPT_PATH" --stats` and show the output.

If $ARGUMENTS is `heatmap`: -> Run `python "SCRIPT_PATH" --heatmap` and show the output.

Interactive menu (when $ARGUMENTS is empty, `themes`, `theme`, or `menu`):

**Step 0 — Quick tips:**

> **Quick commands:** `/pulse show` preview all themes · `/pulse ocean` set a theme · `/pulse config` see settings · `/pulse update` check for updates · `/pulse focus start` start a focus timer

Run `python "SCRIPT_PATH" --config` silently to check for updates.

**Step 1:** Run `python "SCRIPT_PATH" --themes-demo` and show the output.

**Step 2:** Theme — offer the **live picker** first.

Say: "For the best experience, launch the live picker — type `!python "SCRIPT_PATH" --pick-theme` in your prompt. Arrow keys move through all 10 themes, your bar recolours live, Enter keeps it, Esc cancels. (If it shows a static list instead of a moving cursor, this terminal isn't interactive — use the quick picker below.)"

If the user would rather pick from a list right here (or the live picker isn't available in their terminal), use the paginated picker below.

Theme picker (paginated as 3 page