Getting Started

Architecture

ArchAgent is an orchestration platform, not an agent runtime. It sits above runtimes (OpenClaw, Mastra, Custom) and provides infrastructure they can't.

Monorepo Layout

admin/          — React admin dashboard
bridge/         — Channel adapter service
cli/            — CLI tool for agent management
docker/         — Dockerfiles for agent runtimes
functions/      — Firebase Cloud Functions (API)
shared/         — @archagent/shared types
docs/           — This documentation site
docs-legacy/    — Previous HTML documentation

Key Commands

pnpm build:shared                    # Build shared types (run first)
pnpm dev:web                         # Web dashboard dev server
pnpm dev:admin                       # Admin dashboard dev server
pnpm dev:bridge                      # Bridge service dev server
pnpm docs:dev                        # Docs dev server

Platform vs Runtime Boundary

ArchAgent (Platform)	Runtimes (OpenClaw/Mastra/Custom)
Multi-agent topology & coordination	Single-agent inference
Channel adapters (Slack, Discord, Telegram)	—
Integration proxy (policy-enforced API)	Skills/MCP for tool access
Deployment & scaling (Cloud Run)	—
Task management & work queues	—
Persistent agent memory (5 types)	Conversation memory
Approval workflow	—
Activity logging & audit trails	—
Billing, auth, team management	—