collab

✦ claudecollab

Use Claude Code with your friends. You run one command. Your friends open a link and can collaborate with the same Claude as you.

   You                 a helper server            Your friends
(you run Claude)  <-->  (passes messages)   <-->  (open a link)

Before you go live, your terminal is exactly normal Claude — nothing added. The moment you go live, one status line shows up at the bottom, and all the sharing itself happens in the web browser.

Start a session

npx @claudecollab/cli        # try it right now, nothing to install
# liked it? make it permanent:
npm install -g @claudecollab/cli
collab

The first npx run downloads for ~10–20 seconds; after that it's fast.

Run collab instead of claude. It looks and works exactly like Claude — because at this point it is just Claude. It is not sharing anything yet. You go live only when you decide to.

The first time you run it

The very first time you run collab, you'll see a quick one-screen setup. You only see it once. It does two things for you:

1. Adds the /collab command to Claude Code — this is the whole point; it's how you go live.
2. Makes your normal claude command shareable too, so you can just keep typing claude and still get /collab.

It also asks one optional thing: do you want /collab @name to deliver your join link through Slack, Gmail, or Discord? Pick any, or none. You turn these on in your Claude account (at claude.ai/customize/connectors) — the screen tells you how, and you can change your mind anytime.

Then it starts Claude like normal.

Changed your mind, or want to run it again?

• collab setup — show the setup screen again.
• collab setup --undo — put your normal claude back (removes the shim and the plugin).
• collab --yes — skip the setup screen this time (or set CLAUDE_SHARE_SKIP_SETUP=1).

Go live with /collab

The first-run setup already added /collab for you. (Skipped it? Add it by hand:)

/plugin marketplace add ir272/claudecollab
/plugin install collab@claudecollab

Whenever you want people to join, just type this inside your session:

/collab

Claude opens a room and hands you the invite link to share. A few handy shortcuts:

• /collab @sam — go live and DM the link to Sam (if you have a messaging tool like Slack connected).
• /collab viewer or /collab max 3 or /collab password hunter2 — set the guest role, a size limit, or a join password.
• /collab off — stop sharing. The room closes and the link dies.
• /collab status — check whether you're live and see the link again.

Prefer to be live the second you start (no plugin needed)? Run collab --live and it makes the room right away. collab off stops it.

The two links

Once you're live you get two links — don't mix them up:

• A private link — your control panel (you let people in and manage them). Stays on your own screen.
• A share link — this is the one you send. /collab prints it and the Invite button copies it.

Your friends just open the share link in a browser. They don't install anything.

Works on

macOS and Linux (Windows counts too, if you use WSL). Native Windows isn't tested yet — if you try it, please open an issue and tell us how it went.

You need Node 22 or newer. If you installed Claude Code with its native installer (not npm), you might not have Node yet — install it first.

Two links — don't mix them up

Link	Who it's for
the one ending in ?host=…	Just you. Opening it makes you the boss of the room.
the plain one	Share this. Friends use it to ask to join.

The Invite button adds the plain one to your clipboard.

Want an extra guardrail? Start with collab --room-password <pw>. Then friends have to type the password before they can even ask to join. You still choose who gets admitted.

Roles

Role	Can watch	Can type	Can run the room
👁 viewer	yes	no	no
✎ prompter (normal)	yes	yes	no
★ host (you)	yes	yes	yes

"Run the room" means let people in, remove them, pause, or end it.

How it works

• Everyone who can type gets their own little box at the bottom to write in. Type there and press Enter to send. Your box stays open, so you can keep going. If Claude is busy, your message will get queued.
• Want to write a message together with someone? Click + draft to open a shared box you both type in.
• To talk to Claude directly (to approve y/n questions, answer questions, etc) click Claude's CLI text line.
• Everyone sees the same screen, and scrolling is shared.

Important note

When a friend types something, it runs on your computer, as if you typed it. So only let in people you trust. You can hit Pause anytime, or End to close the room.

Run your own server (optional)