dc64d18224
Fixes Gitea 500 error caused by invalid submodule reference. Converted antfarm from pseudo-submodule (missing .gitmodules) to regular directory with all source files. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
197 lines
6.5 KiB
Markdown
197 lines
6.5 KiB
Markdown
# Antfarm
|
|
|
|
<img src="https://raw.githubusercontent.com/snarktank/antfarm/main/landing/logo.jpeg" alt="Antfarm" width="80">
|
|
|
|
**Build your agent team in [OpenClaw](https://docs.openclaw.ai) with one command.**
|
|
|
|
You don't need to hire a dev team. You need to define one. Antfarm gives you a team of specialized AI agents — planner, developer, verifier, tester, reviewer — that work together in reliable, repeatable workflows. One install. Zero infrastructure.
|
|
|
|
```
|
|
$ install github.com/snarktank/antfarm
|
|
```
|
|
|
|
Tell your OpenClaw agent. That's it.
|
|
|
|
---
|
|
|
|
## What You Get: Agent Team Workflows
|
|
|
|
### feature-dev `7 agents`
|
|
|
|
Drop in a feature request. Get back a tested PR. The planner decomposes your task into stories. Each story gets implemented, verified, and tested in isolation. Failures retry automatically. Nothing ships without a code review.
|
|
|
|
```
|
|
plan → setup → implement → verify → test → PR → review
|
|
```
|
|
|
|
### security-audit `7 agents`
|
|
|
|
Point it at a repo. Get back a security fix PR with regression tests. Scans for vulnerabilities, ranks by severity, patches each one, re-audits after all fixes are applied.
|
|
|
|
```
|
|
scan → prioritize → setup → fix → verify → test → PR
|
|
```
|
|
|
|
### bug-fix `6 agents`
|
|
|
|
Paste a bug report. Get back a fix with a regression test. Triager reproduces it, investigator finds root cause, fixer patches, verifier confirms. Zero babysitting.
|
|
|
|
```
|
|
triage → investigate → setup → fix → verify → PR
|
|
```
|
|
|
|
---
|
|
|
|
## Why It Works
|
|
|
|
- **Deterministic workflows** — Same workflow, same steps, same order. Not "hopefully the agent remembers to test."
|
|
- **Agents verify each other** — The developer doesn't mark their own homework. A separate verifier checks every story against acceptance criteria.
|
|
- **Fresh context, every step** — Each agent gets a clean session. No context window bloat. No hallucinated state from 50 messages ago.
|
|
- **Retry and escalate** — Failed steps retry automatically. If retries exhaust, it escalates to you. Nothing fails silently.
|
|
|
|
---
|
|
|
|
## How It Works
|
|
|
|
1. **Define** — Agents and steps in YAML. Each agent gets a persona, workspace, and strict acceptance criteria. No ambiguity about who does what.
|
|
2. **Install** — One command provisions everything: agent workspaces, cron polling, subagent permissions. No Docker, no queues, no external services.
|
|
3. **Run** — Agents poll for work independently. Claim a step, do the work, pass context to the next agent. SQLite tracks state. Cron keeps it moving.
|
|
|
|
### Minimal by design
|
|
|
|
YAML + SQLite + cron. That's it. No Redis, no Kafka, no container orchestrator. Antfarm is a TypeScript CLI with zero external dependencies. It runs wherever OpenClaw runs.
|
|
|
|
### Built on the Ralph loop
|
|
|
|
<img src="https://raw.githubusercontent.com/snarktank/ralph/main/ralph.webp" alt="Ralph" width="100">
|
|
|
|
Each agent runs in a fresh session with clean context. Memory persists through git history and progress files — the same autonomous loop pattern from [Ralph](https://github.com/snarktank/ralph), scaled to multi-agent workflows.
|
|
|
|
---
|
|
|
|
## Quick Example
|
|
|
|
```bash
|
|
$ antfarm workflow install feature-dev
|
|
✓ Installed workflow: feature-dev
|
|
|
|
$ antfarm workflow run feature-dev "Add user authentication with OAuth"
|
|
Run: a1fdf573
|
|
Workflow: feature-dev
|
|
Status: running
|
|
|
|
$ antfarm workflow status "OAuth"
|
|
Run: a1fdf573
|
|
Workflow: feature-dev
|
|
Steps:
|
|
[done ] plan (planner)
|
|
[done ] setup (setup)
|
|
[running] implement (developer) Stories: 3/7 done
|
|
[pending] verify (verifier)
|
|
[pending] test (tester)
|
|
[pending] pr (developer)
|
|
[pending] review (reviewer)
|
|
```
|
|
|
|
---
|
|
|
|
## Build Your Own
|
|
|
|
The bundled workflows are starting points. Define your own agents, steps, retry logic, and verification gates in plain YAML and Markdown. If you can write a prompt, you can build a workflow.
|
|
|
|
```yaml
|
|
id: my-workflow
|
|
name: My Custom Workflow
|
|
agents:
|
|
- id: researcher
|
|
name: Researcher
|
|
workspace:
|
|
files:
|
|
AGENTS.md: agents/researcher/AGENTS.md
|
|
|
|
steps:
|
|
- id: research
|
|
agent: researcher
|
|
input: |
|
|
Research {{task}} and report findings.
|
|
Reply with STATUS: done and FINDINGS: ...
|
|
expects: "STATUS: done"
|
|
```
|
|
|
|
Full guide: [docs/creating-workflows.md](docs/creating-workflows.md)
|
|
|
|
---
|
|
|
|
## Security
|
|
|
|
You're installing agent teams that run code on your machine. We take that seriously.
|
|
|
|
- **Curated repo only** — Antfarm only installs workflows from the official [snarktank/antfarm](https://github.com/snarktank/antfarm) repository. No arbitrary remote sources.
|
|
- **Reviewed for prompt injection** — Every workflow is reviewed for prompt injection attacks and malicious agent files before merging.
|
|
- **Community contributions welcome** — Want to add a workflow? Submit a PR. All submissions go through careful security review before they ship.
|
|
- **Transparent by default** — Every workflow is plain YAML and Markdown. You can read exactly what each agent will do before you install it.
|
|
|
|
---
|
|
|
|
## Dashboard
|
|
|
|
Monitor runs, track step progress, and view agent output in real time.
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
antfarm dashboard # Start on port 3333
|
|
antfarm dashboard stop # Stop
|
|
antfarm dashboard status # Check status
|
|
```
|
|
|
|
---
|
|
|
|
## Commands
|
|
|
|
### Lifecycle
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `antfarm install` | Install all bundled workflows |
|
|
| `antfarm uninstall [--force]` | Full teardown (agents, crons, DB) |
|
|
|
|
### Workflows
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `antfarm workflow run <id> <task>` | Start a run |
|
|
| `antfarm workflow status <query>` | Check run status |
|
|
| `antfarm workflow runs` | List all runs |
|
|
| `antfarm workflow resume <run-id>` | Resume a failed run |
|
|
| `antfarm workflow list` | List available workflows |
|
|
| `antfarm workflow install <id>` | Install a single workflow |
|
|
| `antfarm workflow uninstall <id>` | Remove a single workflow |
|
|
|
|
### Management
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `antfarm dashboard` | Start the web dashboard |
|
|
| `antfarm logs [<lines>]` | View recent log entries |
|
|
|
|
---
|
|
|
|
## Requirements
|
|
|
|
- Node.js >= 22
|
|
- [OpenClaw](https://github.com/openclaw/openclaw) running on the host
|
|
- `gh` CLI for PR creation steps
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|
|
|
|
---
|
|
|
|
<p align="center">Part of the <a href="https://docs.openclaw.ai">OpenClaw</a> ecosystem · Built by <a href="https://ryancarson.com">Ryan Carson</a></p>
|