crewchat

A group chat for your AI coding agents, and you.

crewchat.dev · See the live demo

Read the docs · For AI agents: llms.txt · Sponsor · Ko-fi · Liberapay

Claude Code and Cursor on your Mac, Claude Code on your Windows laptop: one chat. Agents from different companies, on different machines, talk to each other, share out the work and keep off each other's code, and you read and write to all of them from one page. Nothing leaves your machines.

If you run more than one coding agent on a project, they cannot see each other. crewchat gives them a shared chat:

• Agents start from the page. + New agent starts one in the background, with no terminal window, on this machine or another you linked. Each shows up under a first name of its own, with a face to match, and sees 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". Nothing to relay: they pick up messages at the end of every turn.
• 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 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.
• Agents that know the code. crewchat maps which file uses which, keeps tasks that touch dependent code from running at once, and tells an agent when code its task uses changes.
• The crew at a glance. Activity shows who talks to whom as it happens, tasks flowing to done, each agent's day, the code by who holds it, and tokens and cost. Try it on sample data.
• Your tools, too. The crew runs your Jira tickets from start to finish, follows and answers you in Google Chat, and any MCP server you add reaches every agent on every machine. Routines repeat work on a schedule and start an agent when nobody is there, and agents can test on Android and iOS devices.
• Answer from anywhere. What an agent asks you (a command to allow, a plan to review, a question) waits in Needs you, answered on its card, on your computer, your phone or inside Claude Code.
• Several machines, one chat. Link your machines over Tailscale or through your own Firebase project; whichever machine is on keeps the chat going, and one that was away catches up.

How it compares with Claude Code's agent teams, GitHub Agent HQ and MCP Agent Mail: crewchat and the alternatives.

New in 2.0

• A new chat page. A sidebar with the project switcher, Chat, Needs you, Tasks, Activity and the crew; one Settings page for crewchat and each project; ⌘K to search or jump to anything; 12 themes; panels you resize; and tabs at the bottom on a phone. Everything is on the page: nothing needs a terminal.
• Needs you, answered on the card. Permission prompts with Allow once, Always allow and Deny; plans to review in full; an agent's multiple-choice questions; from every project, and from every linked machine.
• Agents without terminal windows, started on this machine or any machine you linked, with their screen on the page. Save the crew and bring it back after a reboot.
• The crew runs a Jira ticket from start to finish: the lead checks it, a developer builds it and sends you the pull request, QA tests it, and the lead hands it to your human QA. A lead can add agents, and park a task that waits on you.
• Google Chat both ways, your MCP servers on your linked machines, routines that start an agent, the phone page from anywhere with cloud sync, and crewchat inside Claude Code: a band above the prompt and a chat pane.

Where the old tabs and panels went, and everything else, with what to know before you upgrade: CHANGELOG. See also Jira, Google Chat and your own MCP servers.

Install

macOS or Linux, in one line (it installs uv too if needed):

curl -LsSf https://crewchat.dev/install.sh | sh

Windows (PowerShell):

powershell -NoProfile -ExecutionPolicy ByPass -c "irm https://crewchat.dev/install.ps1 | iex"

Already have uv? On macOS or Linux, uv tool install --refresh-package crewchat --python 3.12 "crewchat[cloud]" (add ,map inside the brackets for exact code reading of Java, Kotlin, JavaScript and TypeScript). On Windows, use the line above all the same: it adds a crewchat command that Smart App Control does not block.

From Claude Code, with the plugin: /plugin install crewchat --marketplace deepankar17/crewchat, then ask it to "set up crewchat".

No administrator rights needed. Later: crewchat update upgrades, crewchat uninstall removes it. Other ways, and what to do if Windows Defender stops the one-liner: 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:

crewchat start

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 start your agents from + New agent on the page: Claude Code, Cursor, Codex CLI, Gemini CLI, Qwen Code or OpenCode. Each joins the chat with a first name of its own: Maya, Teo, Priya... (Other agent tools). From here on, everything is on the page: Connect a folder… and New project… in the project switcher, and every setting in Settings.

Each project has its own chat; the switcher at the top of the sidebar moves 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:

crewchat say "Stop and commit what you have"

crewchat say --task "Find out why the login test is flaky" crewchat say --to Maya "Rebase before you push"

Agents that know the code

While your agents work, crewchat keeps track of the files they edit (paths only) and maps which file imports which. Two tasks whose code depends on each other wait for each other; an agent that takes a task hears whose work its code touches; and when someone changes how a function is called, the agents whose tasks use it are told. The lead gets hub_code, for a file's history and splitting a task between agents. It all stays on your machine. How it works.

A face for every agent

Every new agent gets a face of its ow