agentwisper - Claude Code Plugin

Multi-agent communication plugin for Claude Code. Connects to an agentwisper broker for P2P messaging, squad management, and pub/sub broadcasting.

Prerequisites

Requirement	Notes
agentwisper broker	Running on localhost:8000
Claude Code	CLI with plugin support

Installation

From marketplace:

claude plugin install agentwisper

For local development:

claude plugin marketplace add /path/to/agentwisper-plugin
claude plugin install agentwisper

Usage

Start the broker first, then use slash commands in any Claude Code session.

Quick Start

Terminal 1: Start Broker

cd agentwisper
uv run agentwisper-broker start --port 8000

Terminal 2+: Connect Agents

claude

Commands

Command	Description
/agentwisper:setup [url]	Configure broker URL for this instance
/agentwisper:register <name>	Register as an agent
/agentwisper:reconnect [name]	Reconnect a disconnected agent
/agentwisper:status [agents]	Broker status and agent info
/agentwisper:send <recipient> <msg>	Send a P2P message
/agentwisper:sendwait <recipient> <msg> [timeout]	Send and wait for the recipient's reply
/agentwisper:poll [all]	Poll for unread messages
/agentwisper:wait [timeout]	Wait for new messages (blocking)
/agentwisper:query <filter>	Query message history
/agentwisper:retry	Retry a failed message from the local outbox
/agentwisper:squad <name>	Create a squad
/agentwisper:invite <agent> [role]	Invite an agent to a squad
/agentwisper:broadcast <topic> <msg>	Broadcast to a topic
/agentwisper:subscribe <topic>	Subscribe to a topic

Demo Scenario

1. Agent A registers: /agentwisper:register reviewer
2. Agent B registers: /agentwisper:register tester
3. Agent A sends: /agentwisper:send tester Run integration tests for PR #42
4. Agent B waits: /agentwisper:wait 60
5. Agent B replies: /agentwisper:send reviewer All 261 tests passed

Configuration

The plugin connects to http://localhost:8000/mcp by default. To change the broker URL, edit .mcp.json:

{
  "mcpServers": {
    "agentwisper-broker": {
      "type": "http",
      "url": "http://your-broker-host:8000/mcp"
    }
  }
}

Architecture

Claude Code A ──┐
                ├─→ Broker (localhost:8000) ← SQLite DB
Claude Code B ──┘         ↑
                    streamable-http

• Broker: Central message hub, single process, SQLite WAL persistence
• Plugin: Agent-side client, provides slash commands + MCP connection

Testing

Plugin skills are markdown specs; broker behavior is tested in the agentwisper repository (261 tests + smoke + system). Tagged releases are packaged by .github/workflows/release.yml.

License

Apache License 2.0