Harness Configurator: Switch agent setups for Claude Code and Codex CLIs without reinstalling everything
Agent Farm
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
**Load the right skills for each job. Keep your native terminal.**
Agent Farm is a harness configurator. A harness is the full working setup around
an AI model — instructions, tools, permissions, and checks. Agent Farm lets you
save different setups and switch between them without reinstalling everything
for every conversation.
Pick a setup, point it at a repo, and Agent Farm opens your native Claude Code
or Codex terminal with that configuration loaded.
Think of each setup as a desk prepared for a job. For SEO, you might lay out site
references, search tools, and a skill that walks through researching and improving
a page. For presentations, you bring brand guidelines, slide tools, and a workflow
for turning an outline into a story. Each setup keeps the relevant material close
to the work.
Install
Requires **Node 22.15+** on macOS, Linux, or Windows, and the Claude Code and/or
Codex CLI installed and authenticated. On Windows, turn on Developer Mode
(Settings > System > For developers) before launching Codex profiles or running
agent-farm set global, because those link individual files.
agent-farm init checks your prerequisites, installs the default greenfield
plugin (its profiles and skills), explains how everything fits together, and
offers to launch your first session. The orchestra and bigbrain plugins ship in the same
package but are installed only when you ask for them. After
upgrading Agent Farm, rerun agent-farm plugin install and
agent-farm plugin install NAME for each plugin you use, to pick up new profiles.
Launched agents run without permission prompts (Claude
--dangerously-skip-permissions, Codex --yolo). Read
docs/operations.md before pointing one at a repository
you care about.
To work on Agent Farm itself, see docs/development.md.
Profiles
Agent Farm ships with profiles ready to use. With greenfield and orchestra
installed, agent-farm shows a menu like this (abridged):
Highlight a profile to see what it's for, or press Tab to show every
profile's description at once.
**Plan** — greenfield/planner helps you understand a problem, decide what
to do, and write the plan. Start here.
**Build** — greenfield/implementer is the AI model on its own plus a few good
habits: it builds a plan or a clear task into a pull request and watches it until
checks are green. orchestra/overseer builds, tests, and reviews a task into a
pull request with little hand-holding.
**Check** — greenfield/reviewer reviews a pull request from many angles at
once. greenfield/qa-and-fix tests a finished pull request, fixes small safe
problems, and tells you when it's ready. greenfield/simplify-and-refactor
asks whether an open pull request could be simpler and applies only the
cleanup you approve.
**More** (all in greenfield) — product-researcher for research write-ups,
business for business documents, seo for search content, audits for
finding outdated issues and docs, and code-smell-fixes for an unattended
whole-codebase hunt for confusing code that ends in fix PRs and issues.
These profiles used to live in the dcouple plugin, which still ships for
existing installs. dcouple/raw became greenfield/implementer; dcouple/ideate
and dcouple/implementer were not moved. An installed dcouple keeps working
until you run agent-farm plugin uninstall dcouple.
**bigbrain** — An opt-in alternative to greenfield (agent-farm plugin install bigbrain): you talk only to bigbrain/orchestrator, which relays every worker's questions to you, every plan carries a control flow the implementer runs step by step, reviews happen only at planned points or on your word, and every document passes a bundled checker. See plugins/bigbrain/README.md.