LetsWork

Google Docs for AI-assisted coding — real-time collaboration on a local codebase using two independent Claude subscriptions.

What is LetsWork?

LetsWork is an MCP (Model Context Protocol) server that lets two developers work on the same local codebase simultaneously, each using their own Claude. One developer hosts, the other connects — with file-level locking and an approval system to prevent conflicts.

How It Works

1. Developer A (Host) runs letswork start in their project folder
2. A secure HTTPS tunnel is created automatically via Cloudflare
3. A one-time URL + guest token is generated
4. Developer A shares the join command with Developer B (Guest)
5. Developer B runs letswork join <url> --token <token> on their machine
6. Both can now read, write, and list files — with lock protection and approval flow

Quick Start

Install

pip install letswork

Requirements

• Python >= 3.10
• cloudflared installed and available in PATH
  • macOS: brew install cloudflared
  • Linux: see Cloudflare docs
  • Windows: use WSL (Ubuntu) and follow Linux instructions
• Claude Code CLI (npm install -g @anthropic-ai/claude-code)

Host (Developer A)

cd /path/to/your/project
letswork start

You'll see a session box with a join command — share it with your collaborator:

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

Claude Code opens automatically in a new terminal window, already connected to LetsWork.

Guest (Developer B)

letswork join <URL_FROM_HOST> --token <TOKEN_FROM_HOST>

Claude Code launches automatically with LetsWork MCP connected. No extra steps needed.

Windows users: Run this inside Ubuntu (WSL). Claude Code will launch directly in the same terminal.

MCP Tools Available

Approval Flow

Guest file writes go through an approval queue — they are not written directly to disk:

1. Guest asks Claude to edit a file → write_file submits the change
2. Host sees a notification: 📝 guest submitted change to server.py (ID: a1b2c3)
3. Host asks Claude to review: get_pending_changes
4. Host approves or rejects: approve_change a1b2c3 / reject_change a1b2c3

Security

• Unguessable tunnel URL (random Cloudflare subdomain)
• Cryptographic secret token (second auth layer)
• All traffic encrypted via HTTPS
• Path traversal prevention (no access outside project root)
• File lock timeout — locks auto-expire after 30 minutes
• No accounts, no signup, no persistent credentials

CLI Commands

Architecture

Developer A's Machine:
[Local Codebase] ← [MCP Server :8000] ← [Cloudflare Tunnel] ← HTTPS URL
                                                                     ↑
                                              Developer B connects here
                                              via stdio proxy + secret token

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

Constraints

• Maximum 2 users per session (Host + Guest)
• Text files only (binary files not supported)
• 1MB file size limit per operation
• File operations only (no shell access for Guest)
• Requires cloudflared on the host machine

License

MIT

Built with the Model Context Protocol.