Terminal UI
patchula tui runs a lookup and lets you browse the result: every update, the
releases held back by the release-age wait, every dependency found, template
updates, warnings and the run’s stats. Run it in a checkout with no repository named and you
can pick updates and have the Count write them into its files.
patchula tui acme/my-app # browse a GitHub repositorypatchula tui # browse, and apply, the working tree herepatchula tui --once | less # a plain-text snapshot insteadIt takes the same flags as lookup: --cache,
--config, --concurrency and the rest. It needs a terminal on both stdin and
stdout; --once prints a snapshot of the updates and exits, for pipes and CI
logs.
In a checkout with no patchula.pkl the Count asks
first.
Count Patchula 1 repository · 2576 dependencies · 131 updates · 2 selected 1 Updates │ 2 Held back │ 3 Dependencies │ 4 Templates │ 5 Warnings │ 6 Stats Updates (131 of 131, type: all) ─────────────────────────────────────────────────────────────────── Dependency Current Target Type Age File[x] cloud.google.com/go/auth v0.23.3 v0.24.1 minor 12d go/prometheus/go.mod[x] cloud.google.com/go/auth/oauth2adapt v0.2.8 v0.3.0 minor 26d go/prometheus/go.mod[ ] cloud.google.com/go/compute/metadata v0.9.1 v0.10.0 minor 26d go/prometheus/go.mod[ ] github.com/Azure/az…k-for-go/sdk/azcore v1.14.1 v1.15.0 minor 6d go/prometheus/go.mod[ ] github.com/AzureAD/…tion-library-for-go v1.8.0 v1.10.1 minor 21d go/prometheus/go.mod[ ] github.com/KimMachineGun/automemlimit v0.7.5 v1.0.0 major 60d go/prometheus/go.mod[ ] github.com/Microsoft/go-winio v0.6.2 v0.6.4 patch 7d go/prometheus/go.mod[ ] github.com/armon/go-metrics v0.4.1 v0.4.2 patch 1230d go/prometheus/go.mod[ ] github.com/armon/go-metrics v0.4.1 v0.7.0 minor 34d go/prometheus/go.mod────────────────────────────────────────────────────────────────────────────────────────────────────cloud.google.com/go/auth/oauth2adapt go · go/prometheus/go.modv0.2.8 → v0.3.0 (minor)version v0.3.0published 2026-09-24T19:36:54Z
q quit ? help / search t type: all space select a all w apply 2 selected| Tab | Shows |
|---|---|
| 1 Updates | every proposed update, with the selected one’s package, versions, digest and publication date below |
| 2 Held back | releases still inside the release-age wait, with when each becomes eligible |
| 3 Dependencies | everything the Count found, with current and resolved versions and how many updates each has |
| 4 Templates | template updates the Count reports but never edits, such as a Copier template’s new tag |
| 5 Warnings | lookup and extraction warnings |
| 6 Stats | counts per manager, requests, cache hits and the time each phase took |
| Key | Action |
|---|---|
q, Esc, Ctrl-C |
quit |
? |
show the keys |
Tab, →, Shift-Tab, ← |
next and previous tab |
1 to 6 |
jump to a tab; each tab keeps its cursor while you are away |
j, k, ↓, ↑ |
move; on the Warnings tab, scroll a line |
PgDn, PgUp, g, Home, G, End |
page down, page up, top, bottom |
/ |
search names, packages and files; Enter or Esc to finish |
t |
on the Updates tab, cycle the update type filter: all, major, minor, patch, pin, digest |
space |
on the Updates tab, select or clear the update under the cursor |
a |
on the Updates tab, select every visible update, or clear them if all are selected |
w |
on the Updates tab, apply: write the selection into the working tree, after a y to confirm |
u |
on the Templates tab, run copier update for the template under the cursor, after a y to confirm |
The bar at the bottom lists the keys for the current tab, and says why w or
u can’t run.
Applying updates
Section titled “Applying updates”Select updates with space or a, press w, then y. Only the working tree
here can be written, with the same edits as
patchula apply; lockfiles are not
regenerated. An update that cannot be written in place is skipped with a reason
and does not stop the rest, as in patchula apply. If this checkout is set to
run on a server, pass --here.
To write updates without picking them, in a script or a pre-commit hook, use
patchula apply. It writes through the same edits, and
leaves alone, with a reason, what it cannot write in place.
For GitHub repositories the TUI is for looking. Let patchula run
open the pull requests.
© 2026 Sweepy
