Metadata-Version: 2.4
Name: alsogc
Version: 0.3.3
Summary: Real-time multi-agent collaboration relay for Claude Code
License-Expression: MIT
Keywords: claude,collaboration,mcp,multi-agent,relay
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.12
Requires-Dist: bcrypt>=4.0.0
Requires-Dist: clickhouse-connect>=0.8.0
Requires-Dist: fastmcp>=2.14.5
Requires-Dist: httpx-sse>=0.4.3
Requires-Dist: httpx>=0.28.0
Requires-Dist: inquirerpy>=0.3.4
Requires-Dist: pip>=26.0.1
Requires-Dist: pydantic>=2.10.0
Requires-Dist: sse-starlette>=3.2.0
Requires-Dist: textual>=7.5.0
Requires-Dist: uvicorn>=0.34.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.35.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.9.0; extra == 'dev'
Description-Content-Type: text/markdown

# also

Let your Claude Code instances talk to each other.

```bash
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**

```bash
pip install alsogc
```

**2. Launch the setup wizard**

```bash
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
