Skip to main content
This section takes you from an empty machine to your first PRFlow pull request. PRFlow is an agent plugin for Claude Code and Codex. It takes a GitHub issue and carries it through planning, implementation, verification, review and documentation, then leaves you a pull request. You keep final review and merge control. PRFlow never merges the pull request for you. PRFlow works best in an established repository, where a change has to follow architecture, tests and documentation conventions that already exist.
If you want the shortest possible path, read the Quickstart first. It covers install and first run on one page. Come back here when you want the detail behind each step.

Follow the Steps in Order

Requirements

The tools PRFlow needs on your machine and the GitHub access it needs on your account.

Installation

Add the marketplace and install the plugin in Claude Code, Codex CLI or Codex in the ChatGPT desktop app.

Initialization

Run /prflow:init to scaffold repository configuration and detected tool permissions.

First Run

Run /prflow:implement on a real issue and read the progress workpad it writes.

Updates

Move an existing installation to a newer release, locally and in the cloud.

Migrate from DevFlow

Move a repository that was set up before the PRFlow rename.

Choose Where Runs Execute

Local runs use the tools, credentials and permission system already present in Claude Code or Codex. They are the fastest way to start, and nothing else is required. Cloud runs use GitHub Actions and repository credentials, so a run can start from a comment on an issue. Add them after the local workflow fits your team.