# 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

```text
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

```bash
pnpm install
pnpm multica credentials init
pnpm multica
```

Run desktop app in dev mode:

```bash
pnpm dev
```

## Common Commands

```bash
# 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

# 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`