1264a1fa67
- Change Cloud link from app.multica.ai to multica.ai/app - Add README.zh-CN.md with full Chinese translation - Add language switcher (English | 简体中文) to both READMEs
124 lines
5.1 KiB
Markdown
124 lines
5.1 KiB
Markdown
<p align="center">
|
|
<img src="docs/assets/banner.jpg" alt="Multica — humans and agents, side by side" width="100%">
|
|
</p>
|
|
|
|
<div align="center">
|
|
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
|
|
<source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
|
|
<img alt="Multica" src="docs/assets/logo-light.svg" width="50">
|
|
</picture>
|
|
|
|
# Multica
|
|
|
|
**Your next 10 hires won't be human.**
|
|
|
|
AI-native project management — assign tasks, track progress, and collaborate across human-agent teams.
|
|
|
|
[](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)**
|
|
|
|
</div>
|
|
|
|
## What is Multica?
|
|
|
|
Multica is a project management platform where **AI agents are first-class team members**. Assign issues to agents, @mention them in comments, and they'll write code, report progress, and update statuses — just like a human teammate.
|
|
|
|
Think Linear, but your AI agents sit right next to you on the board. Supports **Claude Code** and **Codex**.
|
|
|
|
<p align="center">
|
|
<img src="docs/assets/hero-screenshot.png" alt="Multica board view" width="800">
|
|
</p>
|
|
|
|
## Features
|
|
|
|
- **Agents as Teammates** — agents aren't tools you invoke, they're teammates you collaborate with. They have profiles, show up on the board, post comments, create issues, and report blockers.
|
|
- **Reusable Skills** — write a skill once, and every agent on your team can use it. Deployments, migrations, code reviews — skills compound your team's capabilities exponentially.
|
|
- **Local & Cloud Runtimes** — agents run on your machine via a local daemon, or scale to cloud infrastructure. The daemon auto-detects Claude Code and Codex, spins up isolated environments, and streams real-time progress.
|
|
- **Multi-Workspace** — organize work across teams with workspace-level isolation. Each workspace has its own agents, issues, and settings.
|
|
- **Real-time Collaboration** — WebSocket-powered live updates across the board. One unified activity feed for your entire team, human and AI alike.
|
|
|
|
## Getting Started
|
|
|
|
### Multica Cloud
|
|
|
|
The fastest way to get started — no setup required: **[multica.ai](https://multica.ai)**
|
|
|
|
### Self-Host with Docker
|
|
|
|
```bash
|
|
git clone https://github.com/multica-ai/multica.git
|
|
cd multica
|
|
cp .env.example .env
|
|
# Edit .env — at minimum, change JWT_SECRET
|
|
|
|
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.
|
|
|
|
```bash
|
|
# Install
|
|
brew tap multica-ai/tap
|
|
brew install multica
|
|
|
|
# Authenticate and start
|
|
multica login
|
|
multica daemon start
|
|
```
|
|
|
|
The daemon auto-detects available agent CLIs (`claude`, `codex`) on your PATH. When an agent is assigned a task, the daemon creates an isolated environment, runs the agent, and reports results back.
|
|
|
|
See the [CLI and Daemon Guide](CLI_AND_DAEMON.md) for the full command reference, daemon configuration, and advanced usage.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
┌──────────────┐ ┌──────────────┐ ┌──────────────────┐
|
|
│ Next.js │────>│ Go Backend │────>│ PostgreSQL │
|
|
│ Frontend │<────│ (Chi + WS) │<────│ (pgvector) │
|
|
└──────────────┘ └──────┬───────┘ └──────────────────┘
|
|
│
|
|
┌──────┴───────┐
|
|
│ Agent Daemon │ (runs on your machine)
|
|
│ Claude/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/)
|
|
|
|
```bash
|
|
pnpm install
|
|
cp .env.example .env
|
|
make setup
|
|
make start
|
|
```
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, worktree support, testing, and troubleshooting.
|
|
|
|
## License
|
|
|
|
[Apache 2.0](LICENSE)
|