agent-farm-cli

library0.1.72jsnpmunverified

Node.js CLI for parallel agent farms with queue/worker/review loops. Current stable version: 0.1.72 (pre-release, frequent updates). Key features include parallel queue processing, plan/review cycles, lease recovery, poison task isolation, insights/doctor observability, optional AI semantic acceptance testing with failure injection, MCP integration for Cursor, and CI health checks. Differentiators: built for multi-agent orchestration, supports deduplication, batch dispatch, and Windows compatibility. Peer dependency on @cursor/sdk >=0.1.0.

devops

npm install agent-farm-cli

package ↗

INSTALL

IMPORT

SIG · AGENT-FARM-CLI

agent-farm-cli

devopsjavascriptv0.1.72

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

agentFarm CLI (global command)

✓ npm i -g github:BK201-Drama/agent-farm-cli

✗ npm i -g agent-farm-cli (will try npm registry, not GitHub)

Install from GitHub only; no npm registry package yet. Use global install for CLI access.

MCP server

✓ node dist/interfaces/mcp/server.js

✗ node src/interfaces/mcp/server.ts

Must use compiled JS from dist; TypeScript source will not run directly.

agentFarm project init

✓ npx agent-farm project init --target-dir .

✗ npm run agent-farm project init (not a script in package.json)

Requires global install or npx; local npm scripts not predefined.

Demonstrates three-step workflow: add a task to the queue, start worker pool, then run health check.

agent-farm queue add --prompt "Implement login endpoint" --task-id t1 --dedupe-key auth-login agent-farm worker --workers 2 --command-template 'echo {prompt}' agent-farm doctor

Debug

Known issues

breakingDo not pipe execute/verify/ai-review long output to head/tail/wc. Child processes may receive SIGPIPE and fail.

fix

Avoid truncation pipes; use redirection to file if needed.

affects: >=0.1.0

deprecatedWindows dispatch via 'npm run farm:dispatch:node' only works inside this repository, not as a standalone command.

fix

Use 'agent-farm queue add' and 'agent-farm worker' directly on Windows.

affects: >=0.1.0

gotchaThe CLI default installs from GitHub, not npm. Running 'npm i -g agent-farm-cli' without repo prefix will fail.

fix

Use 'npm i -g github:BK201-Drama/agent-farm-cli' or clone and run 'npm link'.

affects: >=0.1.0

gotchaMCP server requires compiled dist directory; running from source (TS) will fail.

fix

Build first: 'npm run build', then execute 'node dist/interfaces/mcp/server.js'.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module '@cursor/sdk'

Missing peer dependency @cursor/sdk

fix

Install peer dep: npm install @cursor/sdk@>=0.1.0

agent-farm: command not found

CLI not installed globally or not in PATH

fix

Run 'npm i -g github:BK201-Drama/agent-farm-cli' or use npx: 'npx agent-farm ...'

SyntaxError: Unexpected token 'export' (when running MCP server)

Running TypeScript source instead of compiled JS

fix

Run compiled JS: 'node dist/interfaces/mcp/server.js' (build first with 'npm run build')

Upgrade

Version history

0.1.72latest on npm

Audit

Dependencies

@cursor/sdkrequiredRequired for MCP server integration and Cursor tooling support

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

packageagent-farm-cli ↗