Code Factory

Local-first GitHub PR babysitter for Codex and Claude.

Code Factory logo

Code Factory watches GitHub repositories, syncs PR feedback, triages what matters, and dispatches locally installed coding agents inside isolated app-owned worktrees. It keeps durable state in ~/.oh-my-pr and exposes the same system through a dashboard, REST API, and MCP server.

No hosted service. No agent edits inside your working copy. Your PR automation stays on your machine.

Features

Watch multiple repositories or add a single PR by URL.
Auto-register open PRs, archive closed or merged PRs, and keep syncing review activity.
Store PR state, questions, logs, and social changelogs in SQLite with mirrored log files.
Triage feedback into accept, reject, or flag, with manual overrides and retry for failed or warned items.
Run codex or claude in isolated worktrees under ~/.oh-my-pr, then push verified fixes back to the PR branch.
Evaluate review comments and failing CI statuses, post GitHub follow-ups, and resolve review threads.
Detect merge conflicts and optionally let the agent resolve them automatically.
Ask natural-language questions about any tracked PR from the dashboard or via MCP.
Configure trusted reviewers, ignored bots, polling, batching, and run limits from settings.
Enable drain mode to pause new work and wait for active runs to finish before deploys or upgrades.
Check onboarding status, install Claude or Codex review workflows, and generate social changelogs every 5 PRs merged to main.
Use the React dashboard, local REST API, MCP server, or optional Tauri desktop shell.

How It Works

Add a repository to the watch list or register a PR directly by URL.
The watcher polls GitHub, auto-registers open PRs, syncs reviews and comments, archives PRs that closed upstream, and queues babysitter runs.
Accepted work is executed in an app-owned repo cache and isolated git worktree under ~/.oh-my-pr.
The agent applies fixes, verifies the result, pushes to the PR branch, updates GitHub threads, and writes logs for the full run.

Quick Start

npm install -g oh-my-pr
oh-my-pr

That's it. The dashboard opens in your browser at http://localhost:5001.

Prerequisites

Node.js 22+ (tested with Node v24.12.0)
git
GitHub auth via gh auth login, GITHUB_TOKEN, app config, or a saved dashboard token
Either the codex CLI or claude CLI installed and authenticated locally

CLI Usage

oh-my-pr              Start the dashboard server (opens browser)
oh-my-pr --help       Show help message
oh-my-pr --version    Print the version

Set PORT to change the default port (5001).

Run From Source

git clone https://github.com/yungookim/oh-my-pr.git
cd oh-my-pr
npm install
npm run dev

The dashboard is served on port 5001 by default. All /api/* routes are restricted to loopback callers.

MCP and API

Code Factory exposes the same local system through REST and MCP.

npm run mcp

Use it with MCP hosts such as Claude Desktop or OpenClaw, or call the REST API directly from local tooling. Full endpoint and tool docs live in LOCAL_API.md.

Docs

Development

Command	Purpose
`npm run dev`	Start the development server
`npm run build`	Build the production bundle
`npm run start`	Run the production build
`npm run mcp`	Start the MCP server
`npm run check`	Run TypeScript checks
`npm run lint`	Run ESLint
`npm run test`	Run the server test suite
`npm run tauri:dev`	Start the Tauri desktop app in development
`npm run tauri:build`	Build the Tauri desktop app

Local State

By default Code Factory stores its runtime data in ~/.oh-my-pr:

state.sqlite for durable app state
log/ for mirrored activity logs
repos/ for app-owned repository caches
worktrees/ for isolated PR worktrees

Set OH_MY_PR_HOME to override the root path. The legacy CODEFACTORY_HOME name is still supported for compatibility.

Contributing

See CONTRIBUTING.md.

oh-my-pr