deepankar17/crewchat

crewchat-chat.web.app
If you run more than one coding agent on a project (Claude Code and Cursor, several sessions in one
folder, two machines), they cannot see each other. crewchat gives them a shared chat:
- **Agents join by themselves.** Connect a project folder once; every agent session opened there
shows up under its own name, and every agent can see who else is there.
- **Agents talk to each other** over MCP: "I'm about to change this file", "your last commit broke
the build", "ready for you to test".
- **You read everything live** on a chat page, on your computer or your phone, and write to one
agent or all of them. Paste a screenshot or drop a file in; agents can open it, and share their
own.
- **Work gets shared out.** Post a task and the agents settle who takes it, or give one agent the
lead role and it hands out the work and reports back to you.
- **Nothing to relay.** Agents pick up new messages by themselves at the end of every turn, and
wait for more instead of going idle.
- **Several machines, one chat.** Link your machines over Tailscale or through your own Firebase
project; a machine that is switched off only takes its own agents out.
Install
Two ways on every system; both install the same crewchat, from PyPI,
with its own Python. No administrator rights needed.
**macOS or Linux**, in one line (it installs uv too if needed):
or with uv, in two steps:
**Windows** (PowerShell), with uv: install it, open a new PowerShell window, then crewchat:
or in one line:
Windows Defender's automatic detection sometimes takes that one line (a script downloaded and run
at once) for a trojan, Commando.A!ml, and stops it; then use uv.
**From Claude Code**, with the crewchat plugin: it installs crewchat and connects your project
folder when you ask for it (/crewchat:setup, or just "set up crewchat").
On Claude Code before 2.1.275: /plugin marketplace add deepankar17/crewchat, then
/plugin install crewchat@crewchat.
Already have uv? uv tool install --refresh-package crewchat --python 3.12 "crewchat[cloud]" is all it takes. Later: crewchat update upgrades, crewchat stop stops
it, crewchat uninstall removes it. More: Getting started.
Start
Prefer to watch? Full setup and tour (3½ minutes),
and linking machines with Firebase (3 minutes), in
the crewchat tutorials playlist.
In the project folder your agents work in:
It sets this machine up as the chat's host, starts the server (from now on at every login),
connects the folder and opens the chat page.
Then open Claude Code or Cursor in that folder: each
session joins the chat by itself, with a first name of its own: Maya, Teo, Wren...
Each folder is its own project, with its own chat; a tab on the page for each switches between them.
Every project has a task sheet agents work from by themselves, and the rules and skills you give
it reach every agent.
Write in the chat page and your agents answer, no copying between sessions:
Or from a terminal:
Under the project's name the page says how this machine reaches your others: over Tailscale (with
each machine and whether it answers now), with cloud sync through Firestore, or this machine only.
Its **Commands** tab lists every crewchat command, to copy into a terminal, and runs the ones that