setup-pulse

name	setup-pulse
description	Install claude-pulse statusline for real-time token usage monitoring. Use when user says "/setup-pulse", "install statusline", "setup pulse".
allowed-tools	Bash

/setup-pulse

Install claude-pulse statusline for real-time token usage monitoring.

Usage

/setup-pulse

Description

Installs claude-pulse - a statusline script that shows your context usage as 72k/200k (36%) with color-coded warnings.

Instructions

When the user runs /setup-pulse:

1. Clone or update the claude-pulse repository:

   if [ -d "$HOME/Code/claude-pulse" ]; then
     cd "$HOME/Code/claude-pulse" && git pull
   else
     mkdir -p "$HOME/Code"
     git clone https://github.com/omriariav/claude-pulse.git "$HOME/Code/claude-pulse"
   fi
   

2. Run the install script:

   cd "$HOME/Code/claude-pulse" && ./install.sh
   

3. Tell the user to add this to their Claude Code settings.json:

   {
     "statusLine": {
       "type": "command",
       "command": "~/.claude/statusline-command.sh"
     }
   }
   

   For Windows users:

   {
     "statusLine": {
       "type": "command",
       "command": "powershell -ExecutionPolicy Bypass -File C:/Users/USERNAME/.claude/statusline-command.ps1"
     }
   }
   

4. Tell them to restart Claude Code to see the statusline.

Example Output

After installation:

claude-pulse installed successfully!

Add to your settings.json:
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline-command.sh"
  }

Then restart Claude Code to see: 72k/200k (36%)

What It Shows

• Real-time token usage matching /context
• Color-coded: Green (<50%) | Yellow (50-79%) | Red (80%+)
• Works with all Claude models

• 100% is normal when context is full (Claude will auto-compact)