marketing-shibata50/multica

Fork 0

The open-source managed agents platform. Turn coding agents into real teammates — assign tasks, track progress, compound skills. https://multica.ai

Find a file

Jiayuan Zhang 88582fe050 docs(development): restore dev-local workflow docs		2026-02-17 01:11:21 +08:00
.github/workflows	chore(ci): remove dependabot configuration (#189 )	2026-02-15 02:57:31 +08:00
apps	chore(docs): remove non-e2e documentation	2026-02-17 00:46:36 +08:00
docs	docs(development): restore dev-local workflow docs	2026-02-17 01:11:21 +08:00
packages	chore(docs): remove non-e2e documentation	2026-02-17 00:46:36 +08:00
scripts	chore(benchmark): remove hardcoded output directories from case prompts	2026-02-16 11:17:24 +08:00
skills	fix(skills): restore bundled skill documentation	2026-02-17 01:00:13 +08:00
.dockerignore	Add Docker support for Gateway and SDK documentation	2026-01-28 17:56:22 +08:00
.env.example	chore: add local dev script for Gateway + Desktop with Telegram bot	2026-02-14 00:39:43 +08:00
.gitignore	chore: add __pycache__ to gitignore and remove committed cache	2026-02-15 01:32:24 +08:00
.npmrc	refactor: restructure to monorepo architecture	2026-02-10 18:00:23 +08:00
AGENTS.md	docs: add AGENTS.md for OpenAI Codex compatibility	2026-02-01 18:55:26 +08:00
CLAUDE.md	docs: regenerate prioritized core documentation	2026-02-17 00:53:37 +08:00
package.json	revert(agent): remove parallel tool execution patch, keep serial	2026-02-15 20:43:37 +08:00
pnpm-lock.yaml	revert(agent): remove parallel tool execution patch, keep serial	2026-02-15 20:43:37 +08:00
pnpm-workspace.yaml	refactor: migrate from Hugeicons to Lucide icons	2026-02-12 10:12:56 +08:00
README.md	docs(development): restore dev-local workflow docs	2026-02-17 01:11:21 +08:00
tsconfig.base.json	refactor: restructure to monorepo architecture	2026-02-10 18:00:23 +08:00
tsconfig.json	Implement WebSocket Gateway with NestJS and client SDK	2026-01-28 16:46:51 +08:00
turbo.json	refactor: unify API URL env var to MULTICA_API_URL	2026-02-15 06:31:00 +08:00
vitest.config.ts	test: add vitest setup with static mock policy checker	2026-02-13 22:03:36 +08:00
vitest.setup.ts	test: add vitest setup with static mock policy checker	2026-02-13 22:03:36 +08:00

README.md

Super Multica

Super Multica is a monorepo for a distributed AI agent framework. It includes a local-first Desktop app, CLI, Gateway/Web access, and reusable core packages.

Current Documentation Strategy

The docs set is intentionally small and high-signal. For current status and priorities, see:

docs/README.md

Monorepo Layout

apps/
  cli/      @multica/cli       Command-line interface
  desktop/  @multica/desktop   Electron desktop app (primary local runtime)
  gateway/  @multica/gateway   NestJS WebSocket gateway
  server/   @multica/server    NestJS REST server
  web/      @multica/web       Next.js web app
  mobile/   @multica/mobile    React Native app

packages/
  core/     @multica/core      Agent, Hub, tools, channels, cron, heartbeat
  sdk/      @multica/sdk       Gateway client SDK
  ui/       @multica/ui        Shared React UI components
  store/    @multica/store     Zustand stores
  hooks/    @multica/hooks     Shared hooks
  types/    @multica/types     Shared types
  utils/    @multica/utils     Shared utilities

Quick Start

pnpm install
pnpm multica credentials init
pnpm multica

Run desktop app in dev mode:

pnpm dev

Local Full-Stack Development (`pnpm dev:local`)

Use this when you need Gateway + Web + Desktop together for end-to-end dev.

Setup:

Copy .env.example to .env in repo root
Set TELEGRAM_BOT_TOKEN in .env (from @BotFather)
Run:

pnpm dev:local

What starts:

Service	Address	Notes
Gateway	`http://localhost:4000`	Telegram long-polling mode
Web	`http://localhost:3000`	OAuth login flow
Desktop	—	Connects to local Gateway + Web

Data isolation:

runtime data: ~/.super-multica-dev
workspace data: ~/Documents/Multica-dev

pnpm dev:local:archive

Common Commands

# CLI
pnpm multica
pnpm multica run "Hello"
pnpm multica chat
pnpm multica help

# Development
pnpm dev
pnpm dev:desktop
pnpm dev:gateway
pnpm dev:web
pnpm dev:local
pnpm dev:local:archive

# Build / quality
pnpm build
pnpm typecheck
pnpm test

Runtime Data

By default, runtime data is stored under:

~/.super-multica

You can isolate environments with:

SMC_DATA_DIR=~/.super-multica-dev (or other path)

Core Docs

CLAUDE.md (AI coding guidance in this repo)
docs/development.md
docs/cli.md
docs/credentials.md
docs/skills-and-tools.md
docs/e2e-testing-guide.md
docs/e2e-finance-benchmark.md