Getting started

Install the desktop app

Grab the installer for macOS, Windows, or Linux from the download page. The app bundles the local server, the web UI, and the tmppr CLI — install the CLI from the app menu on first launch. The server listens on 127.0.0.1:4390.

Initialize a repository

From any git repo:

cd your-project
tmppr init

tmppr init registers the repo with your local server and makes tmppr your origin remote. If an origin already exists (for example GitHub), it is renamed to remote so nothing is lost. It also sets up agent workflow markers and the tmppr MCP server for coding agents — pass --no-agents or --no-mcp to skip those, or --remote-name to keep your existing origin untouched.

Push a branch

git checkout -b my-change
# ...edit, commit...
git push -u origin my-change

Pushes land on your local server. Post-receive hooks keep pull requests and CI in sync with every subsequent push.

Open your first pull request

tmppr pr open --push --base main --head "$(git branch --show-current)"

--push pushes the branch first if you haven't; the title and body are inferred from your commit messages if you don't pass --title / --body. Review the diff in the app or at http://127.0.0.1:4390.

Run CI

Pushes dispatch CI automatically once checks are configured. You can also drive it by hand:

tmppr ci dispatch <pr>   # start a CI run for a PR
tmppr ci runs           # list recent runs
tmppr ci log <check>    # readable log for one check
tmppr ci rerun <pr>     # run the checks again