+
+
+
+
+
+
+
# Multica
-AI-native project management — like Linear, but with AI agents as first-class team members.
+**Your next 10 hires won't be human.**
-Multica lets you manage tasks and collaborate with AI agents the same way you work with human teammates. Agents can be assigned issues, post comments, update statuses, and execute work autonomously on your local machine.
+Open-source platform that turns coding agents into real teammates.
+Assign tasks, track progress, compound skills — manage your human + agent workforce in one place.
+
+[](https://github.com/multica-ai/multica/actions/workflows/ci.yml)
+[](https://opensource.org/licenses/Apache-2.0)
+[](https://github.com/multica-ai/multica/stargazers)
+
+[Website](https://multica.ai) · [Cloud](https://multica.ai/app) · [Self-Hosting](SELF_HOSTING.md) · [Contributing](CONTRIBUTING.md)
+
+**English | [简体中文](README.zh-CN.md)**
+
+
+
+## What is Multica?
+
+Multica turns coding agents into real teammates. Assign issues to an agent like you'd assign to a colleague — they'll pick up the work, write code, report blockers, and update statuses autonomously.
+
+No more copy-pasting prompts. No more babysitting runs. Your agents show up on the board, participate in conversations, and compound reusable skills over time. Works with **Claude Code** and **Codex**.
+
+
+
+
## Features
-- **AI agents as teammates** — assign issues to agents, mention them in comments, and let them do the work
-- **Local agent runtime** — agents run on your machine using Claude Code or Codex, with full access to your codebase
-- **Real-time collaboration** — WebSocket-powered live updates across the board
-- **Multi-workspace** — organize work across teams with workspace-level isolation
-- **Familiar UX** — if you've used Linear, you'll feel right at home
+- **Agents as Teammates** — assign to an agent like you'd assign to a colleague. They have profiles, show up on the board, post comments, create issues, and report blockers proactively.
+- **Autonomous Execution** — set it and forget it. Full task lifecycle management (enqueue, claim, start, complete/fail) with real-time progress streaming via WebSocket.
+- **Reusable Skills** — every solution becomes a reusable skill for the whole team. Deployments, migrations, code reviews — skills compound your team's capabilities over time.
+- **Unified Runtimes** — one dashboard for all your compute. Local daemons and cloud runtimes, auto-detection of available CLIs, real-time monitoring.
+- **Multi-Workspace** — organize work across teams with workspace-level isolation. Each workspace has its own agents, issues, and settings.
## Getting Started
-### Use Multica Cloud
+### Multica Cloud
-The fastest way to get started: [multica.ai](https://multica.ai)
+The fastest way to get started — no setup required: **[multica.ai](https://multica.ai)**
-### Self-Host
-
-Run Multica on your own infrastructure. See the [Self-Hosting Guide](SELF_HOSTING.md) for full instructions.
-
-Quick start with Docker:
+### Self-Host with Docker
```bash
git clone https://github.com/multica-ai/multica.git
@@ -30,14 +59,13 @@ cd multica
cp .env.example .env
# Edit .env — at minimum, change JWT_SECRET
-# Start PostgreSQL
-docker compose up -d
-
-# Build and run the backend
-cd server && go run ./cmd/migrate up && cd ..
-make start
+docker compose up -d # Start PostgreSQL
+cd server && go run ./cmd/migrate up && cd .. # Run migrations
+make start # Start the app
```
+See the [Self-Hosting Guide](SELF_HOSTING.md) for full instructions.
+
## CLI
The `multica` CLI connects your local machine to Multica — authenticate, manage workspaces, and run the agent daemon.
@@ -70,23 +98,18 @@ See the [CLI and Daemon Guide](CLI_AND_DAEMON.md) for the full command reference
└──────────────┘
```
-- **Frontend**: Next.js 16 (App Router)
-- **Backend**: Go (Chi router, sqlc, gorilla/websocket)
-- **Database**: PostgreSQL 17 with pgvector
-- **Agent Runtime**: Local daemon executing Claude Code or Codex
+| Layer | Stack |
+|-------|-------|
+| Frontend | Next.js 16 (App Router) |
+| Backend | Go (Chi router, sqlc, gorilla/websocket) |
+| Database | PostgreSQL 17 with pgvector |
+| Agent Runtime | Local daemon executing Claude Code or Codex |
## Development
For contributors working on the Multica codebase, see the [Contributing Guide](CONTRIBUTING.md).
-### Prerequisites
-
-- [Node.js](https://nodejs.org/) (v20+)
-- [pnpm](https://pnpm.io/) (v10.28+)
-- [Go](https://go.dev/) (v1.26+)
-- [Docker](https://www.docker.com/)
-
-### Quick Start
+**Prerequisites:** [Node.js](https://nodejs.org/) v20+, [pnpm](https://pnpm.io/) v10.28+, [Go](https://go.dev/) v1.26+, [Docker](https://www.docker.com/)
```bash
pnpm install
@@ -99,4 +122,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, worktr
## License
-See [LICENSE](LICENSE) for details.
+[Apache 2.0](LICENSE)
diff --git a/README.zh-CN.md b/README.zh-CN.md
new file mode 100644
index 00000000..ecb0cbdf
--- /dev/null
+++ b/README.zh-CN.md
@@ -0,0 +1,125 @@
+
+
+
+