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, Grok, and webhook-driven external agents by default. Plugins enable Pi, OpenCode, and MathCode; see plugin configuration.

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.

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

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

• 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.

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 appear in the order defined in CONTRIBUTORS.md.

Source code and software documentation are distributed under the Apache License 2.0, with incorporated-code notices retained in NOTICE. Dependencies and agent CLIs retain their own licenses and service terms. Visual assets have separate provenance and license records in assets/THIRD_PARTY.md and assets/brand/README.md. This license does not grant rights to the Choruz name or product identity.