tmppr
local PR review for AI coding agents
Last verified:
What is tmppr?
tmppr is an autonomous PR coordination tool designed for AI agents and humans to work together through pull requests. It provides every agent with a shared local forge where they can open PRs, run CI, review each other's work, file issues, trigger follow-up agents, and merge through user-defined rules. The tool runs entirely on your local machine at 127.0.0.1, ensuring your code never leaves your box without cloud sync, telemetry, or required accounts.
Key features include a GitHub-style diff viewer with side-by-side and unified diffs, syntax highlighting, inline code comments, threaded replies, and per-revision interdiff tracking. It runs real CI locally by executing your existing GitHub Actions workflow YAML with live log streaming and ANSI colors. The tool enforces merge gates with tmppr ready reports showing GO/NO-GO status from review approval, CI status, and conflict checks. It offers a first-class CLI for agents where every action has a scriptable interface, plus swappable agent providers supporting Claude Code, Codex, opencode, aider, or custom commands.
tmppr is built for teams and developers using autonomous coding agents who want proper review infrastructure without pushing every experimental branch to GitHub. It includes full-lifecycle agent triggers for event-driven automation, MCP server built in for Claude Code and Codex integration, stacked-PR workflow for chaining dependent branches, and the @tmppr/plugin-sdk for extending functionality withoutforking. The native desktop app works on macOS, Linux, and Windows with bundled SQLite, server, and web UI.
tmppr pricing
Pricing model: Freemium
tmppr local is free forever - self-hosted on 127.0.0.1 with unlimited local repos, branches, PRs, AI agents, local CI, swappable agent providers, lifecycle triggers, built-in MCP server, and plugin SDK. Includes native desktop app for macOS/Linux/Windows with bundled SQLite, server, and web UI. tmppr Cloud is the paid surface at $20/month for tmppr Cloud Pro, including cloud CI runners (managed pool for shared compute with real-time log streaming via tmppr cloud run) and hosted remote repositories (shared origin for teams to push, fetch, and review). Local stays free; paid surfaces are only cloud runners and hosted repos.
tmppr pros
- Code never leaves your machine - binds to 127.0.0.1
- No cloud sync, telemetry, or required account for local use
- Free forever for local use with unlimited repos and PRs
- GitHub-style diff viewer with syntax highlighting
- Real CI runs locally using existing GitHub Actions YAML
- Live log streaming with ANSI colors for CI
- Enforced merge gates with GO/NO-GO reports
- First-class scriptable CLI for all agent actions
- Swappable agent providers - Claude Code, Codex, opencode, aider
- Built-in MCP server auto-registered on init
- Event-driven automation triggers for full lifecycle
- Stacked-PR workflow for dependent branches
- Plugin SDK extends without fork or rebuild
- One-command onboarding with tmppr init
- Native desktop app for macOS, Linux, Windows
- Bundled SQLite, server, and web UI - zero infra
- Trusted LAN runners for shared CI on own network
- Side-by-side and unified diffs with inline comments
- Threaded replies with file-viewed state tracking
- Isolated worktrees prevent agents stepping on each other
tmppr cons
- Cloud runners required for shared minutes or bigger boxes
- Hosted remote repositories are paid feature at $20/month
- Local-only by default - no built-in team shared origin
- Cloud login needed for hosted repos with SSO
- Burst to cloud runners when local hardware insufficient
- Plugin SDK requires installing packages separately
- No webhooks-only option - full forge required
- Signed builds and auto-update require optional cloud check
Frequently asked questions about tmppr
What does local use include?
Local use includes local repositories, local PR review, local CI, agents, and your own machines - all free. You get unlimited local repos, branches, and PRs; unlimited AI agents locally; local CI with trusted LAN runners; swappable agent providers plus lifecycle triggers; built-in MCP server; and plugin SDK. The native desktop app works on macOS, Linux, and Windows with signed builds and local updates.
Is tmppr open source?
The core engine is MIT-licensed and developed in the open. The packaged desktop app adds installer, signed builds, auto-update channel, and polish. You can build from source if you prefer to run it without the packaged app.
Does my code or PR data leave my machine?
No. tmppr binds to 127.0.0.1 by default with no account, required cloud, or telemetry for local use. Your code only leaves your machine if you choose hosted remote repositories, optional update checks, or CI runs you explicitly trigger to cloud runners.
How does this work with Claude Code, Cursor, Codex, or Aider?
Any agent that can run a shell command can drive tmppr. Point your agent at the tmppr CLI to open PRs, leave review comments, request changes, rerun CI, and check readiness. Authorship is recorded so you can tell human review from agent review at a glance. The built-in MCP server exposes all tmppr actions as native tools to Claude Code and Codex.
Can I extend tmppr without forking it?
Yes. The @tmppr/plugin-sdk lets a single package add agent providers, automation triggers, merge rules, hook executors, event subscribers, HTTP routes, and config. Install with tmppr plugin install <pkg> - no patches to the core and nothing to keep in sync with a fork. Plugins run locally and free on your machine alongside tmppr local.
What about teams or multiple machines?
Use tmppr on as many of your own machines as you want. Trusted LAN runners let CI execute on a beefier desktop while you review on a laptop. If you need a shared remote place to push, fetch, and review, tmppr-hosted remote repositories are the paid path at $20/month for tmppr Cloud Pro.
What are cloud runners?
Cloud runners are a managed CI runner pool you dispatch to with tmppr cloud run. Logs stream back to your machine in real time. It uses the same workflow YAML and review surface - just compute that isn't your laptop. Use it when local hardware isn't enough or when a team wants shared runs.
What will tmppr charge for?
tmppr Cloud has two paid surfaces: cloud CI runners (managed compute pool for shared minutes or bigger boxes) and hosted remote repositories (shared origin for teams). Local repos, reviews, CI, and agents stay local and free forever.
How do I get started with tmppr?
Start with one-command onboarding: tmppr init turns any git repo into a tmppr remote, installs the agent trigger bundle, sets your default provider, and registers the MCP server. Download the free native desktop app for macOS, Linux, or Windows, open the app, push a branch, and review.
What is the stacked-PR workflow?
The stacked-PR workflow lets you chain dependent branches into a stack and operate on the whole thing. You can rebase, sync, and ship stacked PRs in order without untangling them by hand. This is built-in support that GitHub requires manual work for and alternatives like Gitea/Forgejo don't have.