gh-glance 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1] - 2026-08-04
+
+Two fixes to the interactive surface: a selection marker that outlived its
+usefulness, and a key hint that named the wrong keys.
+
+### Fixed
+
+- **The row cursor clears itself after 60s without movement.** Once you pressed
+  a movement key the selection marker stayed on screen until you quit, so a pane
+  left in the corner of a screen sat there marked at something you had stopped
+  caring about an hour ago. Any movement key rearms the timer; expiry clears the
+  cursor on every tab, not just the visible one.
+- **The `Move` hint in the status bar reads `↑↓` rather than `jk`.** The hints
+  are otherwise strictly width-1 ASCII, because East-Asian-Ambiguous glyphs
+  measure as two columns in ink's width model and overflowed an 80-column
+  terminal once before. The arrow pair is a deliberate exception: the pty suite
+  asserts the rendered frame stays inside the terminal width, so a font that
+  renders them double-width fails there loudly instead of shifting columns
+  silently.
+
 ## [0.4.0] - 2026-08-04
 
 Correctness on GitHub Enterprise and Enterprise Managed Users tenants, and a
@@ -309,6 +329,7 @@ engineering, security, QA and UX. What follows is what changed as a result.
 - The `main` field from `package.json`. It advertised the file as importable,
   but importing it took over the terminal or exited the host process.
 
+[0.4.1]: https://github.com/juan294/gh-glance/releases/tag/v0.4.1
 [0.4.0]: https://github.com/juan294/gh-glance/releases/tag/v0.4.0
 [0.3.1]: https://github.com/juan294/gh-glance/releases/tag/v0.3.1
 [0.3.0]: https://github.com/juan294/gh-glance/releases/tag/v0.3.0

package/README.md

@@ -30,7 +30,7 @@ without switching to the browser.
 │                                                                          │
 │                                                                          │
 ╰───────────────────────────────────────────────────────────────── 4 of 4 ─╯
-⣾ Fetching            Move: jk | Open: Ent | Refresh: r | Quit: q
+⣾ Fetching  Move: ↑↓ | Open: Ent | Refresh: r | Quit: q
 ```
 
 > Captured from a real run at 76 columns with `GH_GLANCE_ICONS=unicode`, so the
@@ -191,7 +191,9 @@ stdout isn't a terminal rather than streaming redraw frames into a pipe.
 
 The cursor tracks the *item*, not the row position, so it stays on what you
 selected as new rows arrive above it. `Enter` works on Actions, Issues and Pull
-Requests; the Security tab has no per-alert `gh` command to open.
+Requests; the Security tab has no per-alert `gh` command to open. It clears
+itself after 60s with no cursor movement, so a pane left idle in the corner of
+a screen doesn't sit there marked forever.
 
 If `gh-glance` is started without an interactive stdin (for example with stdin
 redirected), the key handlers cannot run and the status bar shows only `Quit: ^C`

package/index.mjs

@@ -47,6 +47,12 @@ const IS_MAIN = detectMainModule();
 
 const REFRESH_MS = 5000;
 
+// The row cursor otherwise persists forever once you touch a movement key --
+// useful while you're actually scanning a list, noise once you've moved on and
+// left the pane running in a corner of the screen. 60s idle (measured from the
+// last movement, not from tab switches or Enter) quietly drops it.
+const SELECTION_IDLE_MS = 60_000;
+
 // `gh run list` costs roughly linearly in --limit (measured: ~1.2s at 20 runs,
 // ~3.0s at 100, ~4.9s at 150), so asking for a fixed 150 to render ~35 visible
 // rows was paying several seconds per refresh for rows nobody sees. Actions is
@@ -1159,6 +1165,8 @@ Keys:
   r                  Refresh the current tab now
   q / Esc / Ctrl+C   Quit
 
+The cursor clears itself after 60s with no movement.
+
 Environment:
   GH_REPO=owner/name        Watch a specific repository (--repo takes precedence)
   GH_HOST=host              GitHub Enterprise or EMU host to send every call to.
@@ -1792,18 +1800,22 @@ function TabBar({ activeIndex, counts, firstLoad, failed, spin, useShort }) {
 
 // ---------- Status bar ----------
 
-// Every glyph here is width-1 ASCII, deliberately. The arrows, the return
-// symbol and the box-drawing separator are all East-Asian-Ambiguous: ink
-// measures them as two columns in its width model, and a status bar built from
-// them overflowed an 80-column terminal by six columns once selection added a
-// hint. Same trap the unicode icon table already documents -- prefer strictly
-// narrow ASCII over pretty-but-ambiguous.
+// Every glyph here is width-1 ASCII, deliberately, with one exception: the
+// Move arrows. The return symbol and the box-drawing separator are still
+// East-Asian-Ambiguous and stay out for that reason -- ink measures them as
+// two columns in its width model, and a status bar built from them overflowed
+// an 80-column terminal by six columns once selection added a hint. Same trap
+// the unicode icon table already documents -- prefer strictly narrow ASCII
+// over pretty-but-ambiguous. The arrow pair is a deliberate, tested exception:
+// `npm run test:pty` asserts the rendered frame stays within the terminal
+// width, so a font/terminal combo that renders them double-width fails loudly
+// there instead of silently shifting columns.
 //
 // Tab switching is not listed: the tab bar already renders "1:Actions", so the
 // digits document themselves, and the arrow keys are in --help. The hints that
 // survive are the ones nothing else on screen reveals.
 const KEY_HINTS = [
-  { label: "Move", keys: "jk" },
+  { label: "Move", keys: "↑↓" },
   { label: "Open", keys: "Ent" },
   { label: "Refresh", keys: "r" },
   { label: "Quit", keys: "q" },
@@ -2010,6 +2022,17 @@ function App() {
     });
   }
 
+  // Rearms on every call to moveSelection (it's the only thing that changes
+  // `selected`), so this fires exactly 60s after the *last* movement -- tab
+  // switches and Enter don't count as activity and don't push it back. Clears
+  // every tab's cursor at once rather than just the visible one, so a tab you
+  // switch back to after being idle doesn't still show a stale row marked.
+  useEffect(() => {
+    if (Object.keys(selected).length === 0) return;
+    const timer = setTimeout(() => setSelected({}), SELECTION_IDLE_MS);
+    return () => clearTimeout(timer);
+  }, [selected]);
+
   function openSelected() {
     const { items, key: currentKey, tabKey } = navRef.current;
     const item = items.find((i) => itemKey(i) === currentKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gh-glance",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "A live-refreshing GitHub dashboard for your terminal: Actions, Issues, Pull Requests, and Security alerts in one narrow pane",
   "type": "module",
   "bin": {