Multica Repository Analysis
multica
Multica Repository Analysis
Generated 2026-04-25. Based on commit
5eab1dbb(main branch).
Documents
| # | Document | What It Covers |
|---|---|---|
| 1 | Overview & Purpose | What Multica does, the problem it solves, target users |
| 2 | Tech Stack | Languages, frameworks, dependencies, and why they were chosen |
| 3 | Architecture | Component diagram, data flows, dependency rules, multi-tenancy |
| 4 | Entry Points & Execution Flow | Server/CLI/frontend boot sequences, state machines, request lifecycle |
| 5 | Design Patterns & Decisions | 10 patterns identified, tradeoffs, what's unusual/clever |
| 6 | Key Files Map | Essential files by responsibility, important prompts |
| 7 | LLM Integration | Agent system, 10 providers, prompt engineering, guardrails, token tracking |
| 8 | Takeaways & Pitfalls | Ideas worth stealing, risks to watch, architectural lessons |
| 9 | Multica vs Single Agents | Why Multica exists as an orchestration layer above Claude Code et al. |
| 10 | Swisscheese Differentiators | 6 high-impact differentiators for a multi-agent AI code review platform |
Quick Mental Model
┌──────────────────────────────────────────────────────────────────┐
│ USER INTERFACES │
│ Next.js Web App (3000) Electron Desktop App │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ packages/views/ │◄───────►│ packages/views/ │ │
│ │ packages/core/ │ shared │ packages/core/ │ │
│ │ packages/ui/ │ code │ packages/ui/ │ │
│ └─────────┬───────────┘ └─────────┬───────────┘ │
└────────────┼─────────────────────────────────┼──────────────────┘
│ HTTP/REST + WebSocket │
└──────────────┬──────────────────┘
│
┌───────────────────────────┼──────────────────────────────────────┐
│ GO BACKEND (8080) │
│ │ │
│ Chi Router ──► Handler ──► Service ──► sqlc Queries │
│ │ │ │ │
│ Middleware Event Bus ──► Listeners ──► Hub (WebSocket) │
│ (Auth, RBAC) │ │ │
│ PostgreSQL 17 Redis (optional) │
└──────────────────────────────────────────────────────────────────┘
│
Daemon API
│
┌───────────────────────────┼──────────────────────────────────────┐
│ LOCAL DAEMON │
│ │ │
│ Task Poller ──► execenv (workdir, CLAUDE.md) ──► Agent CLI │
│ │ │ │
│ Heartbeat claude / codex / │
│ GC / Sweep copilot / gemini / │
│ cursor / hermes / │
│ + 4 more │
└──────────────────────────────────────────────────────────────────┘
The One-Sentence Summary
Multica is an agent-agnostic task management platform where AI coding agents and humans share the same issue tracker, using a local daemon to bridge between the server and 10 different agent CLIs, with a monorepo frontend that shares >90% of code between web and desktop via strict package boundaries.