Tmux: GitHub picker
The GitHub picker lists PRs and issues in a 95%×95% tmux popup. It reads sections from YAML configs and renders them in fzf with previews, hierarchy, local worktree markers, review status, and CI state.
Open it with prefix + G. Press alt-g to switch to the session picker.
Reading the picker
| Area | Meaning |
|---|---|
| Header | scope, counts, cache age, and primary actions |
| Sections | Intent groups: Action:, Mine:, Watching:, Maintenance: |
| Rows | PRs/issues with review, CI, hierarchy, relation, and local-worktree signals |
| Preview | Dashboard summary plus PR/issue details, body, and activity |
| Query | Search visible labels and hidden status/relation tokens |
The screenshot shows an earlier picker layout with demo rows. Use the scopes and bindings below; labels and shortcuts in the image may differ.
Important bindings
| Key | Action |
|---|---|
enter | Checkout worktree and focus it; batches marked rows |
tab / alt-space | Mark/unmark item |
alt-0 / alt-1 / alt-2 | Show all / focus / explore scopes |
alt-n / alt-p | Jump to next / previous section header |
alt-S | Cycle sort |
alt-z / alt-Z | Collapse family / collapse all |
alt-M | Mark the current family |
ctrl-r | Refresh from GitHub |
alt-e | Cycle preview expansion |
alt-x | Open action palette |
alt-g | Switch to session picker |
? | Show help |
alt-r is quote-reply here, not refresh. The GitHub picker's ctrl-r is already the full refresh path and pre-empts in-flight fetches.
Sections by intent
| Prefix | Meaning |
|---|---|
Action: | You are explicitly the requested reviewer or the bottleneck for an assigned issue. |
Mine: | You authored it and it is still open |
Watching: | Informational queues, mentions, radar, team views |
Maintenance: | Special workflows such as pending backports |
PRs and issues share the same intent prefixes. The YAML config still splits PR and issue sections for query ergonomics, but the dashboard groups by workflow intent.
Dashboard scopes
| Scope | Binding | Includes |
|---|---|---|
all | alt-0 | Every section |
focus | alt-1 | Action: + Mine: + Maintenance: |
explore | alt-2 | Watching: sections |
Detailed mechanics
The deeper implementation details live in GitHub picker mechanics:
- data source and cache behavior.
- section jumps and sorting.
- epic/backport/PR-issue hierarchy.
- badges, hidden match tokens, worktree detection.
- preview cache and popup sizing.