Botfarm

Botfarm

**[botfarm.run](https://botfarm.run)**

Autonomous Linear ticket dispatcher for Claude Code agents.

Botfarm polls your Linear board for "Todo" tickets, dispatches them to Claude Code agent workers running in parallel git worktrees, and manages the full pipeline: implement → review → fix → PR checks → merge.

Dashboard



Prerequisites

System Requirements

• Python 3.12+
• Node.js 18+ (Linear MCP tools are launched via npx)
• git
• 4 GB+ RAM recommended (2 GB is marginal with Claude Code running)

Claude Code

Install using the standalone installer:

curl -fsSL https://claude.ai/install.sh | bash

**Note:** Use `| bash`, not `| sh` — the latter fails on Ubuntu.

**Important:** The installer places `claude` in `~/.local/bin`, which may not be in your PATH. Add it now — without this step, `botfarm run` will fail with "claude not found":

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

**Node.js** is required — Linear MCP tools are launched via `npx` at runtime.

GitHub CLI

**Ubuntu 24.04:** The official apt repository may have GPG key issues. Use a direct `.deb` install instead:

GH_VERSION=$(curl -s https://api.github.com/repos/cli/cli/releases/latest | grep '"tag_name"' | sed 's/.*v//' | sed 's/".*//')
curl -fsSL "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.deb" -o /tmp/gh.deb
sudo dpkg -i /tmp/gh.deb

**Other systems:** Follow the [official instructions](https://github.com/cli/cli#installation).

Then authenticate:

gh auth login

Select the **SSH** protocol when prompted. This automatically generates and uploads an SSH key — no manual `ssh-keygen` needed.

GitHub SSH Host Key

On fresh machines, add GitHub's host key before cloning repos:

ssh-keyscan github.com >>