marketing-shibata50/multica
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
The open-source managed agents platform. Turn coding agents into real teammates — assign tasks, track progress, compound skills. https://multica.ai
998 commits 1 branch 0 tags 31 MiB
Find a file
Jiayuan Zhang 6f67bb77b8 feat(skills): expose ineligible skills in system prompt for auto-discovery 
Add buildIneligibleSkillsSummary() to SkillManager that surfaces skills
with actionable issues (missing env vars, binaries) in the agent's system
prompt. Expand getApiKeyHint() with common service API providers. Update
buildSkillsSection() to guide the agent to suggest activating inactive
skills when they match user intent.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 13:34:51 +08:00
.github/workflows chore(ci): remove dependabot configuration (#189) 2026-02-15 02:57:31 +08:00
apps refactor(credentials): remove skills.env.json5 support 2026-02-15 13:34:51 +08:00
docs docs: update credential docs for per-skill .env files 2026-02-15 13:34:51 +08:00
packages feat(skills): expose ineligible skills in system prompt for auto-discovery 2026-02-15 13:34:51 +08:00
scripts Merge pull request #197 from multica-ai/forrestchang/create-pr 2026-02-15 13:09:52 +08:00
skills refactor(skills): merge check_fillable_fields into extract_form_field_info 2026-02-15 01:32:32 +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: update credential docs for per-skill .env files 2026-02-15 13:34:51 +08:00
package.json feat(report): add code stats report generator 2026-02-15 04:32:30 +08:00
pnpm-lock.yaml fix(gateway): add build stage for workspace packages in Dockerfile 2026-02-15 05:46:41 +08:00
pnpm-workspace.yaml refactor: migrate from Hugeicons to Lucide icons 2026-02-12 10:12:56 +08:00
README.md docs: remove obsolete design proposals and plans 2026-02-15 03:32:47 +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

Multiplexed Information & Computing Agent

An always-on AI agent that pulls real data, runs real computation, and takes real action — monitoring, analyzing, and acting within user-defined authorization boundaries.

See Memo for product vision, architecture, and roadmap.

Project Structure

apps/
├── cli/           # Command-line interface
├── desktop/       # Electron desktop app (recommended)
├── gateway/       # NestJS WebSocket gateway
├── server/        # NestJS REST API server
├── web/           # Next.js web app
└── mobile/        # React Native mobile app

packages/
├── core/          # Agent engine, hub, channels
├── sdk/           # Gateway client SDK
├── ui/            # Shared UI components (Shadcn/Tailwind v4)
├── store/         # Zustand state management
├── hooks/         # React hooks
├── types/         # Shared TypeScript types
└── utils/         # Utility functions

skills/            # Bundled agent skills

Quick Start

pnpm install

Development

pnpm dev              # Desktop app (standalone, no Gateway needed)
pnpm dev:gateway      # Gateway only
pnpm dev:web          # Web app only
pnpm dev:all          # Gateway + Web

Local Full-Stack Development

pnpm dev:local starts the entire stack locally (Gateway + Desktop + Web) with isolated data directories, useful for end-to-end development and testing.

Setup:

  1. Copy .env.example to .env at the repo root
  2. Fill in TELEGRAM_BOT_TOKEN (get from @BotFather)
  3. Run pnpm dev:local

What it 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: All data goes to ~/.super-multica-dev and ~/Documents/Multica-dev, separate from production ~/.super-multica.

Related commands:

pnpm dev:local:archive    # Archive dev data and start fresh

Architecture

Desktop App (standalone, recommended)
  └─ Hub (embedded)
     └─ Agent Engine

Web/Mobile Clients
  → Gateway (WebSocket, :3000)
    → Hub
      → Agent Engine
  • Desktop App: Electron app with embedded Hub, no Gateway needed
  • Gateway: WebSocket server for remote clients
  • Hub: Agent lifecycle and event distribution

Documentation

Getting Started

Topic Link
Development guide docs/development.md
Credentials & LLM providers docs/credentials.md
CLI usage docs/cli.md
Skills & tools docs/skills-and-tools.md
Package management docs/package-management.md
Mobile development docs/mobile/guide.md

Architecture & Protocols

Topic Link
Product capabilities docs/product-capabilities.md
Message paths (Desktop/Web/Channel) docs/message-paths.md
Client streaming protocol docs/client-streaming-protocol.md
Hub RPC protocol docs/rpc.md
Exec approval protocol docs/exec-approval.md
Time injection design docs/time-injection.md
Channel system docs/channels/README.md
Channel media handling docs/channels/media-handling.md
Desktop login integration docs/auth/desktop-integration.md