umputun / agterm / 29657303789

98%

push

github

feat: session.new --no-select for background session creation (#250)

Adds an opt-in `--no-select` flag to `session.new` (agtermctl + the control protocol) that creates a session in the background without selecting or focusing it, so the current selection and focus stay put. It is the inverse of the overlay's `--follow`: overlay opens in the background and opts into focusing, while `session.new` selects by default and opts out. The default (select + focus) is unchanged.

**Implementation.** A new opt-in `ControlArgs.noSelect` / `ControlSessionCreateOptions.noSelect`, kept separate from the existing `select` arg (which is `session.type --select`). `AppStore.addSession` gained a `select: Bool = true` parameter that gates `selectedSessionID` / `autoUnfocusIfOutsideFocus` / `recordRecency`, and `makeSessionResponse` passes `select: !noSelect` and skips the focus call. No new `Command` case, so the catalog stays at 61. The read-back is the existing `tree` `active` flag: a background session is not `active`.

**Workspace focus.** The `--create-workspace` case also keeps the workspace-focus filter. A background create threads `clearFocus: !noSelect` through `ensureWorkspace` / `addWorkspace` (a defaulted parameter, so the GUI and every other caller keep the auto-reveal), so `--no-select --create-workspace` no longer drops a focused workspace.

Tests: protocol round-trip, dispatcher, CLI parse, and AppStore unit tests, plus e2e for the background create and the workspace-focus preservation. Docs updated across the agent skill, `site/commands.html`, `site/docs.html`, README, and the control-api rule.

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

5344 of 5477 relevant lines covered (97.57%)

5489428.33 hits per line