See your context usage, cost, MCP health, hooks, skills, and git status — all without leaving Claude Code.

Full mode shows names, groups, and token breakdown:

Compact mode shows counts only:

npm install -g cc-pulse

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "cc-pulse"
  }
}

Restart Claude Code and the statusline appears below the input area.

The statusline adapts to your setup automatically.

Skills adapt based on count:

• 10 or fewer: lists all names, e.g. ✦ Skills 5 beads excalidraw mermaid tmux repomix
• More than 10 with shared prefixes: groups them, e.g. ✦ Skills 89 bmad:77 beads excalidraw ...
• More than 10 without groups: caps at 10 names with overflow, e.g. ✦ Skills 15 a b c ... +5

Hooks adapt based on total count:

• 6 or fewer: shows all names per event, e.g. ⚡Hooks 4 Submit:2 lint,format Post:2 test,deploy
• More than 6: caps names to 3 per group, e.g. ⚡Hooks 12 Submit:5 lint,format,check +2

Width-aware wrapping breaks long lines at component boundaries instead of cutting them off. Items wrap at 5 per line for readability.

Compact mode collapses everything to counts only. Toggle with /pulse-compact or set in config:

{
  "compact": true
}

Create ~/.config/claude-pulse/config.json to customise. Only include what you want to change.

{
  "compact": true
}

{
  "components": {
    "context": {
      "style": "bar",
      "showTokens": true,
      "thresholds": { "warn": 70, "critical": 85, "danger": 95 }
    }
  }
}

{
  "components": {
    "mcp": {
      "showNames": true,
      "showOnlyProblems": false,
      "maxDisplay": 4
    }
  }
}

{
  "components": {
    "hooks": {
      "showNames": true,
      "showCount": true
    }
  }
}

{
  "components": {
    "cost": {
      "showBurnRate": true,
      "label": "$"
    }
  }
}

{
  "components": {
    "skills": {
      "showNames": true,
      "showCount": true,
      "maxDisplay": 5
    }
  }
}

{
  "components": {
    "cwd": {
      "style": "short",
      "maxLength": 30,
      "showIcon": true
    }
  }
}

{
  "dividers": true
}

{
  "sectionSeparators": false
}

{
  "lines": {
    "hooks": { "enabled": false },
    "engine": { "separator": " | " }
  }
}

cc-pulse ships with a skill you can install to your Claude Code skills directory:

Copy skills/pulse-compact/ to ~/.claude/skills/ or your project's .claude/skills/.

git clone https://github.com/ali-nr/claude-pulse.git
cd claude-pulse
bun install
bun run build
bun test

For local testing, use the full path in settings: "command": "node /path/to/claude-pulse/dist/cli.js"

MIT