{"id":51373938,"url":"https://github.com/vildanbina/claude-relay","last_synced_at":"2026-07-03T10:07:45.628Z","repository":{"id":355364589,"uuid":"1217152169","full_name":"vildanbina/claude-relay","owner":"vildanbina","description":"Cross-session messaging for Claude Code. Ask one session, get answers from another, all in natural language","archived":false,"fork":false,"pushed_at":"2026-07-01T05:38:31.000Z","size":149,"stargazers_count":60,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-01T07:21:32.346Z","etag":null,"topics":["ai","broadcasting","channels","claude-code"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vildanbina.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-21T15:42:45.000Z","updated_at":"2026-07-01T05:38:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vildanbina/claude-relay","commit_stats":null,"previous_names":["innestic/claude-relay","vildanbina/claude-relay"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/vildanbina/claude-relay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vildanbina%2Fclaude-relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vildanbina%2Fclaude-relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vildanbina%2Fclaude-relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vildanbina%2Fclaude-relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vildanbina","download_url":"https://codeload.github.com/vildanbina/claude-relay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vildanbina%2Fclaude-relay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35081321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","broadcasting","channels","claude-code"],"created_at":"2026-07-03T10:07:45.152Z","updated_at":"2026-07-03T10:07:45.616Z","avatar_url":"https://github.com/vildanbina.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Relay\n\nLet local Claude Code sessions talk to each other in natural language.\n\nRunning two Claude sessions on different projects? In one, say _\"ask the backend session if the auth token shape changed\"_ and the other answers. Or _\"ask everyone what they're working on\"_ and replies stream back.\n\n\u003cimg width=\"1280\" height=\"678\" alt=\"ezgif-7f30f78a18c9905f\" src=\"https://github.com/user-attachments/assets/9a132dfa-9db1-4550-96e0-cd25a2744fce\" /\u003e\n\n## Install\n\nClaude Relay ships as a Claude Code plugin. Three steps.\n\n### 1. Add the marketplace\n\nFrom any Claude Code session:\n\n```\n/plugin marketplace add vildanbina/claude-relay\n```\n\n### 2. Install the plugin\n\n```\n/plugin install relay@claude-relay\n```\n\nThis registers the MCP server and slash commands.\n\n### 3. Launch sessions with the channel capability\n\nRelay delivers inbound messages via `notifications/claude/channel` — a Claude Code capability still in research preview. Every session that should send or receive messages must be launched with:\n\n```bash\nclaude --dangerously-load-development-channels plugin:relay@claude-relay\n```\n\nThe `dangerously-` prefix is required until Anthropic promotes the channels capability to general availability and adds this plugin to the trusted allowlist. We will submit for review and drop the flag as soon as it's approved.\n\nOpen two sessions in different project dirs and try the examples below.\n\n## Usage\n\nTry:\n\n- _\"what sessions are active?\"_\n- _\"ask backend-api what they're working on\"_\n- _\"ask everyone to report status\"_\n\nRename your session: `/relay-rename backend-api`. Natural language works too (_\"call yourself backend-api\"_), but the slash command is faster. Claude Code's built-in `/rename` also auto-syncs.\n\n### Tools\n\n| Tool              | What it does                                                       |\n| ----------------- | ------------------------------------------------------------------ |\n| `relay_peers`     | List active sessions on this machine                               |\n| `relay_ask`       | Ask one peer; returns immediately, reply arrives as a notification |\n| `relay_reply`     | Answer an incoming ask by `ask_id`                                 |\n| `relay_broadcast` | Ask every other peer; replies stream back as notifications         |\n| `relay_rename`    | Rename this session                                                |\n\nClaude routes to these automatically. You rarely call them by name.\n\nIf two sessions share a slugged basename (both `~/Code/backend/api`), Relay suffixes `-2`, `-3`. Use `relay_peers` to disambiguate by `cwd`.\n\n### Preset name via env (for orchestrators)\n\nSet `CLAUDE_RELAY_PRESET_NAME` in the spawned session's environment to pre-register under a deterministic name:\n\n```bash\nCLAUDE_RELAY_PRESET_NAME=home-office-agent-12 claude ...\n```\n\nUseful when a parent process pty-spawns many sessions and needs each to land under a known name instead of the directory-basename fallback. Same validation as `/relay-rename` applies (max 64 chars, `[A-Za-z0-9._-]+`); invalid values are ignored. The preset only seeds the initial registration — `/rename` and `/relay-rename` continue to work normally.\n\n## Error codes\n\n| Code                 | Meaning                                               |\n| -------------------- | ----------------------------------------------------- |\n| `peer_not_found`     | No peer registered under that name                    |\n| `peer_gone`          | Target peer disconnected before replying              |\n| `timeout`            | Ask timed out waiting for a reply                     |\n| `name_taken`         | Rename or register name already in use                |\n| `not_registered`     | Caller tried to use a tool before registering         |\n| `already_registered` | Same socket tried to register twice                   |\n| `unknown_ask`        | Reply references an `ask_id` the hub has no record of |\n| `bad_msg`            | Malformed JSON or schema-invalid payload              |\n| `hub_unreachable`    | Hub socket died or never replied                      |\n| `bad_args`           | Tool called with missing or wrong-typed arguments     |\n| `protocol_mismatch`  | Client version != hub version; kill the hub and retry |\n\n## Debugging\n\nRuntime data lives under `$CLAUDE_PLUGIN_DATA` (`~/.claude/plugins/data/relay-claude-relay/`).\n\n```bash\nDATA=~/.claude/plugins/data/relay-claude-relay\ntail -f \"$DATA/logs/relay-$(date +%Y-%m-%d).log\" | jq   # today's log\npgrep -f hub-daemon.ts                                  # hub alive?\npkill -f hub-daemon.ts \u0026\u0026 rm -f \"$DATA/hub.sock\"        # force reset\n```\n\nPer-session MCP stderr lives under `~/Library/Caches/claude-cli-nodejs/\u003cproject-slug\u003e/mcp-logs-*/`. Start there when a channel fails to register.\n\n## How it works\n\nThree pieces:\n\n- **Session** — a Claude Code process you launched.\n- **Channel** — per-session MCP server (this plugin). Exposes the `relay_*` tools to Claude and listens for incoming messages.\n- **Hub** — single detached daemon per machine. Routes messages between channels over a Unix socket at `$CLAUDE_PLUGIN_DATA/hub.sock`.\n\nThe first session to launch spawns the hub; later sessions connect to it. The hub survives session restarts and self-exits five minutes after the last peer disconnects. Incoming peer messages arrive as `notifications/claude/channel` so Claude sees them between turns.\n\nDetails: [docs/architecture.md](docs/architecture.md).\n\n## Out of scope\n\n- No persistence — peer state lives in the hub process only\n- Single user per machine; no auth or access control\n- Same-host only; no cross-machine relaying\n\n## Development\n\nRequires [Bun](https://bun.sh) and Claude Code 2.1.80+.\n\n```bash\ngit clone https://github.com/vildanbina/claude-relay\ncd claude-relay \u0026\u0026 bun install\nbun run check   # typecheck + lint + format + test\n```\n\nFor a live-reload loop (edits hit Claude Code on restart), bypass the plugin with a project-scope `.mcp.json`:\n\n```bash\ncp .mcp.json.example .mcp.json\n/plugin uninstall relay@claude-relay\n```\n\nLaunch Claude Code with `--dangerously-load-development-channels server:relay` (note `server:`, since the MCP is now manually registered). Reinstall the plugin when you're done. `.mcp.json` is gitignored.\n\nOpen an issue before a PR so we can align on scope.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvildanbina%2Fclaude-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvildanbina%2Fclaude-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvildanbina%2Fclaude-relay/lists"}