Letswork

LetsWork

Real-time collaborative coding via Claude Code — two developers, one codebase, each using their own Claude subscription.

One developer hosts the session. The other joins from anywhere. Both get a live Claude Code window connected to the same project — with file locking and an approval system to prevent conflicts.

---

How It Works

1. Host runs letswork start inside their project folder
2. A secure HTTPS tunnel is created automatically via Cloudflare
3. A one-time URL + guest token is generated and printed
4. Host shares the join command with the guest
5. Guest runs letswork join --token on their machine
6. Both developers now have Claude Code connected to the same codebase

---

Requirements

---

macOS — Host Setup

The host is the developer who owns the project. You start the session and share the join command.

Step 1 — Install dependencies

brew install cloudflared

pip install letswork

Step 2 — Install Claude Code

npm install -g @anthropic-ai/claude-code

Step 3 — Start the session

Navigate to your project folder and run:

cd /path/to/your/project

letswork start

You will be asked for your display name, then a session box appears:

╔══════════════════════════════════════════════════════════════════════╗

║ 🤝 LetsWork Session Active ║ ║ ║ ║ Send this command to your collaborator: ║ ║ letswork join https://abc123.trycloudflare.com --token a1b2c3d4 ║ ║ ║ ║ Press Ctrl+C to stop. ║ ╚══════════════════════════════════════════════════════════════════════╝

Copy the full `letswork join ...` command and send it to your collaborator.

Two new terminal windows open automatically:

• Claude Code — already connected to LetsWork
• A chat window to communicate with your collaborator

Step 4 — Approve guest changes

When the guest edits a file, you'll see a notification in Claude Code. Ask Claude:

get_pending_changes

Then approve or reject:

approve_change <id>

reject_change

Step 5 — Stop the session

Press Ctrl+C in the terminal where you ran letswork start.

---

macOS — Guest Setup

The guest connects to the host's project. You need the join command from the host.

Step 1 — Install dependencies

brew install cloudflared

pip install letswork

Step 2 — Install Claude Code

npm install -g @anthropic-ai/claude-code

Step 3 — Join the session

Run the command the host sent you:

letswork join https://abc123.trycloudflare.com --token a1b2c3d4

You'll be asked for your display name. Then two windows open:

• Claude Code — connected to the host's project
• A chat window to communicate with the host

Step 4 — Edit files

Ask Claude to read and edit files normally. When you write a file, it goes into an approval queue — the host reviews it before it's written to disk. You'll get a notification when it's approved or rejected.

---

Windows — Guest Setup (WSL)

LetsWork runs inside WSL (Windows Subsystem for Linux). The guest experience is the same as macOS once WSL is set up.

Step 1 — Enable WSL and install Ubuntu

Open PowerShell as Administrator and run:

wsl --install

Restart your computer when prompted. Ubuntu will install automatically.

Open Ubuntu from the Start menu and set up your Linux username and password.

Step 2 — Install dependencies inside Ubuntu

Open Ubuntu and run these one by one:

# Update packages

sudo apt update && sudo apt upgrade -y

Install Python

sudo apt install python3 python3-pip -y

Install Node.js and npm

sudo apt install nodejs npm -y

Install cloudflared

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared chmod +x cloudflared sudo mv cloudflared /usr/local/bin/

Install letswork

pip3 install letswork

Step 3 — Install Claude Code inside Ubuntu

npm install -g @anthropic-ai/claude-code

Step 4 — Join the session

Run the command the host sent you, inside Ubuntu:

letswork join https://abc123.trycloudflare.com --token a1b2c3d4

You'll be asked for your display name. Claude Code launches directly in the same terminal window.

Note for Windows users: Claude Code runs in the WSL terminal — not as a separate window. Everything else works identically to macOS.

---

MCP Tools Available

Both host and guest have access to these tools inside Claude Code:

---

Approval Flow

Guest file writes do not go directly to disk — they go through the host's approval queue:

1. Guest asks Claude to edit a file → write_file submits the change
2. Host sees: 📝 guest submitted change to server.py (ID: a1b2c3)
3. Host asks Claude: get_pending_changes — sees a full diff
4. Host approves: approve_change a1b2c3 → file is written to disk
5. Or rejects: reject_change a1b2c3 → guest is notified

---

Security

• Random Cloudflare subdomain — URL is unguessable
• Cryptographic token — second auth layer on top of the URL
• All traffic encrypted via HTTPS
• Path traversal prevention — guest cannot access files outside the project root
• File locks auto-expire after 30 minutes
• No accounts, no signup, no persistent credentials — session ends when host stops

---

Constraints

• Maximum 2 users per session (Host + 1 Guest)
• Text files only — binary files not supported
• 1MB file size limit per read/write operation
• Guest has no shell access — file operations only
• cloudflared must be installed on the host machine (guest does not need it on macOS, but WSL guests do)

---

CLI Reference

letswork start [--port PORT] [--debug]   # Start a session (default port: 8000)

letswork join --token # Join a session as guest

---

Architecture

Host Machine:

[Project Files] ← [MCP Server :8000] ← [Cloudflare Tunnel] ← HTTPS URL ↑ Guest connects here via stdio proxy + secret token

The guest connects through a stdio proxy rather than directly over HTTP — this avoids Cloudflare SSE reliability issues and gives stable MCP connectivity.

---

License

MIT — see LICENSE

---

Built with the Model Context Protocol.