pulse

Pulse

A local Channel plugin that injects external notifications into Claude Code sessions in real-time.

No Discord, no Telegram — just a single HTTP POST to push messages into your conversation.

**[한국어](./README.ko.md)**

https://github.com/user-attachments/assets/7bf4442e-8be9-4a6b-bfa0-b6dd4d41245e

Why Pulse?

Checking your email every time CI fails, then telling the agent "go check the CI result"?

Copying and pasting build error logs into the session manually?

Running a deploy script and opening another terminal to see if it finished?

With Pulse, you don't have to. Background processes send messages directly to your session.

Pulse is an **event abstraction layer** built on Claude Code's [Channels](https://docs.anthropic.com/en/docs/claude-code/channels) protocol. Any local process that can make an HTTP call can communicate with your Claude Code session directly — no external messengers, no bot tokens, no accounts.

Concept

Hooks / Scripts / Cron
    ↓ HTTP POST localhost:3400/notify
Pulse MCP Server
    ↓ notifications/claude/channel
Real-time injection into Claude Code session

Pulse leverages Claude Code's [Channels](https://docs.anthropic.com/en/docs/claude-code/channels) protocol. The MCP server registers with the `claude/channel` capability and forwards HTTP requests to the session via `notifications/claude/channel`.

Installation

1. Add marketplace in Claude Code

`/plugins` → `Add Marketplace` → enter `chsm04/pulse`

2. Install the pulse plugin

Select pulse from the marketplace list → Install

3. Start session with channel mode

claude --dangerously-load-development-channels plugin:pulse@pulse

API

POST `/notify`

Deliver a notification to the Claude Code session.

curl -s -X POST localhost:3400/notify \
  -H "Content-Type: application/json" \
  -d '{"text":"Build failed!","source":"ci","level":"error"}'

| Field | Type | Required | Description |

...