docs: document the Update All fixes and release 1.6.1

README covers the shared updates terminal, cancellation, and a
troubleshooting entry for an update stuck on a prompt. AGENTS.md records
why anything awaiting a terminal command needs a close-listener escape
hatch, that buildAgentGroups is now the single grouping source, and that
integration tests must not assume an ordering for window.terminals.
Bumps package.json, package-lock.json, and CITATION.cff to 1.6.1.

Author: TheStreamCode

AGENTS.md

@@ -60,6 +60,16 @@ This split is why some files under `src/` have unit tests and others don't:
 When adding logic, prefer putting anything that doesn't strictly need the `vscode` API into a pure
 module so it's covered by the fast unit suite — the integration suite is comparatively expensive.
 
+`buildAgentGroups` (`agent-view.ts`) is the single source of grouping for **both** the sidebar tree
+(group nodes) and the quick pick (separators). It used to be duplicated as a near-identical
+`buildAgentSections`, and the two silently drifted; keep the one function and let each surface render
+it, so the picker and the tree can't disagree about what belongs where.
+
+Integration tests must not assume an ordering for `vscode.window.terminals`. Asserting on
+"the last terminal" is flaky — `superCli.restartSession` deliberately overlaps two terminals, and the
+array is not ordered for a test's convenience. Find terminals by name/identity instead, and prefer
+`waitForCondition`'s lazy message form to report the actual open terminals when a wait times out.
+
 ### `metadata.test.js` guards `package.json`
 
 Many of its assertions are exact `deepEqual` checks against `package.json`'s `contributes` block
@@ -94,13 +104,24 @@ Treat that as a narrow, bounded, already-reviewed exception, not a precedent for
 
 The shell-integration path in `executeCommandWithOptionalShellIntegration` (`terminal.ts`) falls back
 to `terminal.sendText` after a 3-second timeout when shell integration doesn't attach in time. sendText
-itself has no completion signal at all — callers that need to resolve regardless (`updateAgent`, so a
-bulk update never blocks forever on one agent) pass the function's `onFallback` callback and treat
-"we sent it" as done. `executeCommandWithOptionalShellIntegration` is exported only so
-`test/integration/suite/index.js` can force this branch deterministically, by launching it against a
-`cmd.exe` terminal — VS Code's own docs confirm cmd.exe doesn't support shell integration, unlike a
-real interactive shell where the fallback would be a timing race. It has no other caller outside
-`terminal.ts`; don't remove the export as unused without checking that test first.
+itself has no completion signal at all, so callers that must resolve regardless pass the function's
+`onFallback` callback and treat "we sent it" as done. `executeCommandWithOptionalShellIntegration` is
+exported only so `test/integration/suite/index.js` can force this branch deterministically, by
+launching it against a `cmd.exe` terminal — VS Code's own docs confirm cmd.exe doesn't support shell
+integration, unlike a real interactive shell where the fallback would be a timing race. It has no
+other caller outside `terminal.ts`; don't remove the export as unused without checking that test first.
+
+### Anything awaiting a terminal command must have a non-shell-integration way out
+
+`runAgentUpdate` (`terminal.ts`) resolves on three independent signals: the shell-integration end
+event, the `onFallback` path above, and `vscode.window.onDidCloseTerminal`. That third one is not
+redundant. Once shell integration attaches, `startExecution` clears the fallback timer, so the *only*
+remaining signal is an end event — and a command that never exits (an interactive prompt, a stalled
+download) never produces one. Without the close listener the promise stayed pending forever, which is
+exactly how `superCli.updateAllAgents` once stranded itself behind a non-cancellable progress
+notification (fixed in 1.6.1, regression-tested in the integration suite). Any future code that
+`await`s a terminal command needs the same escape hatch, plus a cancellable progress if it loops.
+When adding one, verify the test fails without the fix — a test for a hang passes trivially otherwise.
 
 ### Renaming or retyping a setting: migrate additively, never clear the old key
 

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project are documented here. The format is based on
 
 ## [Unreleased]
 
+## [1.6.1] - 2026-07-26
+
+### Fixed
+
+- **Update All Agents could hang indefinitely.** An update command that never exits on its own (one
+  waiting on an interactive prompt, or a stalled download) left the run stuck behind a progress
+  notification that couldn't be cancelled, silently skipping every remaining agent. Each update now
+  also settles when its terminal is closed, the progress notification is cancellable, and the run
+  stops rather than firing the remaining commands into a terminal that is gone. Cancelling stops
+  Super CLI from starting further updates; a command already running in the terminal is left alone
+  for you to deal with, which is why the terminal stays open.
+
+### Changed
+
+- **Update All Agents now uses one shared `Super CLI: updates` terminal** instead of opening a
+  separate terminal per agent, which previously left up to 14 terminals behind on a default install.
+  An agent configured with its own `env` still gets a dedicated terminal, so its update keeps running
+  exactly as configured.
+- The completion summary now reports failures and early stops, not just the success count.
+
+### Internal
+
+- Unified the sidebar tree and quick pick onto one `buildAgentGroups`, replacing two grouping
+  functions that had become identical implementations of the same logic.
+
 ## [1.6.0] - 2026-07-25
 
 ### Added

CITATION.cff

@@ -5,5 +5,5 @@ authors:
   - family-names: Gasperini
     given-names: Michael
 url: "https://github.com/TheStreamCode/super-cli"
-version: "1.6.0"
+version: "1.6.1"
 license: MIT

README.md

@@ -92,8 +92,10 @@ defined explicitly for Windows, macOS, and Linux; WSL deliberately selects the L
   update`, `opencode upgrade`, `droid update`, `openclaw update`, `kimi upgrade`). CLIs that update themselves don't
   show one. With terminal shell integration available, Super CLI reports whether the update completed
   or failed and can bring the update terminal back into focus. **Super CLI: Update All Agents** in the
-  sidebar toolbar runs every updatable agent's update in sequence, one at a time, skipping any agent
-  currently believed to be missing from `PATH`.
+  sidebar toolbar runs every updatable agent's update in sequence, one at a time, in a single shared
+  **Super CLI: updates** terminal, skipping any agent currently believed to be missing from `PATH`. It
+  is cancellable at any point, and closing the terminal stops the run — so an update waiting on an
+  interactive prompt can never strand the rest.
 - **Official installation docs.** If a supported CLI isn't found, Super CLI opens that agent's verified
   official installation documentation in your browser. It never installs a CLI, runs an installer, or
   changes your shell profile.
@@ -201,6 +203,11 @@ settings.
   own — no active editor, and more than one folder open in a multi-root workspace. Press Escape to
   fall back to the first folder instead, same as every launch before this existed. Restarting a
   running session never asks — it reuses that session's original folder directly.
+- **Update All Agents seems stuck on one agent.** An update command that waits for input (a
+  confirmation prompt, a credential) can't complete on its own. Cancel the progress notification, or
+  close the **Super CLI: updates** terminal — either one ends the run and reports how far it got.
+  Cancelling stops Super CLI from starting further updates; a command already running in the terminal
+  keeps going, so check that terminal before closing it.
 - **I updated the extension but nothing changed.** Reload the window (**Developer: Reload Window**
   from the Command Palette) or restart your editor. Extension code loaded into a running window
   is not replaced until the window reloads, even after a newer version finishes installing.

package-lock.json

@@ -3,7 +3,7 @@
   "displayName": "Super CLI: Claude Code, Codex & AI Agent Launcher",
   "description": "Launch Claude Code, Codex CLI, Copilot CLI, Google Antigravity, OpenCode, Kiro, OpenClaw, Qoder CLI and other AI coding agents from one VS Code sidebar.",
   "publisher": "mikesoft",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/TheStreamCode/super-cli.git"