team-coding

Multi-participant collaborative coding sessions powered by Claude Code.

What Is This

A shared terminal where multiple people can chat, whisper privately, prompt a shared Claude together, and optionally run their own private Claude for brainstorming — all in real-time with end-to-end encryption.

hello!              → group chat, everyone sees it
@claude fix auth.ts → sent to shared Claude, everyone sees the response
@bob check line 42  → whisper, only bob sees it
/think what does…   → private prompt to your own local Claude
/agent-mode         → your local Claude auto-responds to chat on your behalf

Features

• Multi-participant — Up to 10 participants (configurable), each identified by name
• Group chat with ordering — Server-assigned sequence numbers for consistent message order across all clients
• Whispers — Direct messages via @name message; typing indicators are targeted to the recipient only
• Shared Claude Code — Host runs a headless Claude instance; participants prompt it with optional approval gate
• Private local Claude — Join with --with-claude for a private Claude that never touches the server
• Agent mode — /agent-mode lets your local Claude auto-respond to chat and whispers on your behalf, with loop prevention and rate limiting
• Context control — /context-mode full|prompt-only manages what chat history Claude receives; agent mode inherits this setting and includes shared Claude responses in context
• Session resume — Host can --continue or --resume <id> to pick up a previous Claude Code session
• E2E encryption — NaCl secretbox (XSalsa20 + Poly1305) with scrypt key derivation
• Multiple connection modes — WebSocket (LAN/tunnel/relay) and WebRTC P2P

Quick Start

Requires Claude Code installed on the host machine.

# Host a session
npx team-coding host --name alice

# Join a session
npx team-coding join <session-code> --password <password> --name bob

# Join with your own private Claude
npx team-coding join <session-code> --password <password> --name charlie --with-claude

CLI Reference

team-coding host                           # Start a session (WebRTC P2P by default)
team-coding host --tunnel cloudflare       # Remote access via Cloudflare tunnel
team-coding host --tunnel localtunnel      # Remote access via localtunnel
team-coding host --no-approval             # Trust mode — skip prompt review
team-coding host --continue                # Resume most recent Claude Code session
team-coding host --resume <id>             # Resume a specific session by ID
team-coding host --max-participants 20     # Raise participant limit (default: 10)
team-coding join <code> --password <pw>    # Join a session
team-coding join <code> … --with-claude    # Join with a private local Claude
team-coding relay                          # Run a self-hosted relay server
team-coding config                         # View/manage saved configuration

In-Session Commands

Input	Effect
hello!	Group chat
@claude fix the bug	Prompt shared Claude (all see the response)
@bob check line 42	Whisper to bob only
/think what does this do?	Private prompt to your local Claude
/private <prompt>	Alias for /think
/agent-mode	Enable: local Claude auto-responds to chat and whispers
/agent-mode off	Disable your own agent mode
/agent-mode off <name>	(host) Disable a participant's agent mode remotely
/context-mode full|prompt-only	Set context Claude receives for prompts
/who	List all participants
/kick <name>	(host) Disconnect a participant
/trust	(host) Switch to trust mode (no approval)
/approval	(host) Re-enable approval mode
/status	Show session info and duration
/help	Show all available commands

How It Works

┌─────────────────────┐
│  Host               │◄── WebSocket ──► Participant A  (+ local Claude)
│  · Claude Code      │◄── WebSocket ──► Participant B  (+ local Claude)
│  · Chat server      │◄── WebSocket ──► Participant N  (+ local Claude)
│  · Approval gate    │
└─────────────────────┘

• Host runs a headless Claude Code process and a WebSocket server
• Participants connect via WebSocket (or WebRTC P2P for direct connections)
• Messages flow through the host with monotonic sequence numbers for total ordering
• Shared Claude prompts are approval-gated by default; the host can switch to trust mode
• Private Claude runs entirely on the participant's machine — responses never leave it
• Agent mode auto-forwards incoming chat/whispers to the participant's local Claude and posts responses back; includes shared Claude replies in context, applies rate limiting (5 s), and prevents response loops

Security

• E2E encrypted — All WebSocket traffic is NaCl secretbox encrypted with a scrypt-derived key
• Approval mode — Host reviews participant prompts before they reach Claude (on by default)
• Host-controlled — Claude runs on the host's machine using the host's API key
• Agent safeguards — Loop prevention (isAgentResponse flag), 5-second rate limit, host remote-disable

Connection Modes

Mode	How
P2P (default)	WebRTC direct connection, no server needed
Cloudflare tunnel	--tunnel cloudflare — works anywhere, no port forwarding
localtunnel	--tunnel localtunnel — quick LAN/remote sharing
LAN	Share the local IP directly on the same network
Relay	--relay <url> with a self-hosted relay server

Development

git clone https://github.com/m3nadav/team-coding.git
cd team-coding
npm install
npm run build   # compile TypeScript
npm test        # run test suite (vitest)
npm run dev     # watch mode

Requires Node.js 18+.

License

MIT

Forked from claude-duet by EliranG.