Passnote plugin
A Claude Code plugin giving agents on different computers a shared mailbox for short notes through a small server.
- 204 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Messages travel through a shared server over HTTPS with a token and may carry commit details.
- Hooks intervene in the agent and may stop it until messages are handled.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/passnoteDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Messages travel through a shared server over HTTPS with a token and may carry commit details.
- Hooks intervene in the agent and may stop it until messages are handled.
This is third-party code. Review the repository files before installing.
What it does
Passnote is for several people working on one project, each with their own Claude Code. Agents pass short notes to each other, for example "I changed the output format of `export.py`, see the commit" or "I am taking task 3", and nobody relays them by hand. The system is a server on the Python standard library with SQLite plus a plugin on every computer. The plugin adds the MCP tools `send`, `read_inbox` and `ack`, and hooks show new messages on prompt submit and between tool calls, at most every 20 seconds. Passnote is switched on per session. The `/passnote:ui` command opens a browser page to read and acknowledge messages.
Who it is for. Small teams where each member runs their own Claude Code and agents need to coordinate without manual relaying.
Good fit when
- A teammate changed a module interface and your agent must learn of it at once.
- Two people split tasks and want agents to record who took what.
- You need to ask an agent on another machine to rerun a benchmark on its GPU.
- Before stopping, an agent has to handle unread messages.
Not a fit when
- You work alone: there is nobody for agents to message.
- No machine is reachable by everyone: the server needs a shared address and port.
- You need to exchange files or large data: notes are meant for short text.
Example request
Send Bob through passnote: I changed the output format in export.py, see the latest commit.Limitations
Python 3.9 or newer is needed on every computer, plus a server reachable by all over TCP: a VPS or a LAN machine. Windows requires Git for Windows because hooks run through Git Bash. The token is generated on your machine and kept in `~/.config/claude-passnote/config.json`, and its hash goes to whoever runs the server. Hooks may stop the agent once when unread messages remain. The last commit dates to October 2026.
How to disable. Run `/passnote:disable` in a session and remove the plugin with Claude Code commands. Stop the server on its machine.
FAQ
How do I install Passnote?
Run the server, then in Claude Code run `/plugin marketplace add ziangni-sys/claude-passnote` and `/plugin install passnote@passnote`.
How do I create a token?
With `/passnote:init alice https://address:8765 /path/server-cert.pem`. The token is generated locally and never printed, and the command prints its SHA-256 for the server owner.
What do other sessions see?
Nothing: Passnote is off until you turn it on in a specific session. Other conversations get no tools, no hook output and no network calls.
How do I see who is around?
`/passnote:status` shows the server, your name and recipients, and whether they have a Passnote session open.
Can I read messages without an agent?
Yes, `/passnote:ui` opens a browser page where messages are read, sent and acknowledged by hand.
Discussion
No questions or reviews yet.
Related
PluginsPlugin for Claude Code, Codex and omp that gathers an agent's questions and findings into one list with quick actions.
Agent Standup shows Claude Code, Codex and Mistral Vibe sessions as a live team call: who works, who waits.
A plugin that turns Claude Code into a personal chief of staff with persistent memory, a morning brief and a weekly review
Agent Client for Obsidian
Agent Client
An Obsidian plugin that runs Claude Code, Codex and other agents via the Agent Client Protocol right inside your notes vault
Meeting notes on Mac and an MCP for agents: Markdown transcripts, search, recaps and action items, with no bot joining the call
Eight Claude Code skills for Obsidian: Granola notes, NotebookLM imports, TaskNotes tasks, recall of past sessions, chat export
README in short
The README draws the server plus per-computer plugins scheme and lists tools, hooks and per-session opt-in rules. Requirements, quick start, running the server and user management follow.