CLI reference

The tmppr CLI drives everything: local PRs and CI, Cloud login, migration, and org administration. Every command supports --help for full flags.

tmppr init

Onboard the current git repo: add the tmppr remote, register agent triggers, and write agent markers. tmppr becomes your origin; any pre-existing origin is renamed to remote.

Flag	What it does
`--name`	Repository name (defaults to the directory name)
`--remote-name`	Remote name to use (default `origin`)
`--provider`	Default agent provider: `claude`, `codex`, `opencode`, `aider`, `custom`
`--no-agents` / `--no-mcp`	Skip the agent trigger bundle / MCP registration

tmppr pr

Open, inspect, update, review, merge, rebase, and close pull requests.

Subcommand	What it does
`open`	Open a PR for a branch; `--push` pushes first, title/body inferred from commits
`list`	List pull requests
`show` / `view`	Show PR details / open it in the browser UI
`diff` / `files`	Show the PR diff / changed files
`timeline`	Show PR activity
`sync`	Sync a PR with its latest pushed revision
`mark-ready`	Promote a draft PR to open, enqueueing CI
`merge`	Merge after readiness gates pass (`--force` to override)
`ship`	Approve, merge, and fast-forward local main in one command
`rebase` / `conflicts`	Rebase a PR / inspect merge conflicts
`close` / `reopen`	Close or reopen a PR
`stack`, `merge-stack`, `stack-adopt`, `stack-history`, `stack-undo`, `stack-doctor`	Work with stacked PRs: inspect, merge a stack root and rebase descendants, adopt, audit, undo
`mentions`	Show PRs that mention you

tmppr issue

List, create, update, close, comment on, and link issues.

Subcommand	What it does
`list` / `show`	List issues / show one issue
`create`	Create an issue
`edit`	Edit title, body, state, stage, labels, or assignees
`close` / `reopen`	Close or reopen an issue
`comment`	Comment on an issue
`link` / `unlink`	Link an issue to a PR, optionally marking the PR as its closer
`depend` / `undepend`	Declare or remove a blocked-by dependency between issues
`mentions`	Show issues that mention you

tmppr ci

Run, inspect, rerun, or cancel CI checks for pull requests.

Subcommand	What it does
`dispatch`	Start a CI run for a PR; uses cloud runners when cloud is enabled
`runs`	List recent CI runs, filterable by PR, repo, and status
`log`	Show readable log output for one check
`rerun`	Run the configured checks again for the current PR revision
`cancel`	Cancel queued or running checks for a PR

tmppr cloud

Connect to tmppr Cloud and run commands on hosted runners.

Subcommand	What it does
`login`	Log in with `--token` or an email code
`status`	Show plan, entitlements, and usage
`whoami` / `logout`	Show the signed-in account / remove the stored token
`git-credential`	Git credential helper for Cloud smart-HTTP remotes (`install` to set up)
`run`	Run a shell command on the cloud runner pool and stream logs
`agent`	Dispatch and inspect Cloud agent runs: `dispatch`, `list`, `show`, `logs`, `cancel`, `set-runner`

tmppr migrate

Migrate GitHub repos into tmppr Cloud. See the migration guide.

Subcommand	What it does
`migrate-repo`	Crawl a GitHub repo (`owner/repo`) and import it into a target Cloud repo
`migrate-org`	Migrate every repo of a GitHub org or user under one org GUID
`status`	Show a migration job's status
`generate-mannequin-csv`	Emit a CSV of the migration's unmapped mannequins
`reclaim-mannequin`	Re-point a mannequin to a real user (invitation flow by default)
`mirror`	One-way metadata delta sync from the GitHub source of a completed migration
`cleanup`	Delete everything a migration imported

tmppr org

Manage Cloud org invitations and members.

Subcommand	What it does
`invite`	Invite a user to an org by email (`--role`, default member)
`invitations`	List an org's invitations
`cancel-invite`	Cancel a pending invitation
`accept`	Accept an invitation
`members`	List org members

tmppr team

Manage teams, membership, and repo access.

Subcommand	What it does
`create`	Create a team in an org (`--parent` nests it under another team)
`list` / `get` / `delete`	List, show, or delete teams
`members`	List team members
`add-member` / `remove-member`	Add (role `member` or `maintainer`) or remove a member
`grant` / `revoke`	Grant or revoke a team's repo access (`read`–`admin` presets)

tmppr runner

Run and enroll Cloud agent runners. See Runners.

Subcommand	What it does
`register`	Enroll a new runner (`--kind local\|cloud`, `--labels`)
`serve`	Claim and execute queued jobs on this machine (`--once` for a single job)

tmppr role, policy, enterprise

Command	What it does
`role create` / `role assign`	Define a custom role in an org and assign it to a collaborator on a repo
`policy set` / `policy get`	Set and resolve policies across enterprise → org → repo
`enterprise create` / `add-org` / `add-member`	Create an enterprise container, attach orgs, and manage enterprise members