Skip to content

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.

Terminal window
patchula tui acme/my-app # browse a GitHub repository
patchula tui # browse, and apply, the working tree here
patchula tui --once | less # a plain-text snapshot instead

It 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, with the exit code lookup would give: 1 when a repository could not be read, 4 when a lookup failed.

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.mod
v0.2.8 → v0.3.0 (minor)
version v0.3.0
published 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.

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.