agent-toggle 0.10.0__tar.gz → 0.11.0__tar.gz

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.10.0
+Version: 0.11.0
 Summary: Temporarily disable / re-enable AI-agent skills, agents, commands, rules, plugins and MCP servers across harnesses (Claude Code, Codex, Grok, OpenCode, OpenClaw, Copilot, Vibe, Devin, Antigravity)
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/weskao/agent-toggle
@@ -195,6 +195,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `status` | health check: harnesses found, types each supports, parked counts, gitignore, untracked parked items, stale live twins, shared dirs, and state entries whose parked item is gone (a `stale` row with the fix command; read-only, still exit `0`) |
 | `list [type]` | what is currently disabled (`--project <dir>` filters to one project) |
 | `cost [--type T]` | estimated startup tokens per item, biggest first (read-only; `--harness H` filters; `--project <dir>` prices a repo's `.claude/` and `.mcp.json` instead of user scope) |
+| `update` | check PyPI now (ignores the cache and a skipped version) and print the commands that update the CLI, the Claude Code plugin (when installed) and the shims; runs none of them. `/agent-toggle update` in Claude Code does the same; opening the pane toasts a newer release once |
 | `install-shims` | write the skill shim into every installed harness that is on in the settings (an off one is skipped unless named with `--harness`); refuses to overwrite a file it did not write (`--dry-run` shows the plan); reports stale legacy `<dir>-disabled/` lines in a harness-home `.gitignore` (`--gitignore` removes them, `--no-gitignore` skips the check); on a terminal, then asks y/n for each problem `doctor` can fix (see [Fixing](#fixing)) |
 | `disable <type> <name>...` | park one or more items (`--dry-run` shows the plan; `--project <dir>` for a repo's own `.claude/` and `.mcp.json`) |
 | `enable <type> <name>...` | put them back (`--dry-run` shows the plan; `--project <dir>` likewise) |
@@ -472,10 +473,15 @@ before the command and is offered after it, on every exit path; it overlaps the
 
 - **On a terminal** (stdin and stderr are TTYs, no `--json`): a panel on stderr, "agent-toggle X
   is available (you have Y)", with `Update now`, `Skip` and `Skip until next version`, a release
-  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs `uv tool upgrade agent-toggle`; if that
-  fails you get a yellow warning with the command to run yourself.
-- **Off a terminal**: two stderr lines, `agent-toggle X is available (you have Y)` and
-  `  uv tool upgrade agent-toggle`.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs, in order and stopping at the first
+  failure: `uv tool upgrade agent-toggle` (`pipx upgrade agent-toggle` for a pipx install), then,
+  when the Claude Code plugin is installed, `claude plugin marketplace update agent-toggle` and
+  `claude plugin update agent-toggle@agent-toggle`, then `agent-toggle install-shims`. A failure
+  gives a yellow warning listing the commands to run yourself.
+- **Windows**: a running `agent-toggle.exe` cannot be replaced, so there is no `Update now`; the
+  commands are printed instead (as below), to run once agent-toggle has exited.
+- **Off a terminal** (or `--json`): a stderr line, `agent-toggle X is available (you have Y)`,
+  then those commands, one per line.
 - It never changes the exit code or stdout, so `--json` output stays one document.
 
 It is one `GET https://pypi.org/pypi/agent-toggle/json` on a background thread with a 0.8 s

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/README.md

@@ -163,6 +163,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `status` | health check: harnesses found, types each supports, parked counts, gitignore, untracked parked items, stale live twins, shared dirs, and state entries whose parked item is gone (a `stale` row with the fix command; read-only, still exit `0`) |
 | `list [type]` | what is currently disabled (`--project <dir>` filters to one project) |
 | `cost [--type T]` | estimated startup tokens per item, biggest first (read-only; `--harness H` filters; `--project <dir>` prices a repo's `.claude/` and `.mcp.json` instead of user scope) |
+| `update` | check PyPI now (ignores the cache and a skipped version) and print the commands that update the CLI, the Claude Code plugin (when installed) and the shims; runs none of them. `/agent-toggle update` in Claude Code does the same; opening the pane toasts a newer release once |
 | `install-shims` | write the skill shim into every installed harness that is on in the settings (an off one is skipped unless named with `--harness`); refuses to overwrite a file it did not write (`--dry-run` shows the plan); reports stale legacy `<dir>-disabled/` lines in a harness-home `.gitignore` (`--gitignore` removes them, `--no-gitignore` skips the check); on a terminal, then asks y/n for each problem `doctor` can fix (see [Fixing](#fixing)) |
 | `disable <type> <name>...` | park one or more items (`--dry-run` shows the plan; `--project <dir>` for a repo's own `.claude/` and `.mcp.json`) |
 | `enable <type> <name>...` | put them back (`--dry-run` shows the plan; `--project <dir>` likewise) |
@@ -440,10 +441,15 @@ before the command and is offered after it, on every exit path; it overlaps the
 
 - **On a terminal** (stdin and stderr are TTYs, no `--json`): a panel on stderr, "agent-toggle X
   is available (you have Y)", with `Update now`, `Skip` and `Skip until next version`, a release
-  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs `uv tool upgrade agent-toggle`; if that
-  fails you get a yellow warning with the command to run yourself.
-- **Off a terminal**: two stderr lines, `agent-toggle X is available (you have Y)` and
-  `  uv tool upgrade agent-toggle`.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs, in order and stopping at the first
+  failure: `uv tool upgrade agent-toggle` (`pipx upgrade agent-toggle` for a pipx install), then,
+  when the Claude Code plugin is installed, `claude plugin marketplace update agent-toggle` and
+  `claude plugin update agent-toggle@agent-toggle`, then `agent-toggle install-shims`. A failure
+  gives a yellow warning listing the commands to run yourself.
+- **Windows**: a running `agent-toggle.exe` cannot be replaced, so there is no `Update now`; the
+  commands are printed instead (as below), to run once agent-toggle has exited.
+- **Off a terminal** (or `--json`): a stderr line, `agent-toggle X is available (you have Y)`,
+  then those commands, one per line.
 - It never changes the exit code or stdout, so `--json` output stays one document.
 
 It is one `GET https://pypi.org/pypi/agent-toggle/json` on a background thread with a 0.8 s

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/__init__.py

@@ -1,3 +1,3 @@
 """agent-toggle: temporarily disable / re-enable AI-agent resources."""
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/cli.py

@@ -558,7 +558,7 @@ def _stale_ignore_lines(h, args: argparse.Namespace, out: Result) -> None:
 
 
 COMMANDS = ("ui", "pick", "status", "list", "cost", "migrate", "disable", "enable",
-            "install-shims", "profile", "undo", "doctor", "config")
+            "install-shims", "profile", "undo", "doctor", "config", "update")
 _GLOBAL_FLAGS = ("--json", "-v", "--verbose")
 
 
@@ -693,6 +693,8 @@ def build_parser() -> argparse.ArgumentParser:
     pp.add_argument("--project", metavar="dir", help=PROJECT_HELP)
     sub.add_parser("doctor", parents=[common],
                    help="check harness layouts and state against disk; offers y/n fixes")
+    sub.add_parser("update", parents=[common],
+                   help="check for a newer release; show the commands that update everything")
     cf = sub.add_parser("config", parents=[common],
                         help="Telegram settings for the CI failure alerts (needs the telegram extra)")
     cf.add_argument("action", nargs="?", choices=("test", "sync-ci"),
@@ -727,7 +729,8 @@ def main(argv: list[str] | None = None) -> int:
         language, color = "en", "auto"
     i18n.set_language(language)
     color = scan_color(argv, color)     # --color > env > setting > auto
-    started = update_prompt.start()
+    i = _command_index(argv)
+    started = None if argv[i:i + 1] == ["update"] else update_prompt.start()   # `update` is the check
     try:
         return _main(argv, color)
     except KeyboardInterrupt:
@@ -795,6 +798,8 @@ def _main(argv: list[str], color: str) -> int:
             fixes = doctor.cmd_doctor(args.harness, out)
             if fixes and _interactive(out):
                 doctor.offer_fixes(fixes, out)
+        elif cmd == "update":
+            update_prompt.cmd_update(out)
         elif cmd == "config":
             config.cmd_config(args, out)
         elif cmd == "undo":

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/help.py

@@ -135,6 +135,14 @@ def commands(default_harness: str = "claude") -> dict[str, Cmd]:
                      ("--dry-run", t("help.opt.config_dry_run",
                                      "sync-ci: show the plan; set nothing"))],
             examples=["config", "config test", "config sync-ci --dry-run"]),
+        "update": Cmd(
+            "update",
+            t("help.update.summary", "check for a newer release; show how to update"),
+            t("help.update.desc", "Ask PyPI now (ignoring the cache and a skipped version) and, "
+                                  "when a newer release exists, print the commands that update "
+                                  "the CLI, the Claude Code plugin (if installed) and the shims. "
+                                  "Runs none of them."),
+            examples=["update", "update --json"]),
         "install-shims": Cmd(
             "install-shims [--dry-run] [--gitignore | --no-gitignore]",
             t("help.install_shims.summary", "write the skill shim into every installed harness"),
@@ -166,7 +174,7 @@ def commands(default_harness: str = "claude") -> dict[str, Cmd]:
 def groups() -> list[tuple[str, list[str]]]:
     return [(t("help.group.toggle", "Toggle"), ["ui", "disable", "enable", "undo", "profile"]),
             (t("help.group.inspect", "Inspect"), ["status", "list", "cost", "doctor"]),
-            (t("help.group.setup", "Setup"), ["config", "install-shims", "migrate"])]
+            (t("help.group.setup", "Setup"), ["config", "install-shims", "update", "migrate"])]
 
 
 def _table(rows: list[tuple[str, str]], color: bool, role: str = "choice") -> list[str]:

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/locales/zh_tw_cli.py

@@ -27,6 +27,9 @@ CATALOG: dict[str, str] = {
     "help.cost.summary": "每個項目的預估啟動 token 數，由大到小",
     "help.cost.desc": "估算每個項目啟動時載入多少 token（字元數/4，±25%），"
                       "以及暫存項目已省下多少。",
+    "help.update.summary": "檢查新版本；顯示更新方式",
+    "help.update.desc": "立即向 PyPI 查詢（忽略快取與已略過的版本）；有新版本時，印出更新 CLI、"
+                        "Claude Code 外掛（若已安裝）與 shim 的指令。不會執行任何指令。",
     "help.doctor.summary": "檢查 harness 目錄結構與狀態",
     "help.doctor.desc": "比對狀態檔與磁碟；有問題時結束碼為 1。在終端機上，可自動修復的問題"
                         "（chmod、過期項目、孤立檔案、中斷的操作）會逐一詢問 y/n；否則不做任何變更。",

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/shims/claude.md.tmpl

@@ -1,7 +1,7 @@
 ---
 name: agent-toggle
 description: Temporarily disable or restore AI-agent resources — skills, agents, commands, rules, plugins, MCP servers — across Claude Code, Codex, Grok CLI, OpenCode, OpenClaw, Copilot and Vibe. Nothing is deleted; everything is parked and reversible. Use when the user wants to turn something off, trim startup context cost, re-enable something previously disabled, or asks "how do I disable X" / "turn off this MCP" / "add it back". Also when they ask to open, close or toggle the agent-toggle pane ("open agent-toggle" / "close the agent-toggle pane"), and to save, switch, rename or delete a profile ("save my setup as work" / "switch to my work profile").
-argument-hint: "[status | list | cost | disable|enable <type> <name>... | undo | profile | doctor | open | close]"
+argument-hint: "[status | list | cost | disable|enable <type> <name>... | undo | profile | doctor | update | open | close]"
 ---
 <!-- agent-toggle shim: written by `agent-toggle install-shims`; re-running it overwrites this file -->
 
@@ -17,7 +17,7 @@ agent-toggle <command> --json
 ```
 If `agent-toggle` is not on PATH, ask the user to install it (`uv tool install agent-toggle`); do not guess where a checkout lives.
 
-Commands: `status` (run first), `doctor` (read-only health check), `list [type]`,
+Commands: `status` (run first), `doctor` (read-only health check), `update` (checks for a newer release and lists the commands that update it; run none yourself, relay them), `list [type]`,
 `cost [--type T]` (startup token estimates, biggest first), `disable <type> <name>...` (type `all`: every type with that name),
 `enable <type> <name>...`, `enable --all`, `undo` (reverse the last batch),
 `profile save|apply|diff|delete <name>`, `profile rename <old> <new>`, `profile list` (see Profiles), `migrate`; add `--harness claude|codex|grok|opencode|openclaw|copilot|vibe|devin|agy`

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/shims/generic.md.tmpl

@@ -20,7 +20,7 @@ You are running in `__HARNESS__`: pass `--harness __HARNESS__` for its own items
 (the default is `claude`). Other harnesses: `--harness claude|codex|grok|opencode|openclaw|copilot|vibe|devin|agy`.
 
 Commands: `status` (run first; shows which types this harness supports),
-`doctor` (read-only health check), `list [type]`, `cost [--type T]` (startup
+`doctor` (read-only health check), `update` (checks for a newer release and lists the commands that update it; run none yourself, relay them), `list [type]`, `cost [--type T]` (startup
 token estimates, biggest first), `disable <type> <name>...` (type `all`: every type with that name), `enable <type> <name>...`,
 `enable --all`, `undo` (reverse the last batch), `profile save|apply|diff|delete <name>`,
 `profile rename <old> <new>`, `profile list` (see Profiles); add `--dry-run` to preview. `<type>` = `skill` / `agent` /

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/update_check.py

@@ -143,8 +143,10 @@ def check(
     timeout: float = DEFAULT_TIMEOUT,
     now: float | None = None,
     fetch: Callable[[str, float], str] | None = None,
+    ignore_skip: bool = False,
 ) -> UpdateAvailable | None:
-    """Return an update when the latest release is newer than *current*, else None."""
+    """Return an update when the latest release is newer than *current*, else None.
+    *ignore_skip* reports a "skip this version" release too (an explicit ask)."""
     current_parts = _numeric_tuple(current)
     if current_parts is None:
         return None
@@ -166,7 +168,7 @@ def check(
         # offline costs one timeout per TTL, not one per command.
         latest = fetched or latest
         _save_cache(cache_path, stamp, latest)
-    if not isinstance(latest, str) or latest == _valid_version(cached.get("skipped")):
+    if not isinstance(latest, str) or (not ignore_skip and latest == _valid_version(cached.get("skipped"))):
         return None
     latest_parts = _numeric_tuple(latest)
     if latest_parts is None or latest_parts <= current_parts:

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle/update_prompt.py

@@ -18,12 +18,16 @@ from collections.abc import Iterable, Iterator
 from pathlib import Path
 
 from . import __version__, fs, settings, update_check
+from .backends import plugin_cli
 from .i18n import t
 from .output import use_color
 from .ui import theme
 
 DIST = "agent-toggle"
-UPGRADE = ["uv", "tool", "upgrade", DIST]
+PLUGIN = "agent-toggle@agent-toggle"
+# shortcut: pipx is spotted by "pipx" in the venv path (its default homes); a custom PIPX_HOME gets uv
+UPGRADE = (["pipx", "upgrade", DIST] if "pipx" in Path(sys.prefix).parts
+           else ["uv", "tool", "upgrade", DIST])
 RELEASE_NOTES = "https://github.com/weskao/agent-toggle/releases/tag/v%s"
 ANSWERS = (update_check.UPDATE_NOW, update_check.SKIP, update_check.SKIP_VERSION)
 
@@ -36,6 +40,16 @@ def _clean(text: str) -> str:
     return _CONTROL.sub("", text)
 
 
+def upgrade_steps() -> list[list[str]]:
+    """Upgrade the CLI, then the Claude Code plugin when it is installed, then refresh the shims."""
+    steps = [UPGRADE]
+    # bare "claude": what a person pastes; offer()'s run() resolves it, as claude is often off PATH
+    if plugin_cli.claude_bin() and any(p["id"] == PLUGIN for p in plugin_cli.list_plugins(lambda _msg: None)):
+        steps += [["claude", "plugin", "marketplace", "update", DIST],
+                  ["claude", "plugin", "update", PLUGIN]]
+    return [*steps, [DIST, "install-shims"]]
+
+
 def cache_path() -> Path:
     return fs.state_dir() / "update-check.json"
 
@@ -64,9 +78,10 @@ def _available(found: update_check.UpdateAvailable) -> str:
 
 
 def hint(found: update_check.UpdateAvailable) -> str:
-    """The `ask` off a terminal (CI, pipes, --json): two plain lines, never a block."""
+    """The `ask` off a terminal (CI, pipes, --json): the headline, then one command per line."""
     print(_available(found), file=sys.stderr)
-    print("  " + " ".join(UPGRADE), file=sys.stderr)
+    for step in upgrade_steps():
+        print("  " + " ".join(step), file=sys.stderr)
     return update_check.SKIP
 
 
@@ -182,20 +197,44 @@ def offer(started: update_check.Started | None, *, json_mode: bool = False,
     stderr only and never raises, so neither stdout nor the exit code can change."""
     if started is None:
         return None
-    if is_interactive() and not json_mode:
+    # Windows cannot replace the agent-toggle.exe that is running: print the commands, run none
+    if is_interactive() and not json_mode and not fs.WIN:
         def asker(found):
             return ask(found, color_mode)
     else:
         asker = hint
-    def run(cmd, **kw):                 # uv's output must never reach stdout
-        return subprocess.run(cmd, stdout=sys.stderr, **kw)
-    answer = update_check.offer(started, asker, cache_path=cache_path(), upgrade=UPGRADE, run=run)
+    def run(cmd, **kw):                 # their output must never reach stdout; no step may prompt
+        if cmd[0] == "claude":
+            cmd = [plugin_cli.claude_bin() or "claude", *cmd[1:]]
+        return subprocess.run(cmd, stdout=sys.stderr, stdin=subprocess.DEVNULL, **kw)
+    steps: list[list[str]] = []
+    def upgrade(_found):
+        steps.extend(upgrade_steps())
+        return steps
+    answer = update_check.offer(started, asker, cache_path=cache_path(), upgrade=upgrade, run=run)
     if answer == update_check.UPGRADE_FAILED:
         try:
             mark = theme.ansi("warning", "⚠" if theme.get_glyphs(sys.stderr).unicode else "!",
                               use_color(sys.stderr, color_mode))
             print(mark + " " + t("update.failed", "upgrade did not finish — run it yourself: %s",
-                                 " ".join(UPGRADE)), file=sys.stderr)
+                                 "\n  ".join(map(" ".join, steps or [UPGRADE]))), file=sys.stderr)
         except Exception:  # noqa: BLE001, S110 - a hint must never fail the command
             pass
     return answer
+
+
+def cmd_update(out) -> None:
+    """`update`: check PyPI now (cache and "skipped" ignored), show what would be updated and
+    the commands for it. Runs none of them: the picker's Update now does that."""
+    found = update_check.check(DIST, __version__, cache_path=cache_path(), ttl_seconds=0,
+                               timeout=5.0, ignore_skip=True)
+    if found is None:
+        out.row(None, "cli", DIST, "update", "ok", f"no newer release found (you have {__version__})",
+                current=__version__, latest=None, commands=[])
+        return
+    steps = [" ".join(s) for s in upgrade_steps()]
+    out.row(None, "cli", DIST, "update", "ok", f"{found.current} -> {found.latest}", show=False,
+            current=found.current, latest=found.latest, commands=steps)
+    out.say(_available(found) + ". Run, in order:")
+    for step in steps:
+        out.say("  " + step)

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/agent_toggle.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.10.0
+Version: 0.11.0
 Summary: Temporarily disable / re-enable AI-agent skills, agents, commands, rules, plugins and MCP servers across harnesses (Claude Code, Codex, Grok, OpenCode, OpenClaw, Copilot, Vibe, Devin, Antigravity)
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/weskao/agent-toggle
@@ -195,6 +195,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `status` | health check: harnesses found, types each supports, parked counts, gitignore, untracked parked items, stale live twins, shared dirs, and state entries whose parked item is gone (a `stale` row with the fix command; read-only, still exit `0`) |
 | `list [type]` | what is currently disabled (`--project <dir>` filters to one project) |
 | `cost [--type T]` | estimated startup tokens per item, biggest first (read-only; `--harness H` filters; `--project <dir>` prices a repo's `.claude/` and `.mcp.json` instead of user scope) |
+| `update` | check PyPI now (ignores the cache and a skipped version) and print the commands that update the CLI, the Claude Code plugin (when installed) and the shims; runs none of them. `/agent-toggle update` in Claude Code does the same; opening the pane toasts a newer release once |
 | `install-shims` | write the skill shim into every installed harness that is on in the settings (an off one is skipped unless named with `--harness`); refuses to overwrite a file it did not write (`--dry-run` shows the plan); reports stale legacy `<dir>-disabled/` lines in a harness-home `.gitignore` (`--gitignore` removes them, `--no-gitignore` skips the check); on a terminal, then asks y/n for each problem `doctor` can fix (see [Fixing](#fixing)) |
 | `disable <type> <name>...` | park one or more items (`--dry-run` shows the plan; `--project <dir>` for a repo's own `.claude/` and `.mcp.json`) |
 | `enable <type> <name>...` | put them back (`--dry-run` shows the plan; `--project <dir>` likewise) |
@@ -472,10 +473,15 @@ before the command and is offered after it, on every exit path; it overlaps the
 
 - **On a terminal** (stdin and stderr are TTYs, no `--json`): a panel on stderr, "agent-toggle X
   is available (you have Y)", with `Update now`, `Skip` and `Skip until next version`, a release
-  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs `uv tool upgrade agent-toggle`; if that
-  fails you get a yellow warning with the command to run yourself.
-- **Off a terminal**: two stderr lines, `agent-toggle X is available (you have Y)` and
-  `  uv tool upgrade agent-toggle`.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs, in order and stopping at the first
+  failure: `uv tool upgrade agent-toggle` (`pipx upgrade agent-toggle` for a pipx install), then,
+  when the Claude Code plugin is installed, `claude plugin marketplace update agent-toggle` and
+  `claude plugin update agent-toggle@agent-toggle`, then `agent-toggle install-shims`. A failure
+  gives a yellow warning listing the commands to run yourself.
+- **Windows**: a running `agent-toggle.exe` cannot be replaced, so there is no `Update now`; the
+  commands are printed instead (as below), to run once agent-toggle has exited.
+- **Off a terminal** (or `--json`): a stderr line, `agent-toggle X is available (you have Y)`,
+  then those commands, one per line.
 - It never changes the exit code or stdout, so `--json` output stays one document.
 
 It is one `GET https://pypi.org/pypi/agent-toggle/json` on a background thread with a 0.8 s

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/tests/test_cli.py

@@ -181,7 +181,8 @@ class UpdateCheckTest(CliCase):
     def test_hint_on_stderr_off_a_tty(self) -> None:
         rc, out, err = self.run_cli("status")
         self.assertEqual(rc, 0)
-        self.assertEqual(err.splitlines()[-2:], [HINT, "  uv tool upgrade agent-toggle"])
+        self.assertEqual(err.splitlines()[-3:], [HINT, "  uv tool upgrade agent-toggle",
+                                                 "  agent-toggle install-shims"])
         self.assertNotIn("99.0.0", out)
 
     def test_opt_out_by_env_and_by_setting(self) -> None:
@@ -233,10 +234,10 @@ class UpdateCheckTest(CliCase):
             rc, out, err = self.run_cli("--version")      # runs no other subprocess
         self.assertEqual((rc, out.strip()), (0, f"agent-toggle {__version__}"))
         run.assert_called_once_with(["uv", "tool", "upgrade", "agent-toggle"], check=False,
-                                    stdout=mock.ANY)
+                                    stdout=mock.ANY, stdin=subprocess.DEVNULL)
         self.assertIn("did not finish", run.call_args.kwargs["stdout"].getvalue())  # = stderr
-        self.assertIn("upgrade did not finish — run it yourself: uv tool upgrade agent-toggle",
-                      err)
+        self.assertIn("upgrade did not finish — run it yourself: uv tool upgrade agent-toggle"
+                      "\n  agent-toggle install-shims", err)
 
     def test_tty_skip_version_and_ctrl_c(self) -> None:
         update_prompt.is_interactive.return_value = True

{agent_toggle-0.10.0 → agent_toggle-0.11.0}/tests/test_cli_surface.py

@@ -250,7 +250,7 @@ class SpellingTest(CliCase):
             ["profile", "list"], ["profile", "diff", "work"],
             ["profile", "apply", "work", "--dry-run"],
             ["undo", "--dry-run"], ["enable", "--all", "--dry-run"],
-            ["doctor"], ["doctor", "--harness", "claude"],
+            ["doctor"], ["doctor", "--harness", "claude"], ["update"],
             ["disable", "skill", "demo-skill", "--project", str(proj), "--dry-run"],
         )
         for argv in cases:

agent_toggle-0.11.0/tests/test_update_prompt.py

@@ -0,0 +1,78 @@
+"""The update prompt flushes typeahead around cbreak mode."""
+from __future__ import annotations
+
+import io
+import sys
+import unittest
+from unittest import mock
+
+from agent_toggle import update_check, update_prompt
+from agent_toggle.ui import theme
+
+
+class ReleaseNotesTest(unittest.TestCase):
+    def test_a_v_prefixed_version_is_not_doubled_in_the_url(self) -> None:
+        for latest in ("10.0", "v10.0"):
+            found = update_check.UpdateAvailable(latest=latest, current="1.0")
+            text = "\n".join(update_prompt._lines(found, 1, False, theme.ASCII))
+            self.assertIn("/releases/tag/v10.0", text, latest)
+
+
+class UpgradeStepsTest(unittest.TestCase):
+    def steps(self, claude, plugins):
+        with mock.patch.object(update_prompt.plugin_cli, "claude_bin", return_value=claude), \
+                mock.patch.object(update_prompt.plugin_cli, "list_plugins",
+                                  return_value=[{"id": i} for i in plugins]):
+            return update_prompt.upgrade_steps()
+
+    def test_the_plugin_is_updated_only_when_it_is_installed(self) -> None:
+        cli, shims = update_prompt.UPGRADE, ["agent-toggle", "install-shims"]
+        self.assertEqual(self.steps("claude", ["agent-toggle@agent-toggle"]), [
+            cli, ["claude", "plugin", "marketplace", "update", "agent-toggle"],
+            ["claude", "plugin", "update", "agent-toggle@agent-toggle"], shims])
+        self.assertEqual(self.steps("claude", ["other@x"]), [cli, shims])
+        self.assertEqual(self.steps(None, []), [cli, shims])
+
+
+class CmdUpdateTest(unittest.TestCase):
+    def run_update(self, latest):
+        out = mock.Mock()
+        found = update_check.UpdateAvailable("0.1", latest) if latest else None
+        with mock.patch.object(update_check, "check", return_value=found) as check, \
+                mock.patch.object(update_prompt, "upgrade_steps", return_value=[["a", "b"], ["c"]]), \
+                mock.patch.object(update_prompt, "cache_path", return_value="x"):
+            update_prompt.cmd_update(out)
+        return out, check
+
+    def test_a_newer_release_lists_every_command_and_ignores_cache_and_skip(self) -> None:
+        out, check = self.run_update("0.2")
+        row = out.row.call_args.kwargs
+        self.assertEqual((row["latest"], row["commands"]), ("0.2", ["a b", "c"]))
+        self.assertEqual((check.call_args.kwargs["ttl_seconds"], check.call_args.kwargs["ignore_skip"]), (0, True))
+
+    def test_nothing_newer_lists_no_command(self) -> None:
+        out, _ = self.run_update(None)
+        self.assertEqual(out.row.call_args.kwargs["commands"], [])
+
+
+class FlushTest(unittest.TestCase):
+    def test_input_is_flushed_after_entering_and_after_leaving_cbreak(self) -> None:
+        termios = mock.MagicMock()
+        calls: list[str] = []
+        termios.tcgetattr.return_value = []
+        termios.tcflush.side_effect = lambda *_a: calls.append("flush")
+        termios.tcsetattr.side_effect = lambda *_a: calls.append("restore")
+        tty = mock.MagicMock()
+        tty.setcbreak.side_effect = lambda *_a: calls.append("cbreak")
+        stdin = mock.MagicMock()
+        stdin.fileno.return_value = 0
+        found = update_check.UpdateAvailable(current="1.0", latest="2.0")
+        with (mock.patch.dict(sys.modules, {"termios": termios, "tty": tty}),
+              mock.patch.object(sys, "stdin", stdin), mock.patch.object(sys, "stderr", io.StringIO()),
+              mock.patch.object(update_prompt, "_posix_keys", lambda _fd: iter(["quit"]))):
+            self.assertEqual(update_prompt.ask(found), update_check.SKIP)
+        self.assertEqual(calls, ["cbreak", "flush", "restore", "flush"])
+
+
+if __name__ == "__main__":
+    unittest.main()

agent_toggle-0.10.0/tests/test_update_prompt.py

@@ -1,41 +0,0 @@
-"""The update prompt flushes typeahead around cbreak mode."""
-from __future__ import annotations
-
-import io
-import sys
-import unittest
-from unittest import mock
-
-from agent_toggle import update_check, update_prompt
-from agent_toggle.ui import theme
-
-
-class ReleaseNotesTest(unittest.TestCase):
-    def test_a_v_prefixed_version_is_not_doubled_in_the_url(self) -> None:
-        for latest in ("10.0", "v10.0"):
-            found = update_check.UpdateAvailable(latest=latest, current="1.0")
-            text = "\n".join(update_prompt._lines(found, 1, False, theme.ASCII))
-            self.assertIn("/releases/tag/v10.0", text, latest)
-
-
-class FlushTest(unittest.TestCase):
-    def test_input_is_flushed_after_entering_and_after_leaving_cbreak(self) -> None:
-        termios = mock.MagicMock()
-        calls: list[str] = []
-        termios.tcgetattr.return_value = []
-        termios.tcflush.side_effect = lambda *_a: calls.append("flush")
-        termios.tcsetattr.side_effect = lambda *_a: calls.append("restore")
-        tty = mock.MagicMock()
-        tty.setcbreak.side_effect = lambda *_a: calls.append("cbreak")
-        stdin = mock.MagicMock()
-        stdin.fileno.return_value = 0
-        found = update_check.UpdateAvailable(current="1.0", latest="2.0")
-        with (mock.patch.dict(sys.modules, {"termios": termios, "tty": tty}),
-              mock.patch.object(sys, "stdin", stdin), mock.patch.object(sys, "stderr", io.StringIO()),
-              mock.patch.object(update_prompt, "_posix_keys", lambda _fd: iter(["quit"]))):
-            self.assertEqual(update_prompt.ask(found), update_check.SKIP)
-        self.assertEqual(calls, ["cbreak", "flush", "restore", "flush"])
-
-
-if __name__ == "__main__":
-    unittest.main()