# Antfarm Workflows > Multi-agent workflow orchestration for OpenClaw. Use when user mentions antfarm, asks to run a multi-step workflow (feature dev, bug fix, security audit), or wants to install/uninstall/check status of antfarm workflows. Use when this capability is needed. - Skill: `tomevault-io/antfarm-workflows` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/antfarm-workflows` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/antfarm-workflows/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/antfarm-workflows --- # Antfarm Multi-agent workflow pipelines on OpenClaw. Each workflow is a sequence of specialized agents (planner, developer, verifier, tester, reviewer) that execute autonomously via cron jobs polling a shared SQLite database. All CLI commands use the full path to avoid PATH issues: ```bash node ~/.openclaw/workspace/antfarm/dist/cli/cli.js ``` Shorthand used below: `antfarm-cli` means `node ~/.openclaw/workspace/antfarm/dist/cli/cli.js`. ## Workflows | Workflow | Pipeline | Use for | |----------|----------|---------| | `feature-dev` | plan -> setup -> develop (stories) -> verify -> test -> PR -> review | New features, refactors | | `bug-fix` | triage -> investigate -> setup -> fix -> verify -> PR | Bug reports with reproduction steps | | `security-audit` | scan -> prioritize -> setup -> fix -> verify -> test -> PR | Codebase security review | ## Core Commands ```bash # Install all workflows (creates agents + starts dashboard) node ~/.openclaw/workspace/antfarm/dist/cli/cli.js install # Full uninstall (workflows, agents, crons, DB, dashboard) node ~/.openclaw/workspace/antfarm/dist/cli/cli.js uninstall [--force] # Start a run node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow run "" # Check a run node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow status "" # List all runs node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow runs # Resume a failed run from the failed step node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow resume # View logs node ~/.openclaw/workspace/antfarm/dist/cli/cli.js logs [lines] # Dashboard node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard [start] [--port N] node ~/.openclaw/workspace/antfarm/dist/cli/cli.js dashboard stop ``` ## Before Starting a Run The task string is the contract between you and the agents. A vague task produces bad results. **Always include in the task string:** 1. What to build/fix (specific, not vague) 2. Key technical details and constraints 3. Acceptance criteria (checkboxes) Get the user to confirm the plan and acceptance criteria before running. ## How It Works - Agents have cron jobs (every 15 min, staggered) that poll for pending steps - Each agent claims its step, does the work, marks it done, advancing the next step - Context passes between steps via KEY: value pairs in agent output - No central orchestrator — agents are autonomous ## Force-Triggering Agents To skip the 15-min cron wait, use the `cron` tool with `action: "run"` and the agent's job ID. List crons to find them — they're named `antfarm//`. ## Workflow Management ```bash # List available workflows node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow list # Install/uninstall individual workflows node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow install node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall node ~/.openclaw/workspace/antfarm/dist/cli/cli.js workflow uninstall --all [--force] ``` ## Creating Custom Workflows See `{baseDir}/../../docs/creating-workflows.md` for the full guide on writing workflow YAML, agent workspaces, step templates, and verification loops. ## Agent Step Operations (used by agent cron jobs, not typically manual) ```bash node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step claim # Claim pending step node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step complete # Complete step (output from stdin) node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step fail # Fail step with retry node ~/.openclaw/workspace/antfarm/dist/cli/cli.js step stories # List stories for a run ``` --- > Source: [snarktank/antfarm](https://github.com/snarktank/antfarm) — distributed by [TomeVault](https://tomevault.io).