// readme

Turn issues into branches, steer multiple agents, review changes, and keep pull requests moving from one local command center.

Factory Factory is a local workspace manager for AI coding agents. Every workspace gets its own git worktree and branch, so agents can work on separate tasks without stepping on each other. The UI brings chat, diffs, files, terminals, issues, and pull request status together in one place.

Quick start

You will need:

  • Node.js 26.12.1+ for the CLI and development (pinned in .node-version); the desktop app uses Electron 45.0’s bundled Node.js 24.22 runtime
  • macOS 13 (Ventura) or newer for the macOS desktop app
  • A local git repository
  • At least one agent provider:
    • Claude (runtime included), authenticated through the setup terminal in Settings or with pnpm dlx factory-factory@latest claude auth login
    • A ChatGPT/Codex account configured for Codex sessions
  • The authenticated GitHub CLI for GitHub issues and pull requests

Start Factory Factory without installing it:

npx factory-factory@latest serve

Before starting, ff serve checks the Node.js version, Git, and the files needed for the…