umputun / agterm / 28700242912

98%

push

github

feat: auto-follow attention (idle-triggered jump to blocked sessions)

adds a per-window auto-follow mode: after you've been idle from input for a chosen timeout, the window auto-selects the oldest blocked session, so you get pulled to whatever agent is waiting.

**settings** (Agent Status tab): an "Auto-follow blocked sessions" picker with Disabled (default) / 5s / 10s / 30s / 60s / 5m, plus a "Don't auto-follow away from a running session" opt-in (off by default).

**behavior**: per-window, blocked-only, oldest-first, window-wide (crosses workspaces). Parking on a blocked session suppresses further jumps; typing a reply clears it and the next idle fire advances to the next blocked one. Anything that counts as input resets the idle timer: keystrokes in any surface (terminal, split, overlay, scratch, quick terminal) and every user-initiated selection (nav, sidebar click, Ctrl-Tab, palette, new session, notification click). Auto-follow is also suppressed while a non-terminal editor owns first responder (inline rename, command palette) so it can't interrupt an active edit.

**control**: read-only `idleMs` (ms since last input, on `tree` only since it's live) and `autoFollowMs` (the configured timeout, on `tree` + `window.list`). No new command; the setting stays GUI-only like the rest.

the decision logic is a host-free pure function on `AppStore` (unit-tested); the app target owns the keystroke and focus wiring. Also trims the now-redundant Settings captions and tightens the Settings window to 480x550 while in there.

test coverage is 1074 host-free tests plus two auto-follow XCUITests. Docs updated: README, site, and the bundled agent-skill.

98 of 98 new or added lines in 5 files covered. (100.0%)

3285 of 3314 relevant lines covered (99.12%)

9072203.52 hits per line