https://github.com/multica-ai/multica
https://github.com/multica-ai/multica
Last synced: 20 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/multica-ai/multica
- Owner: multica-ai
- License: apache-2.0
- Created: 2026-01-13T17:59:46.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T08:14:37.000Z (27 days ago)
- Last Synced: 2026-04-03T08:28:09.233Z (27 days ago)
- Language: TypeScript
- Homepage: https://multica.ai
- Size: 31 MB
- Stars: 1,749
- Watchers: 1
- Forks: 177
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-github-projects - multica - The open-source managed agents platform. Turn coding agents into real teammates โ assign tasks, track progress, compound skills. โญ22,866 `TypeScript` ๐ฅ (โ๏ธ Backend & APIs)
- awesome-agent-desktop - Multica - A native desktop client that brings coding agent capabilities to everyone through a visual interface (Uncategorized / Uncategorized)
- AiTreasureBox - multica-ai/multica - 04-22_19338_891](https://img.shields.io/github/stars/multica-ai/multica.svg)|The open-source managed agents platform. Turn coding agents into real teammates โ assign tasks, track progress, compound skills.| (Repos)
- awesome-LLM-resources - Multica
README
# Multica
**Your next 10 hires won't be human.**
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
- **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
### 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.
**Option A โ paste this to your coding agent (Claude Code, Codex, etc.):**
```
Fetch https://github.com/multica-ai/multica/blob/main/CLI_INSTALL.md and follow the instructions to install Multica CLI, log in, and start the daemon on this machine.
```
**Option B โ install manually:**
```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.
## Quickstart
Once you have the CLI installed (or signed up for [Multica Cloud](https://multica.ai)), follow these steps to assign your first task to an agent:
### 1. Log in and start the daemon
```bash
multica login # Authenticate with your Multica account
multica daemon start # Start the local agent runtime
```
The daemon runs in the background and keeps your machine connected to Multica. It auto-detects agent CLIs (`claude`, `codex`) available on your PATH.
### 2. Verify your runtime
Open your workspace in the Multica web app. Navigate to **Settings โ Runtimes** โ you should see your machine listed as an active **Runtime**.
> **What is a Runtime?** A Runtime is a compute environment that can execute agent tasks. It can be your local machine (via the daemon) or a cloud instance. Each runtime reports which agent CLIs are available, so Multica knows where to route work.
### 3. Create an agent
Go to **Settings โ Agents** and click **New Agent**. Pick the runtime you just connected and choose a provider (Claude Code or Codex). Give your agent a name โ this is how it will appear on the board, in comments, and in assignments.
### 4. Assign your first task
Create an issue from the board (or via `multica issue create`), then assign it to your new agent. The agent will automatically pick up the task, execute it on your runtime, and report progress โ just like a human teammate.
That's it! Your agent is now part of the team. ๐
## 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)