{"id":46384321,"url":"https://github.com/oabdelmaksoud/agi-farm-plugin","last_synced_at":"2026-04-01T22:59:09.984Z","repository":{"id":341964029,"uuid":"1172216642","full_name":"oabdelmaksoud/AGI-FARM-PLUGIN","owner":"oabdelmaksoud","description":"Multi-agent AI team builder for OpenClaw — bootstrap complete teams with auto-dispatcher, dashboard, and infrastructure","archived":false,"fork":false,"pushed_at":"2026-03-07T11:02:53.000Z","size":5430,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T13:39:50.397Z","etag":null,"topics":["agent-framework","ai","ai-orchestration","autonomous-agents","devops","multi-agent","openclaw"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oabdelmaksoud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_DASHBOARD.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-04T04:02:25.000Z","updated_at":"2026-03-07T11:02:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN","commit_stats":null,"previous_names":["oabdelmaksoud/agi-farm-plugin"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/oabdelmaksoud/AGI-FARM-PLUGIN","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oabdelmaksoud%2FAGI-FARM-PLUGIN","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oabdelmaksoud%2FAGI-FARM-PLUGIN/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oabdelmaksoud%2FAGI-FARM-PLUGIN/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oabdelmaksoud%2FAGI-FARM-PLUGIN/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oabdelmaksoud","download_url":"https://codeload.github.com/oabdelmaksoud/AGI-FARM-PLUGIN/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oabdelmaksoud%2FAGI-FARM-PLUGIN/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30288779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-framework","ai","ai-orchestration","autonomous-agents","devops","multi-agent","openclaw"],"created_at":"2026-03-05T07:03:40.700Z","updated_at":"2026-04-01T22:59:09.956Z","avatar_url":"https://github.com/oabdelmaksoud.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🦅 AGI Farm\n\n### One wizard. Full multi-agent AI team. Live in minutes.\n\n**Build production-ready AI teams with a single command**\n\n[![npm version](https://img.shields.io/npm/v/agi-farm.svg)](https://www.npmjs.com/package/agi-farm)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![OpenClaw](https://img.shields.io/badge/OpenClaw-Plugin-blue.svg)](https://docs.openclaw.ai)\n[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)\n\n[Quick Start](#-quick-start) • [Features](#-what-it-does) • [Documentation](#-commands) • [Architecture](#-architecture)\n\n\u003c/div\u003e\n\n---\n\n\u003e [!WARNING]\n\u003e **Notice: AGI Farm is currently under active development and still has known bugs.** Please use with caution in production environments.\n\n## 🎯 What It Does\n\n**AGI Farm** is an [OpenClaw](https://docs.openclaw.ai) plugin that bootstraps a fully operational multi-agent AI system with everything you need:\n\n| Feature | Description |\n|---------|-------------|\n| 🧙 **Interactive Wizard** | 6 questions → complete team setup in ~2 minutes |\n| 🤖 **Multi-Agent Teams** | Choose 3, 5, or 11 pre-wired specialist agents |\n| 📡 **Live Ops Dashboard** | React + SSE with real-time updates and interactive HITL/Cron controls |\n| 🔄 **Auto-Dispatcher** | Smart task delegation with HITL, backoff \u0026 dependencies |\n| 📦 **Portable Bundle** | Export your entire team to GitHub with one command |\n| 🏗️ **ESM Native** | Built for Node 20+ with full ES Module support |\n| 🛡️ **Production Hardened** | Security-audited with CSRF, Origin validation, CSP headers, input sanitization, and timing-safe auth |\n| 🔐 **Security Dashboard** | Real-time vulnerability scanning, auto-fix, and security history tracking |\n| 🔄 **Auto-Update** | Detects new releases on GitHub with one-click install from the dashboard |\n| ⚙️ **Feature-Flagged Runtime** | Optional jobs, skills, memory, policy, approvals, and metering modules |\n| 🧪 **103 Automated Tests** | Unit + integration + API smoke coverage with Jest/ESM |\n\n---\n\n## 🙏 Upstream Acknowledgement\n\nParts of AGI Farm dashboard direction are inspired by the excellent work in **LobsterBoard** by [Curbob](https://github.com/Curbob):\n\n- Upstream repository: https://github.com/Curbob/LobsterBoard\n- Upstream license: Business Source License 1.1 (BSL-1.1)\n\nAGI Farm does not copy LobsterBoard code directly; features are re-implemented for AGI Farm architecture and compatibility.\n\n### 🔄 Always-Sync Policy\n\nTo stay aligned with upstream updates, this repo now includes:\n\n- Automated scheduled sync workflow: `.github/workflows/lobsterboard-upstream-sync.yml`\n- Local sync script: `npm run sync:lobsterboard`\n- Snapshot mirror for review/porting: `upstream/lobsterboard/`\n- Tracking file: `lobsterboard-resources/LOBSTERBOARD_VERSION`\n- Parity plan: `docs/LOBSTERBOARD_PARITY.md`\n\nThis keeps upstream diffs visible in PRs so feature ports can be done continuously.\n\n---\n\n## 🧙 What's New in v3.3.0\n\n### 🚀 Automated Release \u0026 Workflow Hardening\n\nVersion 3.3.0 standardizes the release process and ensures all GitHub workflows are production-ready.\n\n#### 🏗️ Automated Dashboard Launch\n- **One-Click Wizard**: The `agi-farm setup` wizard now automatically opens the Paperclip dashboard in your default browser upon successful configuration.\n- **Direct Dependencies**: Added `express` as a core dependency for improved dashboard server stability.\n\n#### 🛡️ Workflow \u0026 Compatibility Hardening\n- **OpenClaw Compatibility**: Improved version scrubbing (handles `v` prefixes and revision suffixes) for more robust integration testing.\n- **Graceful Installation**: Workflows now handle missing NPM versions gracefully, skipping integration tests if a specific version is not yet published.\n- **Global PATH Reliability**: Ensured global `npm` bin directories are correctly added to `GITHUB_PATH` across all workflow steps.\n\n#### 🔐 Security Enhancements\n- **Automated Secret Scrubbing**: Upstream sync scripts (`scripts/sync-lobsterboard-upstream.js`) now redact Google OAuth Client IDs and Secrets to prevent GitHub Push Protection violations.\n- **Refined Command Execution**: All `agi-farm` commands in workflows now use `npx` for guaranteed executability.\n\n---\n\n## 🧙 What's New in v1.9.0\n\n### 🚀 Advanced Wizard 2.0 — Industry-Driven Automation\n\nThe setup wizard has been completely overhauled from a basic 4-template system to a sophisticated, 6-phase onboarding experience that activates the full depth of the AGI Farm plugin.\n\n#### 🏗️ 15 Industry-Specific Blueprints\nChoose from professional team compositions across 5 major verticals:\n- **Software Engineering**: Startup MVP, Full-Stack Product, Mobile-First App, AI/ML System.\n- **Marketing \u0026 Growth**: Marketing Campaign, Brand Launch, Performance Marketing.\n- **Enterprise \u0026 Regulated**: Enterprise Feature, Security-Critical, Compliance \u0026 Audit.\n- **Research \u0026 Development**: Quality-First, Research \u0026 Discovery.\n- **Creative \u0026 Content**: Content Studio, Product Design Sprint.\n\n#### ⚙️ Deep Plugin Integration\nThe wizard now automates what used to be manual post-setup tasks:\n- **Budget \u0026 OKRs**: Set monthly spend limits and seed your team with industry-specific OKRs immediately.\n- **Operational Automation**: Select and activate pre-built cron jobs (daily security scans, weekly velocity reports, auto-dispatcher heartbeats).\n- **HITL Security Policy**: Choose your \"Human-in-the-Loop\" sensitivity level (Low/Medium/High) during setup.\n- **Project Seeding**: Start with a pre-populated project and task backlog tailored to your chosen blueprint.\n- **AgentShield Integration**: One-click initial security scan to baseline your new workspace.\n\n#### 🧹 Consolidated Architecture\n- Legacy `setup-enhanced.js` has been consolidated into the main `setup.js`.\n- Performance improvements in agent creation and SOUL.md template generation.\n- Expanded `WORKFLOW_TEMPLATES.md` documentation covering all 15 new blueprints.\n\n---\n\n## 🆕 What's New in v1.8.0\n\n### 🎨 Complete Dashboard Redesign — Day Theme (Minimalism 3.0 + Glassmorphism 2.0)\n\nThe AGI Farm dashboard has been **completely redesigned** with a modern, light-mode UI. Every single one of the 26 tabs has been rewritten from scratch with a premium day-themed aesthetic.\n\n#### ✨ Design System\n- **Off-white/pearl backgrounds** (`#F8FAFC` slate palette) with glassmorphism cards and subtle depth shadows\n- **Premium typography** — Inter for UI, JetBrains Mono for technical values\n- **Accent palette** — Indigo primary, Emerald mint for success, Amber for warnings, Violet for AI/HITL, Red for errors\n- **Hover-lift animations**, smooth fade-in transitions, and pill-shaped status badges throughout\n- **100% light mode** — All dark `#050505`/`#000`/`rgba(0,0,0)` backgrounds purged from every file\n\n#### 📋 All 26 Tabs Redesigned\n\n| Pillar | Tabs |\n|--------|------|\n| **Agent Intelligence** | Overview, Agents, Tasks, HITL, Alerts, Velocity, Budget |\n| **Project Oversight** | Projects, OKRs, Approvals, Knowledge, Comms |\n| **System** | Security, Jobs \u0026 Crons, Processes, Policies, Skills, Usage, Memory, Failures, Decisions, Audit Log, Settings, R\u0026D |\n\n#### 🏗️ Key Changes\n- **Projects tab** — Full rewrite with light progress rings, health badges, tabbed detail view (Overview / Timeline / Tasks / Budget / OKRs / Logs), light Gantt chart and burndown chart\n- **HITL tab** — Soft-purple glass cards with clear Approve/Reject actions and status banner\n- **Velocity tab** — KPI cards + area chart + success rate trend line\n- **Approvals tab** — Card layout matching HITL with optional notes field\n- **Settings tab** — Toggle switches, budget limit inputs, workspace info grid\n- **Crons tab** — Status-dot rows with Run / Pause / Resume action buttons\n- **Knowledge tab** — Masonry card grid with tag pills and expand-to-read\n- **Comms tab** — Agent list sidebar with Inbox / Outbox panels\n- **OKRs tab** — Objective cards with animated KR progress bars\n- **R\u0026D tab** — Light experiment table, benchmark leaderboard, and evolution pipeline backlog\n\n#### 🧹 Legacy Cleanup\n- Deleted `TopBar.jsx` and `Sidebar.jsx` (unused dark-theme stubs)\n- Removed all cyberpunk/neon language (`SYSTEM_LIVE`, `ENCRYPTED`, `VECTOR_ID`, `NEURAL`, etc.)\n- All chart grid lines and tooltips updated to light theme\n\n---\n\n### Previous: v1.7.2 — Enhanced Wizard with Workflow Templates + Agent Browser\n- **4 workflow templates** — Pre-built teams for common use cases: Startup MVP (5 agents), Marketing Campaign (5 agents), Enterprise Feature (6 agents), Quality-First (4 agents)\n- **Agent browser** — Browse and select from all **91 agents** across 11 categories (AGI Farm + ECC + Agency-Agents)\n- **Auto-template copying** — SOUL.md templates automatically copied to agent workspaces during setup\n- **Workflow documentation** — Each template links to orchestration patterns and quick-start guides\n- **Backward compatible** — Legacy wizard (3/5/11 fixed rosters) preserved\n- **Zero manual setup** — Agency-Agents templates work out-of-box with no file copying required\n\nRun enhanced wizard: `node scripts/setup-enhanced.js`\n\n### Previous: v1.7.1 — Architectural Hardening\n\n### 🔒 Architectural Hardening\n- **Per-file mutex locking** — All service read-modify-write operations (`JobsService`, `ProjectService`, `TaskService`, `PolicyService`, `MeteringService`, `MemoryService`, `SkillsService`) now serialize concurrent writes via `withFileLockSync()`, preventing data loss from race conditions\n- **CSRF token rotation** — Token rotates every 24 hours with 5-minute grace period for active connections; static tokens from env var exempt\n- **Audit log pagination** — `/api/audit` now supports `offset` and `limit` query params with memory-efficient streaming; warns on malformed log lines\n- **Session rate limiting** — `/api/session` endpoint has its own stricter rate limit (20 req/min) to prevent token enumeration\n- **Knowledge/cron file locking** — Dashboard direct file operations (knowledge CRUD, cron toggle) now also use `withFileLockSync()`\n\n### Previous: v1.7.0 — Dashboard Hardening \u0026 Security Overhaul\n\n### 🛡️ Dashboard Hardening \u0026 Security Overhaul\n- **Deep server-side audit** — 20 issues identified and remediated across data integrity, endpoint security, SSE reliability, and file I/O\n- **SSE exponential backoff** — Reconnection now backs off 3s → 6s → 12s → ... → 60s max, resets on success (prevents server thrashing)\n- **Input sanitization everywhere** — New `sanitizeText()` helper applied to broadcast, knowledge, comms, and approval endpoints; strips control characters\n- **CSRF hardening** — `/api/stream` and `/api/data` now validate CSRF tokens; SSE accepts token via query parameter\n- **Workspace validation** — Server validates workspace directory exists and is writable at startup, exits cleanly on failure\n- **Broadcaster thread-safety** — Fixed Set mutation during iteration in SSE fan-out\n- **Silent failure logging** — `readJson()`/`readMd()` now log warnings on file read failures instead of silently returning empty values\n- **Null safety sweep** — Comprehensive guards across all 20+ dashboard tabs preventing crashes on missing/malformed data\n- **Component prop consistency** — Fixed mismatched prop names between server snapshot and frontend components\n\n### 🔧 5 New Dashboard Tabs + Security Dashboard\n- **Decisions tab** — View and manage policy decisions and approval workflows\n- **Failures tab** — Track and analyze job/task failures with error details\n- **Processes tab** — Monitor running agent processes and system health\n- **R\u0026D tab** — Experiments tracking with status and results visualization\n- **Settings tab** — Configure project defaults and feature flags from the UI\n- **Security Dashboard** — Real-time vulnerability scanning, auto-fix capabilities, and security history\n\n### 📊 Dashboard Data \u0026 API Completeness\n- **Missing endpoint coverage** — Added server handlers for all frontend API calls (tasks, projects, jobs, intake, comms, knowledge)\n- **Project enrichment** — Server-side project enrichment with task counts, progress, team agents, and risk indicators\n- **Auto-derived tasks** — Tasks automatically derived from jobs with `rootTaskId` for complete task visibility\n- **Error feedback** — User-facing error messages and loading states across all interactive components\n\n### Previous: v1.6.0 — Agency-Agents Integration\n\n### 🎭 Agency-Agents Integration: 59 Specialized Personalities\n- **59 battle-tested agent templates** from [@msitarzewski's Agency-Agents](https://github.com/msitarzewski/agency-agents)\n- **11 specializations**: Engineering, Design, Marketing, Product, PM, Testing, Support, Spatial Computing, Strategy, and more\n- **Production-proven workflows** with 10,000+ lines of personality definitions and code examples\n- **Standout agents**: Agents Orchestrator, Evidence Collector, Reality Checker, Whimsy Injector, Reddit Community Builder\n- **Total library**: **91 agents** (16 AGI Farm + 16 ECC + 59 Agency-Agents)\n- **Zero dependencies** — Pure markdown templates, instantly usable\n- **See:** [Agency-Agents Integration Guide](AGENCY_AGENTS_GUIDE.md)\n\n### 🔄 Enhanced Orchestration Patterns\n- **Pipeline orchestration** for Cooper: PM → Architect → [Dev ↔ QA Loop] → Integration\n- **Quality gate patterns** for Vigil: Evidence Collector + Reality Checker methodologies\n- **4 workflow templates**: Startup MVP, Marketing Campaign, Enterprise Feature, Quality-First teams\n- **Automated update system** for keeping Agency-Agents templates current\n- **See:** [Orchestration Patterns](templates/ORCHESTRATION_PATTERNS.md) | [Quality Gates](templates/QUALITY_GATE_PATTERNS.md) | [Workflow Templates](templates/WORKFLOW_TEMPLATES.md)\n\n### Previous: ECC Integration v1.5.0\n- **69 specialized skills** from Everything Claude Code (Anthropic hackathon winner)\n- **16 ECC agent templates** for domain-specific delegation\n- **33 slash commands** for common workflows\n- **TDD \u0026 Security-First** — 80%+ test coverage enforced, comprehensive security scans\n- **See:** [ECC Integration Guide](docs/ECC_INTEGRATION_GUIDE.md)\n\n### Previous: Dashboard UI v2: Agent OS Overhaul (v1.4.0)\n- 🛰️ **Agent OS Aesthetic**: Professional, minimalist, and high-contrast obsidian design.\n- 📉 **Strategic Command Matrix**: High-density project matrix with integrated Gantt and Burndown visualizations.\n- 🧬 **Fleet Pulse signatures**: Minimalist neural activity and heartbeat monitoring for the entire fleet.\n- 📊 **Efficiency Analytics**: Professional data visualizations for agent velocity and task throughput.\n- ⚡ **Performance Optimization**: 60% reduction in dashboard asset size and faster SSE fan-out.\n\n## 🆕 Previous Updates (v1.2.0 - v1.3.x)\n\n### Previous Highlights (v1.1.x)\n- 🔄 **GitHub release detection \u0026 Auto-Update system directly from dashboard**\n- ⚙️ **Feature-Flagged Core Runtime** (Jobs, Approvals, Memory, Skills)\n- 🛡️ **Extensive Security Hardening** (CSRF, CSP, token validation, atomic file writes)\n\n---\n\n## 📸 Preview\n\n### Dashboard Overview\n```\n┌──────────────────────────────────────────────────────────────────────┐\n│  🦅 AGI Ops Room   ● LIVE   Online: 8/11  Pending: 4  Budget: $45  │\n├──────────────────────────────────────────────────────────────────────┤\n│  🔄 Update available: v1.0.2 → v1.1.0  [Release Notes] [Update Now]│\n├──────────────────────────────────────────────────────────────────────┤\n│ Overview │ Agents │ Tasks │ Projects │ Crons │ HITL │ Alerts │ ...  │\n├──────────────────────────────────────────────────────────────────────┤\n│                                                                      │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐            │\n│  │ 📊 42    │  │ ✅ 38    │  │ ⏳ 4      │  │ 🚨 2     │            │\n│  │ Tasks    │  │ Done     │  │ Active   │  │ HITL     │            │\n│  └──────────┘  └──────────┘  └──────────┘  └──────────┘            │\n│                                                                      │\n│  ┌───────────────────────────────────────────────────────────┐      │\n│  │ 🔮 Sage    ✅ Ready  📨 3 msgs  ⭐ 94%  [Send Message]   │      │\n│  │ ⚒️ Forge   🔄 Busy   📨 7 msgs  ⭐ 89%  [Send Message]   │      │\n│  │ 🐛 Pixel   ✅ Ready  📨 2 msgs  ⭐ 96%  [Send Message]   │      │\n│  └───────────────────────────────────────────────────────────┘      │\n│                                                                      │\n└──────────────────────────────────────────────────────────────────────┘\n```\n\n### Team Architecture\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                    11-Agent Team (Full Stack)                   │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                 │\n│                      🦅 Cooper (Orchestrator)                   │\n│                              │                                  │\n│              ┌───────────────┼───────────────┐                 │\n│              │               │               │                  │\n│         🔮 Sage          ⚒️ Forge        🐛 Pixel              │\n│      (Architect)     (Builder)      (Debugger)                 │\n│              │               │               │                  │\n│         🔭 Vista        🔊 Cipher       🛡️ Vigil               │\n│       (Analyst)      (Knowledge)       (QA)                    │\n│              │               │               │                  │\n│         ⚓ Anchor        📡 Lens        🔄 Evolve               │\n│      (Content)      (Multimodal)   (Process)                   │\n│                              │                                  │\n│                          🧪 Nova                                │\n│                         (R\u0026D Lead)                              │\n│                                                                 │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 🚀 Quick Start\n\n### One-Step Install \u0026 Setup\n\nThe recommended way to install and configure AGI Farm is with this single command. It will globally install the CLI and immediately launch the interactive setup wizard:\n\n```bash\nnpm install -g agi-farm \u0026\u0026 agi-farm setup\n```\n\n### Alternative Installation\n\nIf you prefer to install it purely as an OpenClaw plugin (without the global CLI binary), you can use the built-in plugin manager, but you **must** use the `npx` runner to execute the setup wizard:\n\n```bash\nopenclaw plugins install agi-farm\nnpx agi-farm setup\n```\n\n### Upgrade (Existing Install)\n\n```bash\n# Update an already installed OpenClaw plugin\nopenclaw plugins update agi-farm\n\n# One-liner: install first, or update if already installed\nopenclaw plugins install agi-farm || openclaw plugins update agi-farm\n```\n\n### Run Setup Wizard\n\n```bash\n# Start the interactive wizard anytime\nagi-farm setup\n```\n\nAnswer the setup prompts and your team will be live in ~2 minutes:\n\n```\n🧙 AGI Farm Setup Wizard\n\n? Team name (e.g., \"CooperCorp\"): MyTeam\n? Orchestrator name: Cooper\n? Team size: 11 agents (Full Stack)\n? Domain: general\n? Collaboration frameworks: langgraph\n? Auto-create project channel per project: Yes\n? Default execution path: AGI-Farm first\n? Confirm setup? Yes\n\n✅ Creating 11 agents...\n✅ Setting up workspace...\n✅ Initializing AGI Farm registries...\n\n🎉 Your AI team is ready!\n```\n\nSetup now captures project defaults in `PROJECTS.json`, including:\n- `auto_project_channel` (default: `true`)\n- `execution_path` (default: `agi-farm-first`)\n\nThis makes AGI Farm the default execution path for newly created projects.\n\n### Project Defaults\n\nNew projects inherit defaults from `PROJECTS.json`:\n- **Auto Project Channel**: when enabled, each new project gets a dedicated channel\n- **Execution Path**: choose `agi-farm-first` (multi-agent routing) or `direct-first` (immediate execution)\n\nView and edit defaults via:\n- Dashboard → Settings tab\n- `GET /api/projects` → `defaults` field\n- `PATCH /api/projects/defaults` API endpoint\n\n---\n\n## 📦 Commands\n\n| Command | CLI Shortcut | Description |\n|---------|-------------|-------------|\n| 🎯 `agi-farm setup` | `agi-farm` | Full wizard — agents, workspace, crons (Classic mode: 3/5/11 agents) |\n| ✨ `node scripts/setup-enhanced.js` | — | **Enhanced wizard (v1.7.0)** — Workflow templates + Agent browser (91 agents) |\n| 🗑️ `agi-farm teardown` | `agi-farm-teardown` | Team teardown — removes AGI Farm agents, bundle, and workspace registries |\n| 📊 `agi-farm status` | `agi-farm-status` | Team health: agents, tasks, cron status |\n| 🔧 `agi-farm rebuild` | `agi-farm-rebuild` | Regenerate workspace from bundle |\n| 📤 `agi-farm export` | `agi-farm-export` | Push bundle to GitHub |\n| 🖥️ `agi-farm dashboard` | `agi-farm-dashboard` | Launch live ops room (SSE, :8080) |\n| ⚡ `agi-farm dispatch` | `agi-farm-dispatch` | Run auto-dispatcher manually |\n| 🍎 `agi-farm launchagent` | `agi-farm-launchagent` | Install/uninstall macOS LaunchAgent for persistent dashboard |\n\n### 🆕 Enhanced Wizard (v1.7.0)\n\nThe enhanced wizard offers **4 workflow templates** and **agent browsing** for all 91 agents:\n\n**Run it**:\n```bash\ncd ~/.openclaw/extensions/agi-farm  # or global npm path\nnode scripts/setup-enhanced.js\n```\n\n**Features**:\n- 🚀 **Startup MVP** (5 agents, 1-2 weeks) — Cooper, Forge, Pixel, Vigil, Growth Hacker\n- 📈 **Marketing Campaign** (5 agents, 2-4 weeks) — Cooper, Content Creator, Twitter Engager, Reddit Builder, Analytics\n- 🏢 **Enterprise Feature** (6 agents, 4-8 weeks) — Cooper, Vista, Sage, Vigil, Experiment Tracker, Reality Checker\n- 🔬 **Quality-First** (4 agents, quality-driven) — Cooper, Vigil (Evidence), Reality Checker, Performance Benchmarker\n- 🎨 **Custom** — Browse all 91 agents by category and select your own team\n\n**Automatic template copying**: Agency-Agents SOUL.md templates are copied to agent workspaces automatically.\n\n---\n\n## 🍎 Persistent Dashboard (macOS LaunchAgent)\n\nThe dashboard can run as a macOS LaunchAgent — it starts on login and auto-restarts if it crashes, independent of the OpenClaw gateway lifecycle.\n\n### Install\n\n```bash\n# Install with defaults (port 8080, localhost)\nagi-farm-launchagent\n\n# Custom port and workspace\nagi-farm-launchagent --port 9090 --workspace ~/my-workspace\n```\n\n### Uninstall\n\n```bash\nagi-farm-launchagent --uninstall\n```\n\n### Why use this?\n\nThe plugin lifecycle (`onLoad`) spawns the dashboard as a child process. If the gateway exits, restarts, or doesn't reliably complete the lifecycle, the dashboard dies with it. The LaunchAgent runs the dashboard as an independent OS-level service:\n\n- **RunAtLoad** — starts automatically on login\n- **KeepAlive** — restarts if it crashes\n- **Logs** — stdout/stderr saved to `/tmp/openclaw/agi-farm-dashboard.log`\n\n\u003e **Linux users**: Use `systemd` with a similar service unit. See the plist template in `templates/` for reference.\n\n---\n\n## 🏗️ Architecture\n\n### Plugin Structure\n\n```\n.openclaw/extensions/agi-farm/ (or global node_modules/agi-farm/)\n├── 📦 package.json              Plugin manifest (ESM)\n├── ⚙️ openclaw.plugin.json     Config schema \u0026 commands\n├── 📂 dist/                    Compiled TypeScript (backend)\n├── 📂 dashboard-dist/          Built React frontend (production)\n├── 🌐 server/\n│   ├── 🖥️ dashboard.js         SSE server + CRUD API (Node.js)\n│   ├── 🔄 updater.js           GitHub release checker + auto-update\n│   └── 🛠️ utils.js             Core parsing \u0026 logic (Unit Tested)\n├── 📜 scripts/\n│   ├── 🎯 setup.js             Setup wizard\n│   ├── 🗑️ teardown.js          Uninstall mechanism\n│   ├── 📊 status.js            Status checker\n│   ├── 🔧 rebuild.js           Rebuilder\n│   ├── 📤 export.js            GitHub exporter\n│   ├── 🖥️ dashboard.js         Dashboard launcher\n│   ├── ⚡ dispatch.js          Auto-dispatcher\n│   └── 📂 lib/\n│       └── 🛠️ run-command.js   Shared CLI utility\n├── 📋 templates/               Agent \u0026 workspace templates\n├── ⚛️ dashboard-react/         Vite + React 18 source (Dev)\n└── 📚 skills/\n    └── 📖 SKILL.md             Embedded documentation\n```\n\n### Dashboard Architecture\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│                    Dashboard Data Flow                        │\n├──────────────────────────────────────────────────────────────┤\n│                                                              │\n│  📂 Workspace Files                                          │\n│  ├── TASKS.json                                              │\n│  ├── AGENT_STATUS.json                                       │\n│  └── comms/broadcast.md                                      │\n│           │                                                  │\n│           │ file change (250ms debounce)                     │\n│           ▼                                                  │\n│  ┌─────────────────────┐                                    │\n│  │ WorkspaceWatcher    │ 👁️ chokidar file watcher          │\n│  └─────────────────────┘                                    │\n│           │                                                  │\n│           ▼                                                  │\n│  ┌─────────────────────┐    ┌──────────────────┐           │\n│  │ SlowDataCache       │    │ Broadcaster      │           │\n│  │ (30s cache)         │───▶│ (SSE fan-out)    │           │\n│  └─────────────────────┘    └──────────────────┘           │\n│           │                          │                       │\n│  ┌─────────────────────┐             │ SSE stream            │\n│  │ UpdateChecker       │             ▼                       │\n│  │ (6h GitHub cache)   │   ┌──────────────────┐             │\n│  └─────────────────────┘   │ React Frontend   │             │\n│                             │ (Vite + Recharts)│             │\n│                             └──────────────────┘             │\n│                                                              │\n└──────────────────────────────────────────────────────────────┘\n```\n\n### Real-time Data Flow\n\n```\n┌──────────────┐     250ms      ┌──────────────┐     SSE      ┌──────────────┐\n│  Workspace   │ ──────────────▶│   Server     │ ───────────▶ │   Browser    │\n│   Files      │    chokidar    │  dashboard.js│   ~350ms     │   React      │\n└──────────────┘                └──────────────┘              └──────────────┘\n     ▲                                                           │\n     │                                                           │\n     │                      ┌──────────────┐                     │\n     └──────────────────────│   OpenClaw   │◀────────────────────┘\n          CLI commands      │     CLI      │    User actions\n                            └──────────────┘\n```\n\n---\n\n## 🤖 Team Presets\n\n### 3-Agent (Minimal) 🏃\n\nPerfect for simple workflows and quick prototypes.\n\n```\n🦅 Orchestrator\n    │\n    ├──▶ 🔮 Researcher\n    │        │\n    └──▶ ⚒️ Builder\n```\n\n**Best for:** Quick prototypes, simple automation, learning\n\n---\n\n### 5-Agent (Standard) ⚡\n\nBalanced team for production workloads.\n\n```\n                🦅 Orchestrator\n                     │\n         ┌───────────┼───────────┐\n         │                       │\n    🔮 Researcher           🛡️ QA\n         │                       │\n    ⚒️ Builder             ⚓ Content\n```\n\n**Best for:** Production apps, balanced workloads, medium complexity\n\n---\n\n### 11-Agent (Full Stack) 🚀\n\nComplete team for complex systems - **RECOMMENDED**\n\n```\n                        🦅 Cooper\n                      (Orchestrator)\n                           │\n        ┌──────────────────┼──────────────────┐\n        │                  │                  │\n   🔮 Sage            ⚒️ Forge           🐛 Pixel\n (Architect)        (Builder)         (Debugger)\n        │                  │                  │\n   🔭 Vista          🔊 Cipher         🛡️ Vigil\n  (Analyst)        (Knowledge)           (QA)\n        │                  │                  │\n   ⚓ Anchor           📡 Lens          🔄 Evolve\n  (Content)       (Multimodal)       (Process)\n                           │\n                       🧪 Nova\n                      (R\u0026D Lead)\n```\n\n**Best for:** Complex systems, enterprise, full-stack development\n\n---\n\n## 🧠 Model Selection Guide\n\nChoose the right model for each role to optimize cost and quality:\n\n| Role | Recommended Model | Why | Cost/Quality |\n|------|-----------|-----|--------------|\n| 🦅 Orchestrator | `anthropic/claude-3-5-sonnet` | High-level planning \u0026 delegation | 💰💰💰 / ⭐⭐⭐ |\n| 🔮 Architect | `anthropic/claude-3-opus` | Deep reasoning \u0026 system design | 💰💰💰 / ⭐⭐⭐ |\n| ⚒️ Engineer | `google/gemini-1.5-pro` | Reliable code gen \u0026 large context | 💰💰 / ⭐⭐ |\n| 🐛 Debugger | `anthropic/claude-3-5-sonnet` | Precision logic \u0026 error analysis | 💰💰 / ⭐⭐⭐ |\n| 🔭 Analyst | `google/gemini-2.0-flash` | Ultra-fast data synthesis | 💰 / ⭐⭐ |\n| 🛡️ QA | `anthropic/claude-3-haiku` | Rapid pattern validation | 💰 / ⭐ |\n| ⚓ Content | `google/gemini-1.5-pro` | Rich multimodal generation | 💰💰 / ⭐⭐⭐ |\n| 🧪 R\u0026D | `deepseek/deepseek-reasoner` | Structured creative experimentation | 💰 / ⭐⭐⭐ |\n\n---\n\n## ⚙️ Configuration\n\nConfigure AGI Farm in your `openclaw.json`:\n\n```json\n{\n  \"plugins\": {\n    \"entries\": {\n      \"agi-farm\": {\n        \"enabled\": true,\n        \"config\": {\n          \"dashboardPort\": 8080,\n          \"dashboardHost\": \"127.0.0.1\",\n          \"autoStartDashboard\": true,\n          \"autoCheckUpdates\": true,\n          \"workspacePath\": \"~/.openclaw/workspace\",\n          \"bundlePath\": \"~/.openclaw/workspace/agi-farm-bundle\",\n          \"featureJobs\": true,\n          \"featureSkills\": true,\n          \"featureMemory\": true,\n          \"featurePolicy\": true,\n          \"featureMetering\": true,\n          \"featureApprovals\": true\n        }\n      }\n    }\n  }\n}\n```\n\n### Configuration Options\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `dashboardPort` | number | 8080 | Port for live ops dashboard |\n| `dashboardHost` | string | \"127.0.0.1\" | Bind address for dashboard |\n| `autoStartDashboard` | boolean | true | Auto-start dashboard on load |\n| `autoCheckUpdates` | boolean | true | Check GitHub for new releases on startup |\n| `workspacePath` | string | ~/.openclaw/workspace | Path to OpenClaw workspace |\n| `bundlePath` | string | \u003cworkspace\u003e/agi-farm-bundle | Path to bundle directory |\n| `featureJobs` | boolean | true | Enable jobs runtime APIs + background worker |\n| `featureSkills` | boolean | true | Enable skills registry and routing endpoints |\n| `featureMemory` | boolean | true | Enable memory indexing + search endpoint |\n| `featurePolicy` | boolean | true | Enable policy evaluation on runtime/mutation actions |\n| `featureMetering` | boolean | true | Enable usage metering collection + API |\n| `featureApprovals` | boolean | true | Enable approval workflows for policy-gated actions |\n\n### Runtime Files Added By Core Modules\n\nWhen feature flags are enabled, AGI Farm lazily creates these additive workspace files:\n\n- `JOBS.json`\n- `JOB_RUNS.jsonl`\n- `SKILLS_REGISTRY.json`\n- `MEMORY_INDEX.json`\n- `POLICIES.json`\n- `APPROVALS.json`\n- `AUDIT_LOG.jsonl`\n- `USAGE_METERING.json`\n- `SECRETS/` (encrypted blobs + metadata)\n\n---\n\n## 📊 Dashboard Data Sources\n\nAll data updates in real-time from workspace files:\n\n| Field | Source | Refresh | Latency |\n|-------|--------|---------|---------|\n| 📋 Tasks | `TASKS.json` | Instant | ~50ms |\n| 🤖 Agents | `AGENT_STATUS.json` | Instant | ~50ms |\n| 📬 Comms | `comms/inboxes/*.md` | Instant | ~50ms |\n| 🚨 Alerts | `ALERTS.json` | Instant | ~50ms |\n| 📂 Projects | `PROJECTS.json` | Instant | ~50ms |\n| 💰 Budget | `BUDGET.json` | Instant | ~50ms |\n| 📈 Velocity | `VELOCITY.json` | Instant | ~50ms |\n| 🎯 OKRs | `OKRs.json` | Instant | ~50ms |\n| 📢 Broadcast | `comms/broadcast.md` | Instant | ~50ms |\n| 🧪 Experiments | `EXPERIMENTS.json` | Instant | ~50ms |\n| 📚 Knowledge | `SHARED_KNOWLEDGE.json` | Instant | ~50ms |\n| 🧠 Memory | `MEMORY.md` | Instant | ~50ms |\n| 🔄 Agent Models | `openclaw agents list` | Cached | ~30s |\n| 🗂️ Jobs | `JOBS.json` | Instant | ~50ms |\n| ✅ Approvals | `APPROVALS.json` | Instant | ~50ms |\n| 📊 Usage | `USAGE_METERING.json` | Instant | ~50ms |\n\n### Interactive Actions (API)\n\nThe dashboard enables direct control over team operations via authenticated REST endpoints (all require CSRF token):\n\n**HITL \u0026 Cron Controls:**\n- `POST /api/hitl/:id/approve` — Continue task with optional notes\n- `POST /api/hitl/:id/reject` — Block task and notify agent\n- `POST /api/cron/:id/trigger` — Manually run a specific cron job\n- `POST /api/cron/:id/toggle` — Enable or disable a cron job\n- `POST /api/jobs` — Create a background job from high-level intent\n- `GET /api/jobs` / `GET /api/jobs/:id` — List and inspect jobs\n- `POST /api/jobs/:id/cancel` / `POST /api/jobs/:id/retry` — Control failed/running jobs\n- `GET /api/skills` + `POST /api/skills/:id/(enable|disable)` — Manage skill activation\n- `GET /api/memory/search?q=\u0026tags=` — Search memory index\n- `GET /api/policies` — Retrieve active policy rules\n- `GET /api/approvals` + `POST /api/approvals/:id/(approve|reject)` — Human approval queue\n- `GET /api/usage` — Usage and cost aggregates for dashboard\n\n**CRUD Operations:**\n- `POST /api/tasks` — Create a new task with assignee, priority, dependencies\n- `POST /api/comms/:id/send` — Send a message to a specific agent inbox\n- `POST /api/broadcast` — Post a team-wide broadcast message\n- `POST /api/knowledge` — Add a shared knowledge entry\n- `DELETE /api/knowledge/:id` — Remove a knowledge entry\n\n**LobsterBoard Parity Foundations (P0):**\n- `GET /api/auth/status` — PIN/public-mode status + write unlock state\n- `POST /api/auth/verify-pin` — Verify PIN and issue write auth token\n- `POST /api/auth/set-pin` / `POST /api/auth/remove-pin` — Manage dashboard PIN lock\n- `POST /api/auth/public-mode` — Toggle read-only public mode\n- `GET /api/secrets` / `GET /api/secrets/:scope` — List masked secrets metadata\n- `POST /api/secrets/:scope` / `DELETE /api/secrets/:scope/:key` — Store/delete scoped secrets\n- `GET /api/templates` / `GET /api/templates/:id` — List and inspect dashboard templates\n- `POST /api/templates/export` / `POST /api/templates/import` — Export/import template settings\n\n**Integrated LobsterBoard Runtime (same host/process):**\n- Full LobsterBoard runtime is mounted internally at `GET /lobsterboard/`\n- Dashboard tab `LobsterBoard` loads this internal route (no separate user-facing port required)\n- API/static calls from LobsterBoard are proxied through AGI Farm server under the same origin\n\n**Auto-Update:**\n- `GET /api/update-check` — Force a fresh GitHub release check\n- `POST /api/update-install` — Install latest version via npm\n\n**Total push latency:** ~350ms from file change to browser update\n\n---\n\n## ⚡ Auto-Dispatcher\n\nThe auto-dispatcher intelligently routes tasks to agents:\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│                    Auto-Dispatcher Flow                       │\n├──────────────────────────────────────────────────────────────┤\n│                                                              │\n│  📋 Pending Tasks                                            │\n│       │                                                      │\n│       ▼                                                      │\n│  ┌─────────────┐     No     ┌──────────────┐                │\n│  │ HITL Check  │───────────▶│   Skip Task  │                │\n│  └─────────────┘            └──────────────┘                │\n│       │ Yes                                                  │\n│       ▼                                                      │\n│  ┌─────────────┐     Yes    ┌──────────────┐                │\n│  │ Rate Limit? │───────────▶│ Backoff Wait │                │\n│  └─────────────┘            └──────────────┘                │\n│       │ No                                                   │\n│       ▼                                                      │\n│  ┌─────────────┐     No     ┌──────────────┐                │\n│  │ Deps Met?   │───────────▶│   Skip Task  │                │\n│  └─────────────┘            └──────────────┘                │\n│       │ Yes                                                  │\n│       ▼                                                      │\n│  ┌─────────────┐                                            │\n│  │ Fire Agent  │ ▶ openclaw agents run \u003cagent\u003e \u003ctask\u003e       │\n│  └─────────────┘                                            │\n│                                                              │\n└──────────────────────────────────────────────────────────────┘\n```\n\n### Features\n\n- ✅ **HITL Integration** — Human-in-the-loop decision requests\n- ✅ **Rate-Limit Backoff** — Exponential backoff on API limits (default: 10min)\n- ✅ **Dependency Checking** — Respects task dependencies\n- ✅ **Cron Schedule** — Runs automatically every 1 minute\n\n```bash\n# Manual dry-run\nagi-farm dispatch\n\n# Check logs\ntail -f ~/.openclaw/workspace/logs/auto-dispatch.log\n```\n\n---\n\n## 🛠️ Installation from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN.git\ncd AGI-FARM-PLUGIN\n\n# Install dependencies\nnpm install\n\n# Build backend and dashboard\nnpm run build:all\n\n# Link to OpenClaw extensions\nln -s $(pwd) ~/.openclaw/extensions/agi-farm\n```\n\n\u003e If you later switch to `openclaw plugins install agi-farm`, remove the dev symlink first:\n\u003e `rm -f ~/.openclaw/extensions/agi-farm`\n\n---\n\n## 🧹 Uninstall Guide\n\n```bash\n# 1) Remove AGI Farm team data (agents, bundle, registries)\nagi-farm teardown\n\n# 2) Remove plugin from OpenClaw\nopenclaw plugins uninstall agi-farm --force\n\n# 3) Optional: remove standalone global CLI binary\nnpm uninstall -g agi-farm\n```\n\nNotes:\n- `agi-farm teardown` does not uninstall the plugin package.\n- `openclaw plugins uninstall agi-farm --force` removes the plugin install used by OpenClaw.\n\n---\n\n## 💻 Development\n\n```bash\n# Build everything (TS + Dashboard)\nnpm run build:all\n\n# Build backend only\nnpm run build\n\n# Watch mode for development\nnpm run dev\n\n# Type checking\nnpm run typecheck\n\n# Linting\nnpm run lint\n\n# Run unit tests (Jest + ESM)\nnpm test\n\n# Start dashboard server manually\nnpm run start-dashboard\n```\n\n---\n\n## 🔧 Troubleshooting\n\n| Symptom | Fix | Command |\n|---------|-----|---------|\n| ❌ Plugin fails to load | Check global install | `npm list -g agi-farm` |\n| ❌ `plugin already exists` on install | Use plugin update command | `openclaw plugins update agi-farm` |\n| 📊 Dashboard shows stale data | Sync with workspace | `agi-farm status` |\n| 🤖 Agent stuck \u003e30 min | Verify heartbeats | `cat ~/.openclaw/workspace/HEARTBEAT.md` |\n| ⚠️ `openclaw` not found | Add to PATH | `export PATH=$PATH:$(npm bin -g)` |\n| 🔐 Access Denied | Check npm login | `npm whoami` |\n| ⏰ Cron registration error | Clean crontab | `openclaw cron list --fix` |\n| 📄 JSON Parse Error | Re-run setup | `agi-farm setup --force` |\n\n---\n\n## 🔒 Security\n\nThis plugin is designed with defense-in-depth security:\n\n| Layer | Protection |\n|-------|-----------|\n| **Network** | Dashboard binds to `127.0.0.1` only — not exposed to LAN or internet |\n| **Origin validation** | `/api/session` gated by Origin/Referer — cross-origin token theft blocked |\n| **CSRF tokens** | All mutation endpoints require timing-safe CSRF token comparison; token rotates every 24h with 5-min grace period |\n| **SSE authentication** | `/api/stream` and `/api/data` require CSRF token — prevents cross-origin data exfiltration |\n| **Security headers** | CSP, X-Frame-Options (DENY), X-Content-Type-Options, Referrer-Policy |\n| **Input validation** | Agent IDs validated via `isSafeId()` regex — blocks path traversal |\n| **Input sanitization** | All user inputs (notes, messages, knowledge) stripped of control chars via `sanitizeText()`/`sanitizeNote()` |\n| **Rate limiting** | 120 req/min (read), 30 req/min (mutations), 20 req/min (session) per IP |\n| **Startup validation** | Workspace directory validated for existence and write access before server starts |\n| **File locking** | Per-file mutex (`withFileLockSync`) on all service read-modify-write operations — prevents concurrent corruption |\n| **Atomic writes** | All file mutations use `.tmp` → `rename` pattern with in-memory locks |\n| **Shell injection** | Update installer uses `execFile` (not `exec`) to prevent injection |\n| **Credential isolation** | Uses OpenClaw CLI — no API keys stored in plugin |\n| Supports encrypted secrets (`SECRETS/`, AES-256-GCM) | Expose secret values in API responses |\n\n**Your credentials stay in OpenClaw's configuration.**\n\n---\n\n## 📚 Plugin vs Skill\n\nAGI Farm was migrated from a **skill** to a **plugin** because it:\n\n| Requirement | Skill | Plugin |\n|-------------|-------|--------|\n| Background services | ❌ | ✅ Dashboard server |\n| Complex wizard (15+ steps) | ⚠️ | ✅ Better UX |\n| System integration | ❌ | ✅ Cron, LaunchAgent |\n| Configuration management | ⚠️ | ✅ Schema-based |\n\nThe embedded `skills/agi-farm/SKILL.md` provides documentation reference for agents.\n\n---\n\n## 🔄 OpenClaw Compatibility\n\nAGI Farm ensures compatibility with OpenClaw through **automated testing** and **proactive monitoring**:\n\n### Automated Compatibility Testing\n- **Weekly testing** against multiple OpenClaw versions (latest, previous, oldest-supported, beta)\n- **Performance benchmarks** to detect regressions (load time, validation time thresholds)\n- **API deprecation scanning** with automated replacement suggestions\n- **Automated PR creation** for compatibility fixes when breaking changes detected\n\n### Supported Versions\n- **Minimum**: OpenClaw 1.0.0+\n- **Tested**: Latest stable + previous stable + beta (when available)\n- **Status**: All compatibility tests run weekly via GitHub Actions\n\n### For Users\nCheck compatibility before upgrading OpenClaw:\n```bash\n# Check current OpenClaw version\nopenclaw --version\n\n# Run validation\nnpm run validate\n\n# View compatibility matrix\ncat OPENCLAW_COMPATIBILITY.md\n```\n\n### For Maintainers\nThe enhanced compatibility system includes:\n- Multi-version testing matrix (4 versions tested)\n- Performance regression detection (\u003c5s load time, \u003c3s validation)\n- Automated issue creation when incompatibility detected\n- Optional automated PR generation with suggested fixes\n\n**See:** [OPENCLAW_COMPATIBILITY.md](OPENCLAW_COMPATIBILITY.md) for complete compatibility guide.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## 🙏 Acknowledgments\n\nThis plugin integrates production-ready AI resources from the following exceptional projects:\n\n### Agency-Agents (NEW in v1.6.0)\n- **Repository**: https://github.com/msitarzewski/agency-agents\n- **Author**: [@msitarzewski](https://github.com/msitarzewski)\n- **Achievement**: 50+ requests in first 12 hours on Reddit, months of production iteration\n- **Integration**: 59 specialized agent personalities across 11 categories\n- **Impact**: Battle-tested workflows for Engineering, Design, Marketing, Product, PM, Testing, Support, Spatial Computing, and Strategy\n\nThe Agency-Agents collection dramatically expands AGI Farm's agent library with proven personalities including:\n- **Agents Orchestrator** - Meta-agent for pipeline management (PM → Architect → Dev-QA Loop → Integration)\n- **Evidence Collector** - Screenshot-based QA (defaults to finding 3-5 issues minimum)\n- **Reality Checker** - Production readiness certification (defaults to \"NEEDS WORK\")\n- **Whimsy Injector** - Delightful UX enhancements that serve functional or emotional purpose\n- **Reddit Community Builder** - Authentic community engagement patterns\n\n**Special thanks to @msitarzewski for creating and sharing these exceptional agent personalities with the community.**\n\n### Everything Claude Code (ECC)\n- **Repository**: https://github.com/affaan-m/everything-claude-code\n- **Author**: [@affaan-m](https://github.com/affaan-m)\n- **Achievement**: Winner of Anthropic's Claude Code hackathon\n- **Integration**: 510 resource files (16 agents, 69 skills, 33 commands, 7 guides)\n- **Impact**: Industry-standard TDD workflows, security scans, API design patterns, and framework templates for Python/Django/Spring Boot/Go/Swift/PostgreSQL\n\nThe ECC framework provides the foundation for AGI Farm's production-ready coding capabilities, including:\n- Test-driven development workflows with 80%+ coverage enforcement\n- Comprehensive security scanning and vulnerability detection (via AgentShield)\n- API design patterns and best practices\n- Framework-specific templates and conventions\n- Auto-delegation based on agent roles\n\n**Special thanks to @affaan-m for creating and open-sourcing this exceptional framework.**\n\n### Combined Impact\n\n**Total Integrated Resources**:\n- **91 agent templates** (16 AGI Farm + 16 ECC + 59 Agency-Agents)\n- **69 production skills** (ECC)\n- **33 slash commands** (ECC)\n- **7 quality automation hooks** (AGI Farm)\n- **10,000+ lines** of agent personalities and workflows\n\nAGI Farm is proud to stand on the shoulders of these giants, combining the best of community-driven AI agent development into a single, cohesive plugin.\n\n---\n\n## 📝 License\n\nMIT License — built for [OpenClaw](https://docs.openclaw.ai)\n\nCopyright (c) 2025 oabdelmaksoud\n\n## 📈 Star History\n\n\u003ca href=\"https://www.star-history.com/?repos=oabdelmaksoud%2FAGI-FARM-PLUGIN\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/image?repos=oabdelmaksoud/AGI-FARM-PLUGIN\u0026type=date\u0026theme=dark\u0026legend=bottom-right\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/image?repos=oabdelmaksoud/AGI-FARM-PLUGIN\u0026type=date\u0026legend=bottom-right\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/image?repos=oabdelmaksoud/AGI-FARM-PLUGIN\u0026type=date\u0026legend=bottom-right\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n\n## 🔗 Links\n\n- **GitHub**: https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN\n- **Issues**: https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN/issues\n- **OpenClaw Docs**: https://docs.openclaw.ai\n- **NPM Package**: https://www.npmjs.com/package/agi-farm\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ for the OpenClaw community**\n\n[⬆ Back to Top](#-agi-farm)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foabdelmaksoud%2Fagi-farm-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foabdelmaksoud%2Fagi-farm-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foabdelmaksoud%2Fagi-farm-plugin/lists"}