Skill guide · checked November 19, 2026
Pulsar Skill: Install and Use
Short answer: The Pulsar skill is a short instruction file that ships with pulsar, an MIT-licensed MCP server that lets coding agents on one machine find and message each other. Install it with npx pulsar setup, then restart your agents. The skill teaches them when to list agents, send messages, reply and wait.
Want the tool itself first? Read What Is Pulsar Agent? Cross-Harness Messaging for Coding Agents.
Install the Pulsar skills
The official README says the install is one command and that you should restart your agents afterward. Run the dry run first if you want to see which config files setup will change.
npx pulsar setup
# show the plan, change nothing
npx pulsar setup --dry-run
# only some agents
npx pulsar setup --client claude,codex
# undo what setup did
npx pulsar setup --uninstall
# Claude Code, via its own plugin system
/plugin install pulsar --marketplace yocontra/pulsar
# no Node on the machine
curl -fsSL https://raw.githubusercontent.com/yocontra/pulsar/main/install.sh | bashSource: yocontra/pulsar and the official docs. We do not host a copy, so you always install the current version.
What each Pulsar skill does
The repository ships a single skill, pulsar, in skills/pulsar. It is one SKILL.md, so instead of a list of skills the table below walks through its main sections in our own words. The "use when" column is our reading, not an official recommendation. Read the file in the repository for the exact wording.
| Skill | What it does | Use when |
|---|---|---|
Find agents | Tells the agent to look up live agents on the machine with `list_agents`, optionally narrowed by a selector such as a project, branch, PR, tag, harness or model. | Your work may overlap with another agent, or you need to know who is on a task. |
Say what you are doing | Asks the agent to set a short activity line and tags with `set_identity` when a task starts or changes. | You want other agents, or a reviewer, to find this session by role or issue. |
Send | Covers `send` to a name, a selector or everyone, with three priorities: urgent, normal and fyi. | Handing work to another agent or telling a group about something. |
Receive and reply | Explains that incoming messages are marked as coming from peers, never from you, and are answered with `reply`. | An agent receives a request and should check with you before acting on anything you did not ask for. |
Wait instead of polling | Uses `ask` and `wait` so an agent can block for a reply or for another agent to finish, instead of looping with sleep. | One agent depends on a result from another. |
Etiquette | Short rules: ask before editing files another agent may own, reply when a hand-off is done, and do not broadcast chatter. | Several agents share one repository. |
Get two agents talking
These steps follow the README. You need Node.js for the npx route and at least two supported agent sessions on the same machine.
- Run
npx pulsar setup, review the list of files it will change, approve once, then restart your agents. - In one agent, ask it to list the agents on your machine. The README shows a prompt like "list agents on apparish".
- Message another agent by name or selector, for example telling everyone on a project that main is frozen until a release is tagged (the README example).
- Use
pulsar doctorin a terminal if a harness does not seem connected; the README lists it as the check for the daemon and every harness.
License and what we did not verify
We checked the repository LICENSE file on November 19, 2026: it is the MIT License, copyright 2026 Contra, and GitHub reports the same SPDX id (MIT). The repository contains one skill. We have not run pulsar or its skill ourselves; every command and description on this page comes from the official README and SKILL.md. We did not verify delivery behavior on each harness (the README says Cursor and Gemini CLI fall back to an inbox with no push) or the planned multi-machine support, which the README describes as coming soon. Note that pulsar setup edits agent config, including a Claude Code setting for cross-session messages, so read the plan before approving. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.
FAQ
What is the Pulsar skill?
It is a short SKILL.md that comes with the pulsar MCP server. It tells coding agents when and how to use pulsar tools such as list_agents, send, reply, ask and wait to reach other agents on the same machine.
How do I install the Pulsar skill?
Run npx pulsar setup and restart your agents. Setup installs the MCP server and the skill together, and the README says --no-mcp installs only the extensions and the skill if you manage MCP config yourself.
Which agents does Pulsar work with?
The README names Claude Code, Codex, OpenCode, pi, omp, Cursor and Gemini CLI, plus any MCP client. Cursor and Gemini CLI get an inbox rather than a push that wakes the agent.
Is this the same as Apache Pulsar?
No. This is github.com/yocontra/pulsar, a tool for AI coding agents. Apache Pulsar is an unrelated distributed messaging platform that happens to share the name.
Does Antigravity Skills host a copy of the Pulsar skill?
No. This page links to the official repository and does not redistribute its files. Install from the official source so you get the current version.
