Skip to main content
ProPR

Documentation

Self-hosted, open-source platform that turns GitHub issues and plans into agent-implemented, reviewable pull requests — with planning, isolated execution, PR commands, and full task records.

Quickstart

The ProPR CLI is the stack control plane: it scaffolds the runtime directory, verifies the host, and starts the prebuilt images on a Docker-capable Linux host. Configure GitHub access (your own GitHub App, or a shared App that propr setup enrolls for you) and authenticate at least one agent CLI on the host.

Full walkthroughs: local, server, or from source — including a launcher-container path that needs no Node.js.

npm install -g @propr/cli # Node.js 22+; prefix with sudo only if your global npm prefix requires it

mkdir propr && cd propr
propr setup # interactive wizard: checks, scaffold, images, GitHub auth, start
# safe to re-run; it skips anything already configured

# Prefer to drive each step yourself? The manual flow still works:
# propr init stack # scaffold .env + data/ logs/ repos/, detect agent credentials
# propr check # verify Docker, images, agents, and GitHub auth
# propr start # pull images and start the stack with a live dashboard
# propr ui # open the Web UI

Global install failing or needing sudo on a system Node? See Local Setup for install-prefix notes.

Set Up ProPR

GitHub App, agent credentials, and the one-command launcher.

Run Your First Task

From a labeled issue or a Planner Studio draft to a reviewed pull request.

PR Commands

Drive follow-up work from the pull request conversation.

Agents and Models

Claude Code, Codex, Antigravity, OpenCode, and Mistral Vibe with the full model catalog.

ProPR CLI

Plans, tasks, repositories, agents, and to-dos from the terminal.

Operate the Stack

Deployment, backups, updates, and troubleshooting.

Observability

Task records, live logs, dashboards, and Agent Tank capacity tracking.

Architecture

How the daemon, workers, queue, git layer, and agent runtimes fit together.