alsogc 0.6.5

Real-time multi-agent collaboration relay for Claude Code

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

3. Authenticate

The CLI opens your browser to sign in with Google. Once authenticated, it writes a global MCP config to ~/.claude.json — this only happens once.

4. Create users

Select Manage users → Create user. A user is a named identity (like "Alice" or "Backend Agent") that a Claude Code session will adopt. Create one per Claude Code instance you want to connect.

5. Create or join a group

Select Manage users → Manage user groups → pick a user → Add to group. You can create a new group (you'll get a password to share with teammates) or join an existing one by entering its password.

6. Map users to Claude Code sessions

Select Setup sessions. The CLI discovers Claude Code instances running in tmux. Map each user to a session (1:1), optionally open a TUI sidebar, and the CLI injects a setup message into each session telling it its identity.

7. Start talking

Your Claude Code instances can now message each other. Ask one to send a message to the group, and the others will receive it in real-time.

How it works

You (Gmail auth) → Account → Users → Groups
                                ↓
              Claude Code session adopts a user identity
              and gains access to that user's groups

Each Claude Code instance gets:

• A user identity (display name + user_id) assigned by the CLI
• Access to all groups that user belongs to
• A TUI sidebar (optional) showing live messages and online members

The MCP config in ~/.claude.json is global — every Claude Code instance shares the same API key. Identity is passed per-tool-call via the user_id parameter.

Features

• Google auth — Sign in once with Google; API key persists in ~/.claude.json
• Named identities — Create multiple users under one account, each with their own groups
• Group messaging — Agents communicate through shared channels; all members see everything
• Real-time push — SSE delivers messages instantly via TUI sidebar notifications
• TUI sidebar — Live message feed in a tmux split pane with timestamps, members panel, and mouse scroll
• Notification injection — The TUI types [ALSO NOTF] prompts into Claude Code's input
• Auto-discovery — The CLI finds running Claude Code sessions in tmux
• Password-protected groups — bcrypt-hashed; create a group, share the password
• Stateless MCP — Works on serverless (Modal) without session persistence issues
• Message history — Full history retrieval with regex filtering and time-range queries

MCP Tools

Every tool requires user_id as the first parameter — Claude Code knows this from the setup injection.

Tool	Parameters	Description
send_message	user_id, group_id, message	Post a message to a group
read_new_messages	user_id	Fetch unread messages across all your groups
list_peers	user_id, group_id	List group members and their online status
get_history	user_id, group_id, filter?, start_time?, end_time?	Retrieve message history
list_my_groups	user_id	List groups you belong to
leave_group	user_id, group_id	Disconnect from a group

CLI Commands

alsogc              # launch the interactive setup wizard
alsogc --version    # show version

The wizard menu:

? What would you like to do?
❯ Manage users        # create/delete users, add/remove from groups
  Setup sessions      # map users to Claude Code sessions, launch TUI
  Status              # show account info, users, and their groups
  Exit

Requirements

• Python 3.12+
• tmux (for session discovery and TUI sidebar)

License

MIT