Agent Pulse

Real-time activity visualizer for Claude Code. See what your AI is doing at a glance.

What It Does

Agent Pulse renders a live waveform in your VS Code sidebar that reacts to every tool Claude Code uses. Different tools produce different colors, intensities, and visual effects.

The HUD includes orbital arcs, sonar rings, concentric tick rings, floating embers, and data particles converging on a central core. It looks like a sci-fi command center.

Install

1. Install from the VS Code Marketplace
2. Open the Command Palette (Cmd+Shift+P) and run Agent Pulse: Install Claude Code Hooks
3. Restart Claude Code
4. Start working. The visualizer reacts automatically.

How It Works

Claude Code supports hooks that fire shell commands on every tool use. Agent Pulse installs two hooks (PreToolUse and PostToolUse) that POST activity data to a lightweight local HTTP server running inside the extension. The webview renders the waveform on a Canvas at 60fps.

Claude Code Hook --> HTTP POST --> Local Server (extension) --> Canvas Webview

The server binds to 127.0.0.1:7888 (localhost only). No data leaves your machine.

Commands

Requirements

• Claude Code CLI installed and configured
• VS Code 1.85+
• macOS or Linux (hooks use curl which is available by default)

FAQ

Can I change the port? Not yet. It defaults to 7888. If you have a conflict, you can manually edit ~/.claude/settings.json and the extension source.

Does this slow down Claude Code? No. The hooks fire asynchronously and fail silently if the server isn't running. Zero impact on Claude Code performance.

Does this send data anywhere? No. The server binds to 127.0.0.1 only. All data stays on your machine.

License

MIT