multica README

The project's README from github.com/multica-ai/multica. As one markdown file: README.md.

Multica

Multica

Agents that show up on the board.

Multica is a source-available workspace where you assign work to AI coding agents the way you'd assign it to a teammate — they pick up the issue, report progress, raise blockers, and hand it back for review. Self-hostable, works with the agent CLIs you already use, no lock-in.

CI Release GitHub stars Discord

Star History Rank GitHub Trending Repository of the Day

Website · Docs · Quickstart · Download · Vision · Self-Hosting · Discord · X

English | 简体中文

A Multica board where agents and their human teammates are moving work across columns

Your next 10 hires won't be human.

What is Multica?

You already run Claude Code, Codex, and three other agents. Each one lives in its own terminal tab, forgets everything when the session ends, and leaves you re-explaining the same context for the fourth time today. The more agents you add, the more of your day goes to babysitting them.

Multica puts those agents and your teammates in one workspace. An agent gets assigned an issue, picks it up on its own, works on a runtime you control, comments as it goes, and hands the result back for review. The intent, the run, the decisions, and the diff stay connected to the same issue — so nobody reconstructs context, and nothing ships without a human saying so.

Build the team.

Claude Code, Codex, Cursor, Kimi — you don't pick one. You hire them all.

Hand off the work.

It starts as three rough sentences in an issue. It ends as a pull request.

Stay in the loop.

Which agent touched this? What did it run? What did it cost? Open the run.

Make it yours.

Your machines, your Git host, your rules — with an audit trail that includes the robots.

Get started

The one prerequisite: the machine that will run agents needs at least one supported agent CLI installed and signed in — Claude Code, Codex, Cursor, and friends. Multica drives them; it doesn't ship them.

Self-hosting the whole thing 
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host

On Windows, set $env:MULTICA_MODE="with-server", then run the PowerShell installer: irm https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.ps1 | iex.

This pulls the official images from GHCR and requires Docker. See the Self-Hosting Guide; if the selected GHCR tag has not been published yet, fall back to make selfhost-build from a checkout.

A self-hosted server sends one anonymous, deployment-level snapshot a day: the release version plus bucketed counts, with no names, content, or IDs. Set DO_NOT_TRACK=1 on the API server to turn it off — what's collected.

Your first agent in five minutes

1. Connect a computer. A runtime is any machine agents can work on — your laptop, or a cloud box. Desktop registers the computer it's running on automatically and detects the agent CLIs installed there. On the web — or to add another machine — open Runtimes in the sidebar, click Add a computer, and paste the two commands it shows into a terminal on that machine.

2. Create an agent. Open Agents in the sidebar and click New agent. Pick the runtime you just connected, pick a provider, and give it a name — or let Build with AI generate the configuration from a description. That name is how it shows up on the board and in comments.

3. Assign it something. File an issue and set the agent as assignee. It picks the task up, runs it on your machine, comments as it goes, and moves the issue to review when it's done.

Full walkthrough: Quickstart · Tutorial

Runtimes

Multica does not ship a model. It drives the agent CLIs you already have installed and authenticated — 26 of them today — so switching providers is a dropdown, not a migration.

Provider CLI Provider CLI
Claude Code claude OpenAI Codex codex
Cursor Agent cursor-agent GitHub Copilot CLI copilot
OpenCode opencode OpenClaw openclaw
Hermes hermes Pi pi
Antigravity agy CodeBuddy codebuddy
DevEco Code deveco Grok grok
Kimi kimi Kiro CLI kiro-cli
Qoder CLI qodercli Qoder CN qoderclicn
Qwen Code qwen QwenPaw qwenpaw
Reasonix reasonix Trae CLI traecli
DeepSeek Harness dsh Oh-My-Pi omp
MiniMax Code mcode Dim dim
Huawei Cloud CodeArts codearts ZeroClaw zeroclaw

Installing and authenticating them: Install an agent runtime · Providers

Documentation

I want to… Start here
Get an agent doing something today Quickstart · Tutorial
Understand how the pieces fit Core concepts · How Multica works
Create and configure agents Agents · Create an agent · Skills
Get work to an agent Triggering agents · Assigning issues · Mentions
Connect my machines Daemon and runtimes · Install an agent runtime
Connect Git and chat tools GitHub · Self-hosted Git · Channels
Run it on my own infrastructure Self-hosting · Security model · Environment variables
Script it CLI reference · CLI and daemon guide · Auth tokens
Drive Multica from Codex, Claude Code, or Cursor Multica CLI skill
Work out why an agent is stuck Runs · Troubleshooting

The docs are also available in 简体中文, 日本語, 한국어, and Français.

Architecture

   Web (browser)        Desktop (Electron)        iPhone · iPad (Expo)
         │                      │                          │
         ▼                      │                          │
  ┌──────────────┐              │                          │
  │   Next.js    │              │                          │
  │ pages + API  │              │                          │
  │    proxy     │              │                          │
  └──────┬───────┘              │  HTTPS + WebSocket       │
         ▼                      ▼                          ▼
  ┌───────────────────────────────────────────────────────────┐   ┌───────────────┐
  │                Go backend  (Chi + WebSocket)              │──>│ PostgreSQL 17 │
  └─────────────────────────────┬─────────────────────────────┘   └───────────────┘
                                │  runs over WebSocket
                        ┌───────┴────────┐
                        │  Agent daemon  │  runs on your machine, next to your code
                        └───────┬────────┘
                                │  spawns
              ┌─────────────────┴──────────────────┐
              │  Claude Code · Codex · Cursor · …  │
              └────────────────────────────────────┘
Layer Stack
Web Next.js 16 (App Router)
Desktop Electron, sharing the web UI packages
Mobile Expo / React Native (iPhone and iPad)
Backend Go (Chi router, sqlc, gorilla/websocket)
Database PostgreSQL 17 (pgcrypto + pg_trgm)
Agent runtime Local daemon executing any supported agent CLI

Development

Contributors: start with the Contributing Guide.

Prerequisites: Node.js 22, pnpm 10.28.2, Go 1.26.9, Docker

make dev

make dev auto-detects your environment (main checkout or worktree), creates the env file, installs dependencies, sets up the database, runs migrations, and starts every service.

See CONTRIBUTING.md for the full workflow, worktree support, testing, and troubleshooting. The iOS client lives in apps/mobile/ — its README covers building it onto your own device.

We release most weekdays, so main moves quickly — pull often.

Why "Multica"?

Multiplexed Information and Computing Agent — a nod to Multics, the 1960s operating system that introduced time-sharing so several people could use one machine as if each had it to themselves.

Software teams have been single-threaded ever since: one engineer, one task, one context switch at a time. We think agents make time-sharing relevant again, except the users multiplexing the system are now both humans and machines. A small team shouldn't feel small.

The longer argument, and where we think this goes: VISION.md.

License

Multica License — the complete Apache License 2.0 text plus additional conditions covering hosted services, commercial embedding, and branding. Self-host it, modify it, build on it; the exact terms are in the LICENSE, attribution notices in NOTICE.

multica (multica-ai/multica)

Searching Database…

53K ·GitHub
Multica
这是什么？Multica 是一个可自建部署的工作区，你可以像把活儿分给同事一样，把任务分配给 AI 编码智能体（Claude Code、Codex、Cursor 等）。它们接手任务、汇报进度，完成后再交回给你审核。
这是一个库还是完整的应用？这是一个完整的应用，包含网页端、桌面端（Electron）和移动端（iOS）客户端，后端基于 Go，数据库为 PostgreSQL，并不是可以导入代码里使用的库。
我该怎么把它跑起来？注册 multica.ai 使用云端服务，下载 Multica Desktop（支持 macOS/Windows/Linux），或用 Docker Compose / Helm 自建整套服务。在 Windows 上自建时，先设置 $env:MULTICAMODE="with-server"，再运行从 GHCR 拉取镜像的 PowerShell 安装脚本。
我需要先装好编码智能体的 CLI 吗？需要。前提条件是：运行智能体的机器上至少要装好并登录一个受支持的智能体 CLI，例如 Claude Code、Codex 或 Cursor。Multica 是驱动这些 CLI 工作的，并不附带，也不替代它们。
iOS 版能在 App Store 下载吗？目前还不行。iOS 版只能从源码编译后安装到你自己的设备上，尚未上架 App Store。
它能在哪些平台上运行？同一个工作区可在 macOS、Windows、Linux 上使用，也有适用于 iPhone 和 iPad 的移动端应用，另外还提供网页版。
自建会把数据发回你们那边吗？自建服务器每天只发送一份匿名的部署级快照，包括发布版本和分档计数，不含名称、内容或 ID。设置 DONOTTRACK=1 即可关闭。
Multica 支持多少种智能体 CLI？目前支持 26 个服务商，包括 Claude Code、Codex、Cursor、Copilot、Kimi、OpenCode、Grok 等。切换只需在下拉菜单里选一下，无需迁移。
智能体能按计划无人值守地工作吗？可以，通过 Autopilots 实现。它可以按 cron 定时运行每日站会、审计和报告，无需有人手动触发。
我能在智能体执行任务途中和它聊天吗？可以。智能体工作期间你可以回复，消息会进入当前这一轮运行，而不是排到下一轮。目前支持 Claude Code、Codex 和 Grok。
为什么叫 Multica？它是 Multiplexed Information and Computing Agent 的缩写，致敬 1960 年代的分时操作系统 Multics，寓意人与智能体如今都在同一个系统上复用工作。
What are similar projects?vicoa, 1code, trueforge, evenfire, nocobase, shipyard, Termix, paperclip
Which topics is it in?kanban, helm, project-management, slack, react-native, workflow-automation, agent-orchestration, nextjs, electron, kubernetes, postgresql, docker-compose
Creator
multica-ai
Size
158.4 MB
Stars
53K
Updated
CommitOct 16Releasev0.6.3Oct 16
Age
9mo
Commits · 90 Days