agent-pulse

A local event gateway for AI code agents.
Capture lifecycle events from Claude Code, Gemini CLI, and more — fan them out to any HTTP endpoint, webhook, or device.

Install • Quickstart • Agent Setup • Config • Commands

--- ## Why agent-pulse? Every AI code agent has its own hook system — different formats, different configs, scattered across projects. Adding a new webhook means editing every project's settings for every agent you use. **agent-pulse** solves this with a single global config: - **One config, all agents** — Define your clients once in `~/.config/agent-pulse/config.yaml`. Every project, every agent, every event routed through one place. - **Zero per-project setup** — No more duplicating hook configs across repositories. Register your hooks once and you're done. - **Fan-out to anything** — HTTP endpoints, webhooks, IoT devices (ESP32, Raspberry Pi, etc.), scripts — if it speaks HTTP, agent-pulse can reach it. - **Fully local** — Everything runs on your machine. No cloud, no accounts, no data leaves your network. - **Enrich with metadata** — Attach custom data to every lifecycle hook via a project-level `.agent-pulse.json` — project name, team, or anything your clients need. - **Filter what matters** — Route specific events to specific clients. Send `notification` events to your desk light, `session_start` to your dashboard, everything to your logger. - **Real-time streaming** — Connect to the SSE endpoint and watch events flow in real-time. Perfect for dashboards, browser UIs, or a simple `curl -N`. --- ## Diagram

Architecture diagram

Agents

agent-pulse