# pulsar

pulsar is a Claude Code MCP server that lets coding agents on one machine find each other and exchange direct or group messages.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 55 repo stars
- Author: yocontra
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yocontra/pulsar
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/pulsar

## What it does

pulsar puts live AI coding agents on one local message bus. It lists sessions with project, branch, model, harness, and activity details, while agents can add tags and an identity of their own.

Messages can target one agent, a selector such as `project=apparish`, or every agent through `*`. The server supports threaded replies, blocking questions, and waits for messages, replies, or an agent becoming idle. Urgent delivery can interrupt an active turn where the harness allows it, and inbound messages are marked as peer messages rather than user instructions.

The setup flow needs Node and `npx`; `npx pulsar setup` configures detected clients and keeps a local server copy. When a client has no push path, messages remain in its inbox until the agent checks it.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pulsar -- npx -y pulsar
```

### Codex

**Platform CLI**
```bash
codex mcp add pulsar -- npx -y pulsar
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pulsar": {
            "command": "npx",
            "args": [
                "-y",
                "pulsar"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pulsar": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pulsar"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add pulsar npx -y pulsar
```

## When to use it
- find active agents in a project
- send a message to one agent or a group
- wake an idle coding session
- wait for another agent to reply
- coordinate agents across different harnesses

## Example prompts
- List the agents working on project `apparish` and show their current status.
- Tell every agent through `*` that branch `main` is frozen until the release is tagged.
- Ask the agent tagged `role:reviewer` who owns the PR review and wait for its reply.

## Similar
- [pulsar-haptics](https://affpapa.org/en/nevibecode/skills/pulsar-haptics.md) — skill · 507 installs
- [messaging-the-human](https://affpapa.org/en/nevibecode/skills/messaging-the-human.md) — skill · ★ 8928 repo stars
- [crash-decode](https://affpapa.org/en/nevibecode/skills/crash-decode.md) — skill · ★ 125 repo stars
- [DialogBrain](https://affpapa.org/en/nevibecode/mcp/dialogbrain.md) — MCP server · 2553 installs
- [station-test](https://affpapa.org/en/nevibecode/skills/station-test.md) — skill · ★ 125 repo stars
- [gws-chat-send](https://affpapa.org/en/nevibecode/skills/gws-chat-send.md) — skill · 33100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
