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 6e8307e09b docs: update README with profile system and tools documentation - Document agent profile system and profile CLI commands - Document exec and process tools with usage examples - Update project structure to reflect new directories Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2026-01-30 03:11:29 +08:00
apps/web	Add monorepo setup with Turborepo and Web client	2026-01-29 16:33:35 +08:00
packages/sdk	Add monorepo setup with Turborepo and Web client	2026-01-29 16:33:35 +08:00
src	fix(agent): prevent memory leak and buffer overflow in process tool	2026-01-30 03:08:24 +08:00
.dockerignore	Add Docker support for Gateway and SDK documentation	2026-01-28 17:56:22 +08:00
.gitignore	Initial project setup with multi-component architecture	2026-01-28 14:08:34 +08:00
package.json	feat(agent): add profile system and improve tools	2026-01-30 02:47:30 +08:00
pnpm-lock.yaml	feat(agent): add exec/process tools	2026-01-30 01:52:10 +08:00
pnpm-workspace.yaml	Add monorepo setup with Turborepo and Web client	2026-01-29 16:33:35 +08:00
README.md	docs: update README with profile system and tools documentation	2026-01-30 03:11:29 +08:00
tsconfig.json	Implement WebSocket Gateway with NestJS and client SDK	2026-01-28 16:46:51 +08:00
turbo.json	Add monorepo setup with Turborepo and Web client	2026-01-29 16:33:35 +08:00

README.md

Super Multica

A multi-component architecture for distributed agent systems.

Project Structure

src/
├── agent/          # Agent module
│   ├── profile/    # Agent profile management
│   ├── session/    # Session persistence
│   └── tools/      # Agent tools (exec, process)
├── gateway/        # Gateway module
├── client/         # Client module
└── shared/         # Shared types and utilities

Getting Started

pnpm install
pnpm dev

Agent CLI

Use the agent module directly from the CLI for isolated testing.

pnpm agent:cli "hello"

# Persist a session under ~/.super-multica/sessions/<id>/session.jsonl
pnpm agent:cli --session demo "remember my name is Alice"
pnpm agent:cli --session demo "what's my name?"

# Override provider/model
pnpm agent:cli --provider openai --model gpt-4o-mini "hi"

# Use an agent profile
pnpm agent:cli --profile my-agent "hello"

Agent Profiles

Agent profiles define identity, personality, tools, and memory for an agent. Profiles are stored as markdown files in ~/.super-multica/agent-profiles/<id>/.

Profile CLI

# Create a new profile with default templates
pnpm agent:profile new my-agent

# List all profiles
pnpm agent:profile list

# Show profile contents
pnpm agent:profile show my-agent

# Open profile directory in file manager
pnpm agent:profile edit my-agent

Profile Structure

Each profile contains:

identity.md - Agent name and role
soul.md - Personality and behavioral constraints
tools.md - Tool usage instructions
memory.md - Persistent knowledge
bootstrap.md - Initial conversation context

Agent Tools

exec

Execute short-lived shell commands and return output.

exec({ command: "ls -la", cwd: "/path/to/dir", timeoutMs: 30000 })

process

Manage long-running background processes (servers, watchers, daemons).

# Start a background process
process({ action: "start", command: "npm run dev" })

# Check process status
process({ action: "status", id: "<process-id>" })

# Read process output
process({ action: "output", id: "<process-id>" })

# Stop a process
process({ action: "stop", id: "<process-id>" })

# Clean up terminated processes
process({ action: "cleanup" })

Scripts

pnpm dev - Run in development mode
pnpm agent:cli - Run the agent CLI for module-level testing
pnpm agent:profile - Manage agent profiles
pnpm build - Build for production
pnpm start - Run production build
pnpm typecheck - Type check without emitting