Factory Factory CLI
Factory Factory runs Claude Code and Codex in parallel, each in its own git worktree, with diffs and terminal in one window.
- 54 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- It starts agents with access to your repository, terminals and workspace scripts.
- It works through your GitHub CLI and agent accounts.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/factory-factoryDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- It starts agents with access to your repository, terminals and workspace scripts.
- It works through your GitHub CLI and agent accounts.
This is third-party code. Review the repository files before installing.
What it does
Factory Factory is a local workspace manager for AI coding agents. Each workspace gets its own git worktree and branch, so agents take separate tasks without stepping on each other. One window combines agent chat, diffs, files, an integrated terminal, issues and pull request status. A task can start from a GitHub or Linear issue, with Claude or Codex chosen for the session. The server opens in the browser with `npx factory-factory@latest serve`, and the database lives in `~/factory-factory/`. A macOS desktop app also exists.
Who it is for. Developers who work several tasks at once and want parallel Claude Code and Codex sessions under one overview.
Good fit when
- Three tracker tasks run at once and each needs its own branch.
- You want to compare how Claude and Codex solve the same task in separate workspaces.
- An agent finished and its changes must be reviewed in a diff before a pull request.
- Tasks are taken straight from GitHub or Linear issues.
Not a fit when
- Work runs with one agent and one branch.
- A cloud run is needed with no local machine.
- The required Node.js version is missing and GitHub CLI cannot be installed.
Example request
Open Factory Factory, create two workspaces from issues and start Claude in one and Codex in the other.Limitations
Node.js 26.8.1 or newer is required for the CLI, along with a local git repository and at least one agent provider: Claude or a ChatGPT account for Codex. Issues and pull requests need an authenticated GitHub CLI. The desktop app runs on macOS 13 and newer. At startup it checks Node.js and Git and offers fixes with a `[y/N]` prompt that defaults to no. Stopping the server ends the terminals and run scripts of the workspaces.
How to disable. Stop the server with Ctrl+C. An `npx` run needs no removal, while a global package is removed through npm. Delete the database and worktrees by hand: `~/factory-factory/` and the created branches.
FAQ
How do I start Factory Factory?
Run `npx factory-factory@latest serve` in a local repository. The interface opens in the browser and the database is created in `~/factory-factory/`.
Which agents are supported?
Claude and Codex. The Claude runtime ships in the package and signs in through the settings terminal. Codex needs a ChatGPT account.
Where do tasks come from?
Create a workspace by hand or from a GitHub or Linear issue. GitHub needs an authenticated `gh`.
What keeps agents apart?
Each workspace gets its own git worktree and branch. One agent's edits never reach another agent's copy.
How does the app update?
Supported installs show an Update button. Global npm installs on macOS and Linux update automatically, others get instructions.
Discussion
No questions or reviews yet.
Related
CLI toolsSoftware factory installer for Claude Code and Codex: a GitHub Issues queue, skills, gates and merges done only by a human.
A CLI that sets a project up for an agent in one command: skills, MCP and plan-driven development via /aif.
A CLI and Claude Code plugin taking GitHub issues through checks, plan, code, review and CI to merge, in parallel lanes
Xylocopa is a visual orchestrator for Claude Code agents: GTD tasks, parallel agents in git worktrees, phone approvals.
LoopForge Local adds a role-based dev workflow to Claude Code, Codex and Cursor: analysis, design, code, review and tests.
A tool and skill that let Claude Code hand tasks to Claude, Codex or OpenCode subagents in separate Git worktrees
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Factory Factory (this card) | no | 54 | ||
| Parallely | no | 118 | runs parallel tasks for agents; Factory Factory adds one window with chat, diff, terminal and pull request status | |
| Worktree Manager | no | not required | 64 | manages git worktrees; Factory Factory also runs Claude and Codex sessions in each tree |
README in short
The app runs locally and keeps chat, diff, terminal and pull request state in one window. Data sits in a database on your own disk.