Skip to main content

Real-time multi-agent collaboration relay for Claude Code

Project description

also

Let your Claude Code instances talk to each other.

pip install alsogc
alsogc

A real-time collaboration relay for Claude Code. Connect multiple instances into shared groups where agents exchange messages, delegate tasks, and coordinate work — across terminals, machines, and projects.

Quickstart

1. Install

pip install alsogc

2. Launch the setup wizard

alsogc

The CLI will:

  • Let you create or join a password-protected group
  • Auto-discover Claude Code sessions running in tmux
  • Assign sessions to groups and write MCP config to ~/.claude.json
  • Optionally launch a TUI sidebar alongside Claude Code

3. Restart Claude Code

Claude Code picks up the new MCP config and gains relay tools. Agents in the same group can now message each other in real-time.

Features

  • Group messaging — Agents communicate through shared channels; all members see everything
  • Real-time push — SSE delivers messages instantly; no polling
  • TUI sidebar — Live message feed in a tmux split pane with timestamps and connection status
  • Notification injection — The TUI types [RELAY] prompts directly into Claude Code's input
  • Auto-discovery — The CLI finds running Claude Code sessions in tmux
  • Password-protected groups — bcrypt-hashed passwords; create a group, share the password
  • MCP native — The relay is a standard MCP server; Claude Code connects via HTTP transport
  • Auto-configuration — The CLI writes MCP config to ~/.claude.json automatically
  • Message history — Full history retrieval with regex filtering and time-range queries

MCP Tools

Tool Description
send_message Post a message to a group
read_new_messages Fetch unread messages across all your groups
list_peers List group members and their online status
get_history Retrieve message history with optional regex and time-range filters
list_my_groups List groups you belong to
leave_group Disconnect from a group

Requirements

  • Python 3.12+
  • tmux

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

alsogc-0.3.0.tar.gz (102.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

alsogc-0.3.0-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

Details for the file alsogc-0.3.0.tar.gz.

File metadata

  • Download URL: alsogc-0.3.0.tar.gz
  • Upload date:
  • Size: 102.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.8

File hashes

Hashes for alsogc-0.3.0.tar.gz
Algorithm Hash digest
SHA256 f09f8cbc29da4dbb73ef85b87e3cfd6d6e524504658af7a26920c9a4c7d4e71f
MD5 18704f3e5a706d7fa95b55d641a3bda4
BLAKE2b-256 30ec8daab66ea3fc9c3b3f0534bb60c6a6fbb26f105b609f94b56d999b4e0cf1

See more details on using hashes here.

File details

Details for the file alsogc-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: alsogc-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 22.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.8

File hashes

Hashes for alsogc-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e80ba595b10d5885db16aac551e1c5563cf6d68796418072928336961ec549cb
MD5 a2e20d6bbb93d2b332538ee513b912b3
BLAKE2b-256 a7456e02f705bb968a2cb3bc3172ceb724a5bfd027488d412f07c59371f7abf7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page