Factory Agent

Factory Agent

Autonomous Linear-to-PR agent. Delegate a Linear issue to it, get back a pull request with code, tests, and visual evidence. About a dollar per feature, about three minutes.

Linear ticket → webhook → Claude Managed Agents sandbox → GitHub PR

How it works

1. You create a Linear issue and delegate it to "Factory Agent"
2. A webhook fires to this server
3. The server spawns a Claude Managed Agent session in an isolated Anthropic sandbox (container with bash, file tools, Chromium, GitHub CLI, unrestricted network)
4. The agent clones your repo, reads CLAUDE.md / README.md for conventions, implements the feature, browser-tests it with Puppeteer, commits evidence screenshots, pushes a branch, and opens a PR
5. Progress streams back to Linear as agent activities; the issue moves to Done with the PR link

The whole thing is ~700 lines of TypeScript split across two files:

• src/server.ts - webhook handler, OAuth callback, signature verification
• src/agent.ts - Managed Agent session lifecycle, task message, event streaming, Linear activity relay

Prerequisites

• Bun 1.3+
• An Anthropic API key with Claude Managed Agents access
• A Linear workspace with admin access (to create an OAuth app)
• A public GitHub repo for the agent to work on, plus a Personal Access Token with repo scope
• A public URL for the webhook (fly.io, Railway, ngrok, hookdeck, etc.)

Setup

1. Clone and install

git clone https://github.com/your-org/factory-agent.git
cd factory-agent
bun install

2. Create a Linear OAuth app

Go to https://linear.app/settings/api/applications/new and create an app with:

• Name: Factory Agent (or whatever you like)
• Webhook URL: https://your-domain.com/webhook/linear
• Events: enable Agent session events (this is the crit