Go from terminal to PR.

Plan, implement and inspect work without opening a browser. One command per step, from the plan to the pull request.

propr remote <url>
propr login
propr use owner/repo
propr plan create "Clean up auth flow" --wait
propr plan finalize <draft-id>
propr issue implement <draft-id>/1 --wait
propr task inspect <task-id>

Feature overview

You start with
A ProPR instance and the propr-cli package
You use
propr plan · propr issue · propr task
Takes
One-time setup, then one command per step

Connect once

Install propr-cli, point it at your instance, sign in, and pick a default repository.

npm install -g propr-cli
propr remote https://propr.example.com
propr login
propr use acme/payments

Create the plan and read its tasks

Create the plan, wait for generation, and print the draft. --json hands it to a script.

propr plan create "Add retry with backoff to the webhook sender" --wait
propr plan get <draft-id>

File the issues

Finalizing files one GitHub issue per task. propr plan issues lists them with their numbers.

propr plan finalize <draft-id>
propr plan issues <draft-id>

Implement one issue

Start the first issue in its own isolated workspace and wait for the pull request. Name the agent and model, or cap the spend, on the same line.

propr issue implement <draft-id>/1 --wait
propr issue implement <draft-id>/2 -a claude -m <model> --max-cost 5

Inspect the run

Read the task's state and full run history, or list everything that is active.

propr task inspect <task-id>
propr task inspect --state queued
propr task inspect <task-id> --json

Steer or back out

Post a follow-up, stop a run, or revert a commit from the PR, with --dry-run to preview the revert first.

propr task followup <task-id> "Also add a test for the timeout path"
propr task stop <task-id>
propr task revert acme/payments <pr> <sha> --dry-run

One CLI for the whole workflow.

The CLI also manages repositories, agents, settings, logs, goals, automations and todos, including turning repository notes into a plan. The CLI reference lists every command and flag.

What you get

A plan, an implemented issue and its PR, created and inspected from the terminal.

ProPR CLI → All playbooks