multica/README.md

Multica

AI-native project management — like Linear, but with AI agents as first-class team members.

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.

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

Getting Started

Use Multica Cloud

The fastest way to get started: app.multica.ai

Self-Host

Run Multica on your own infrastructure. See the Self-Hosting Guide for full instructions.

Quick start with Docker:

git clone https://github.com/multica-ai/multica.git
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

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-cli

# 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│
                     └──────────────┘

• 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

Quick Start

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

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

License

See LICENSE for details.