Reference Repo Maphow each repo fits your stack
Four reference repositories — what they do, how they fit the Claw ecosystem, and the patterns worth stealing from each.
Pi Monorepo — Structure Reference
A production TypeScript monorepo for an entire AI agent ecosystem. Seven packages: unified LLM API, agent runtime, coding agent CLI, Slack bot, terminal UI, web UI components, and GPU pod manager. Each package is independently publishable but shares a root tsconfig, biome linter, and npm workspace setup.
Blueprint for structuring the Organized AI monorepo — one repo for ClawSwarm, Hermes, Paperclip, NanoClaw, and Clawdbot. pi-ai unified LLM wrapper is the abstraction layer you need over Anthropic, MiniMax, and OpenRouter. AGENTS.md convention at monorepo root — single rules file for Claude Code operating across all packages.
The organized-ai monorepo that ties your 5 pillars together
Mac Mini Agent — Infra Pattern
Four purpose-built CLIs: Steer (Swift GUI automation via OCR), Drive (Python tmux control with sentinel pattern), Listen (FastAPI HTTP job server on port 7600 spawning Claude Code), and Direct (CLI client for Listen).
Architecturally identical to OpenClaw gateway on M4 Mini (port 18789). Two-machine model maps to your claws-mac-mini + jordans-mac-mini setup. Sentinel pattern (__DONE_token:exit_code) makes agent subprocess completion deterministic. justfile as command runner replaces scattered npm scripts.
OpenClaw Gateway (port 18789, claws-mac-mini) + tmux sentinel dispatch to jordans-mac-mini
Hermes Agent — Direct Match
A self-improving Python agent with a closed learning loop — creates skills from experience, improves them during use, maintains persistent memory, runs FTS5 session search for cross-session recall. Ships with cron scheduler, multi-platform messaging gateway (Telegram, Discord, Slack, Signal), and explicit OpenClaw migration: hermes claw migrate.
Your Hermes cloud agent (MiniMax API) IS this project — EXP-11–21 experiments are their trajectory generation loop. hermes claw migrate imports OpenClaw skills, memories, SOUL.md, API keys — confirmed upgrade path. toolset_distributions.py maps to your plugin-marketplace architecture.
Hermes daemon on claws-mac-mini :7700 (Python, MiniMax API, skill loop)
Paperclip — Direct Match
Node.js server + React UI orchestrating AI agents to run a business. Org charts, heartbeat scheduling, per-agent budgets, multi-company isolation, full tool-call audit logs. Uses pnpm workspaces across packages/, server/, ui/, cli/, skills/. Works with OpenClaw, Claude Code, Codex, Cursor, Bash, HTTP.
Your Paperclip on claws-mac-mini IS this project — 5 pillars map to their org chart + heartbeat model. pnpm-workspace.yaml is the exact monorepo template for organized-ai. Heartbeat model replaces manual agent kick-offs — agents wake on schedule. Per-agent cost budgets + audit logs solve the runaway token problem.
Paperclip runtime on claws-mac-mini :3100 orchestrating all Claw agents