# Terminal UI

> Browse a lookup in the terminal with patchula tui: updates, held-back releases, dependencies and warnings. Pick updates to apply locally.

`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.

```sh
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`](https://count-patchula.sweepy.dev/reference/cli/#patchula-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](https://count-patchula.sweepy.dev/guide/configuration/#where-the-config-lives).

```text
 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
```

## Tabs

| 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](https://count-patchula.sweepy.dev/guide/managers/#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 |

## Keys

| 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

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`](https://count-patchula.sweepy.dev/guide/apply/#what-gets-written); 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`](https://count-patchula.sweepy.dev/guide/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`](https://count-patchula.sweepy.dev/guide/pull-requests/) open the pull requests.
