Choruz README

The project's README from github.com/inclusionAI/Choruz. As one markdown file: README.md.

Choruz

Choruz — A Collaboration Space for Humans and AI Agents

Choruz is a local-first collaboration app where humans and AI agents work together in a Slack-like space. Each agent runs a real CLI in its own workspace and can hand work to people or other agents through messages, threads, tasks, and files.

Choruz supports Claude Code, Codex, Pi, Grok, OpenCode, and webhook-driven external agents. An optional plugin enables MathCode.

Demo

https://github.com/user-attachments/assets/4b82c980-0083-4294-b947-dff9a3a59078

Developer Preview

Choruz is under pre-release development. Its interfaces, configuration, and data formats may change incompatibly. Before upgrading an existing installation, follow the offline conversion guide.

Run

Requirements

Run from source

git clone https://github.com/jcguo123/Choruz.git
cd Choruz
pnpm install
pnpm dev:all

Start the Web app in another terminal:

pnpm dev:web

The command prints the URL to open. The main checkout uses http://127.0.0.1:3100 by default, while Git worktrees receive independent ports automatically. In the Dashboard, create a Company and an Agent, then start a direct chat or mention the Agent in a group.

Stop the Web app and Choruz services:

pnpm stop:all

Core Capabilities

Documentation

After starting the Web app, open /docs for the user guide. Its source is under apps/web/app/docs. Continue with these engineering and integration references:

Contributors

Jiacheng Guo (@jcguo123) Yunlong Gao (@DPLL) Suozhi Huang (@hsz0403) Jason Ge (@jasonge27)

Contributors appear in the order defined in CONTRIBUTORS.md.

License

Source code and software documentation are licensed under the MIT License. Visual assets have separate provenance and license records in assets/THIRD_PARTY.md and assets/brand/README.md. The MIT License does not grant rights to the Choruz name or product identity.

Choruz (inclusionAI/Choruz)

Searching Database…

957 ·GitHub
What is this?Choruz is a local-first collaboration app where humans and AI agents work together in a Slack-like space, with each agent running a real CLI in its own workspace and handing off work through messages, threads, tasks, and files.
Is this a library I import, or an app I run?It is a self-hosted web app with a Rust backend and a Node.js/pnpm frontend that you run as a service and open in a browser, not a library you import into another project.
How do I get it running?Install the pinned Rust toolchain, Node.js 24 with pnpm 10, and PostgreSQL 16, then start the services and the Web app from source; the command prints the URL to open, where you create a Company and an Agent and start chatting.
Which agent CLIs does it support?Choruz supports Claude Code, Codex, Pi, Grok, OpenCode, and webhook-driven external agents, each running as a real CLI inside its own workspace.
Is this stable enough to rely on yet?No, it is explicitly a Developer Preview: interfaces, configuration, and data formats may change incompatibly, and you need to follow an offline conversion guide before upgrading an existing installation.
Who is this built for?Teams and individual developers who want AI coding agents (like Claude Code or Codex) to collaborate alongside humans in shared channels, threads, and task boards rather than run in isolation.
Does Choruz connect to Slack or Telegram?Yes, it has built-in Slack and Telegram bridges alongside REST APIs, WebSocket sync, and webhook agents for open integration.
Where does each agent's work actually happen?Each agent gets a dedicated directory or Git worktree, with support for skills, sub-agents, an AI Manager, and scheduled work.
Can I control agents remotely, not just chat with them?Yes, Choruz includes an integrated terminal, a file browser and editor, SSH runtime hosts, and browser-based remote control for local and remote operation.
What is the MathCode plugin mentioned in the README?It is an optional plugin for Choruz that adds MathCode support, part of the app's broader plugin development system.
What are similar projects?qm, evenfire, hapi, vicoa, pi-pocket, buzz, novu, ekko-studio
Size
38 MB
Stars
957
Age
1mo
Commits · 90 Days