oh-my-pr DOCS
GitHub
Community
oh-my-pr Docs
Browse docs
All docs

# Getting Started

Welcome to oh-my-pr — the autonomous PR babysitter that watches the repositories and pull requests you choose, triages review feedback, and dispatches AI agents to fix code.

## Prerequisites

- Node.js 22+ — Download
- Git — installed and configured
- GitHub auth — `gh auth login`, `GITHUB_TOKEN`, or one or more saved dashboard tokens
- Local AI agent CLI — either `claude` or `codex` installed and authenticated

## Installation

Install from npm:

    npm install -g oh-my-pr

## Quick Start

### 1. Launch the dashboard

    oh-my-pr

This starts the web dashboard at http://localhost:5001 and opens it in your browser.

### Run from source

If you prefer to run from source instead:

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

### 2. Connect a GitHub repository

1. In the dashboard, click Add Repository.
2. Choose the repository discovery scope:
   - My PRs only keeps the repo on the default scope and auto-discovers only PRs authored by your authenticated GitHub account.
   - My PRs + teammates switches the repo to team-wide discovery and auto-discovers every open PR in that repository.
3. Add a direct PR URL when you want to track one pull request regardless of the repo's discovery scope.
4. Add GitHub credentials through the dashboard settings if you are not using `gh auth login` or `GITHUB_TOKEN`.

### 3. Watch oh-my-pr work

Once connected, oh-my-pr will:

- Monitor matching open pull requests in real time based on each watched repo's scope.
- Sync review comments and change requests.
- Triage feedback into actionable tasks.
- Dispatch AI agents (Claude Code or OpenAI Codex) to fix issues.
- Push the fixes back to the PR branch.

PRs added directly by URL are always tracked, even if the repo stays on My PRs only.

## Desktop App

oh-my-pr is also available as a native desktop application powered by Tauri:

    npm run tauri:dev    # Development
    npm run tauri:build  # Production build

## Next Steps

- PR Babysitter — Learn how autonomous PR monitoring works.
- Agent Dispatch — Understand how AI agents are dispatched to fix code.
- Configuration — Customize oh-my-pr for your workflow.

Next Configuration