Claude Duet

✦ claude-duet

Two devs. One Claude. Pure vibes.

Share your Claude Code session with a friend — real-time collaboration for AI pair programming.

⚡ Quick Start
Assumes you already have Claude Code installed.

Send the join command to your partner via Slack, Discord, whatever works.

P2P mode (default): After your partner runs the join command, they'll get an answer code to share back with you. Paste it into your terminal — that's it, you're connected directly peer-to-peer via WebRTC. No server needed.

Step by Step

1. Exit Claude Code if you're in an active session (Ctrl+C or /exit)
2. Start a duet session from your regular terminal:
   - npx claude-duet host — fresh session
   - npx claude-duet host --continue — resume your most recent Claude Code conversation
3. Share the join command that appears in your terminal with your partner
4. Your partner runs the join command from their own terminal
5. Chat freely — plain text goes between you two, @claude  sends to Claude
Context is preserved. Because claude-duet wraps Claude Code in headless mode, your Claude Code conversation history carries over. Use --continue to pick up where you left off, and after the duet session ends, run claude --continue to keep going solo. Claude remembers everything — before, during, and after the duet.
Heads up: claude-duet gives your partner the ability to run prompts on your machine through Claude Code. Approval mode is on by default so you review every prompt — but only share sessions with people you trust. Think of it like handing someone a terminal.

✦ What Is This

A shared terminal session where two people can chat with each other and invoke Claude together using @claude .

Just type normally to talk to your partner. Prefix with @claude to send a prompt to Claude. Both of you see…