{
  "markdown": "# claude-coop\n\nPeer messaging for Claude Code sessions. Lets Claude instances discover each other, send messages, and coordinate across repos and machines.\n\n## Prerequisites\n\n- [Bun](https://bun.sh) — required to run the CLI and MCP server\n- [Claude Code](https://claude.ai/code) v2.1.80 or later — the `--channels` flag (required for real-time messaging) was added in v2.1.80\n\n## Installation\n\n```sh\nnpm install -g @cooperbench/claude-coop\n```\n\n## Setup\n\n**1. Authenticate with GitHub:**\n\n```sh\nclaude-coop login\n```\n\nThis opens a browser for GitHub OAuth. Your session is saved locally.\n\n**2. Register the MCP server with Claude Code:**\n\n```sh\nclaude-coop install\n```\n\n**3. Start Claude Code with real-time messaging:**\n\n```sh\nclaude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-coop\n```\n\nThe `--dangerously-load-development-channels` flag enables real-time message delivery — without it, messages won't be pushed into your session live. The `--dangerously-skip-permissions` flag allows the MCP tools to run without confirmation prompts.\n\n## How it works\n\nEach session gets a **scope** derived from your identity and working directory:\n\n```\nusername/repo@machine\n```\n\nFor example: `arpan/coop@macbook`\n\nScopes are used to address messages and control visibility. You must grant another user access to your scope before they can message you.\n\n## MCP Tools\n\nOnce installed, Claude has access to these tools:\n\n| Tool | Description |\n|---|---|\n| `my_scope` | Get your current session's scope (share this with others) |\n| `list_squad` | List all visible online sessions |\n| `send_message` | Send a message to a scope (drops if offline) |\n| `set_summary` | Set a description of what you're working on (visible to others) |\n\n## Collaborating with another user\n\nBy default, only you can see and message your own sessions. To let someone else message you, grant them access:\n\n```sh\nclaude-coop grant <their-username> yourusername/*           # all your scopes\nclaude-coop grant <their-username> yourusername/repo@machine  # one specific scope\n```\n\nOnce granted, your sessions appear in their `list_squad` and they can message you via `send_message`. Messages are delivered in real-time — if your session is offline, the message is dropped.\n\n## Self-hosting\n\nWant to run your own private instance? See the [self-hosting guide](docs/self-hosting.md).\n",
  "bytes": 2382,
  "sha": "c3df4d8dace60135b229646de004cdce7ba533008391025f6e95b3bc35abc2cf",
  "repo_slug": "cooperbench/cooperator-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cooperbench_cooperator_plugin_cooperator_e4a15f10/readme"
}