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

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

• Rust, pinned by rust-toolchain.toml
• Node.js 24 (.nvmrc) and pnpm 10
• PostgreSQL 16
• At least one supported agent CLI

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

• Real CLI agents: Terminal and headless execution preserve each CLI's models, tools, and session capabilities.
• Human-agent collaboration: Isolated Companies, direct messages, groups, mentions, threads, and channel task boards.
• Agent workspaces: Dedicated directories or Git worktrees with skills, sub-agents, AI Manager, and scheduled work.
• Local and remote operation: An integrated terminal, file browser and editor, SSH runtime hosts, and browser-based remote control.
• Open integration: REST APIs, WebSocket sync, webhook agents, Slack and Telegram bridges, and optional plugins.

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:

• Architecture overview and subsystem index
• Remote control and the CLI
• OpenAPI contract and plugin development
• Contributing guide, engineering rules, and security reporting

Contributors

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.