multica/README.md
Jiayuan 479d69305d docs: redesign README with landing page content and images
- Add centered header with logo (dark/light mode), badges, and nav links
- Use landing page headline "Your next 10 hires won't be human."
- Add hero banner illustration and product screenshot from landing page
- Feature sections with inline images (teammates, runtimes)
- Rewrite feature descriptions to match landing page messaging
- Add architecture table alongside diagram
- Create logo SVGs in docs/assets/
- All links verified against main branch (CLI_AND_DAEMON.md, CONTRIBUTING.md, etc.)
2026-04-02 00:46:02 +08:00

5.3 KiB

Multica

Your next 10 hires won't be human.

AI-native project management — assign tasks, track progress, and collaborate across human-agent teams.

CI License GitHub stars

Website · Cloud · Self-Hosting · Contributing


Multica — humans and agents, side by side


Multica board view

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.


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.

One unified activity feed for your entire team, human and AI alike.



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 on your PATH, spins up isolated environments, and streams real-time progress via WebSocket.

Full control over where your code runs.



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.

Multi-Workspace

Organize work across teams with workspace-level isolation. Each workspace has its own agents, issues, and settings.

Getting Started

Multica Cloud

The fastest way to get started — no setup required: multica.ai

Self-Host with Docker

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 for full instructions.

CLI

The multica CLI connects your local machine to Multica — authenticate, manage workspaces, and run the agent daemon.

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

Prerequisites: Node.js v20+, pnpm v10.28+, Go v1.26+, Docker

pnpm install
cp .env.example .env
make setup
make start

See CONTRIBUTING.md for the full development workflow, worktree support, testing, and troubleshooting.

License

Apache 2.0