1---
 2name: collaborating-through-pr-pico-sh
 3description: Collaborates on git patches via pr.pico.sh, a minimal patchbin service. Use when submitting, reviewing, or managing patch requests, or when the user mentions pr.pico.sh, patchbin, or patch requests.
 4user-invocable: true
 5license: LicenseRef-MutuaL-1.2
 6metadata:
 7  author: Amolith <amolith@secluded.site>
 8---
 9
10pr.pico.sh is a patchbin where collaboration happens through `git format-patch` and `git am`. Whether you are submitting code changes or reviewing them, it all happens in code — both contributor and reviewer create commits, optionally with comments in code, and exchange them as patches rather than commenting in a web UI.
11
12## Registration
13
14If `ssh pr.pico.sh` returns a "not registered" error, stop and ask the user what they would like to register as, or if they're already registered. If they're not and provide a username, register their key with `ssh {username}@pr.pico.sh register`.
15
16## Common commands
17
18```console
19ssh pr.pico.sh pr ls --mine {repo} # also --open, --closed, --accepted
20# Display metadata for a specific PR
21ssh pr.pico.sh pr summary {id}
22ssh pr.pico.sh logs --pr {id} # also --repo {id} or your own --pubkey
23
24# Apply all patches from a PR
25ssh pr.pico.sh pr print {id} | git am -3
26
27# Print a specific patchset (rather than the whole PR)
28ssh pr.pico.sh print ps-{id}
29```
30
31The project's README.md or AGENTS.md likely mention whether the project uses pr.pico.sh and which pr.pico.sh repo it uses. If you don't already know its ID, grep for `pr.pico.sh` in the README.md, first falling back to an AGENTS.md, then a broader in-cwd search if still not found, and read surrounding lines to identify the repo ID.
32
33## Admin commands
34
35```console
36# Create a repo on pr.pico.sh
37ssh pr.pico.sh repo create {repoName}
38
39# Delete a repo and all its PRs (requires --write confirmation)
40ssh pr.pico.sh repo rm --write {repoName}
41
42# Remove a specific patchset
43ssh pr.pico.sh ps rm {patchsetID}
44```
45
46## Flows
47
48You will often be _either_ reviewing or sending patches, and the user will have made it clear which. Be sure to read the right one.
49
50- For sending patches, opening a PR, contributing upstream, or similar requests when the project uses pr.pico.sh, see [contributing.md](references/contributing.md)
51- For reviewing patches/PRs, accepting a contributor's PR, or similar, see [reviewing.md](references/reviewing.md)
52- If the project uses **jj (Jujutsu)** instead of git, read [jujutsu.md](references/jujutsu.md) first — colocation is required and must be verified before generating or applying patches