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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.9.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
@@ -32,6 +32,8 @@ Dynamic: license-file
 
 # agent-toggle
 
+PyPI: <https://pypi.org/project/agent-toggle/>
+
 Temporarily disable and restore AI-agent resources — skills, agents, commands,
 rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok CLI, OpenCode,
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
@@ -193,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) |
@@ -367,7 +370,8 @@ off under `--dry-run`. Esc closes the prompt.
 Nothing happens while the picker is open. Changes are staged, the screen is
 torn down, and only then do the real operations run, so their output (which
 companion files moved, which were kept because they are shared) is readable
-instead of fighting curses for the terminal.
+instead of fighting curses for the terminal. Claude Code sessions running the
+[pane mod](#claude-code-pane-mod) pick up the Claude changes within 5 s and reload them.
 
 Built on stdlib `curses`, so there is nothing to install on macOS and Linux
 (on Windows, `pip install "agent-toggle[windows]"` pulls `windows-curses`).
@@ -469,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
@@ -598,7 +607,8 @@ visible rather than silent.
   hand-rolled serializer would mangle comments — a text slice is lossless and
   much less code.
 
-MCP changes need a **new session** to take effect.
+MCP changes need a **new session** to take effect, except in a Claude Code session running the
+agent-toggle mod, which runs `/mcp disable|enable <name>` for you (see the mod section).
 
 ### Claude MCP scopes
 
@@ -846,6 +856,7 @@ bookkeeping.
 | `state.json` | current disabled list (schema v3; atomic write, mode `0600`), saved before each flag write or dir move with the op in flight under an optional `pending` key, and after each MCP / plugin item |
 | `lock` | held by `disable` / `enable` / `enable --all` / `undo` / `profile apply` / `migrate` / `ui` for the whole batch; a second run waits 5 s then exits `3` (stale after 10 min *and* its PID is gone; a live batch refreshes it per item; the error says when its PID is gone, i.e. a killed run left it) |
 | `log.jsonl` | one line per operation (mode `0600`), see below |
+| `reload.json` | the Claude rows the last `ui` Enter changed, rewritten each time; open Claude Code sessions running the mod poll it and reload them |
 | `mcp-backups/` | `<harness>__<server>.json`, or `<sha8>__<harness>__<server>.json` for a project `.mcp.json` (mode `0600` -- may hold auth headers) |
 | `companions/` | parked exclusive helper files |
 | `parked/user/<owner>/<dir>/` | user-scope items, e.g. `parked/user/claude/skills/<name>` (`<owner>` = the harness whose home holds the dir; a dir shared by several harnesses parks once, under its owner); an absolute OpenCode `skills.paths` dir parks under `parked/user/opencode/ext-<sha8>/` (`<sha8>` of its resolved path). Nothing is ever parked inside a harness home |
@@ -948,7 +959,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
 - It looks like the `ui` picker: a title with the live-token total, a search line, rows under
   type headings with counts, green `●` live / yellow `○` parked, tokens and a bar per row (a
   parked row shows `(N)`, what restoring it would load), the cursor row in reverse video, and a
-  key-chip footer. The list scrolls with the cursor.
+  key-chip footer. The list scrolls with the cursor; the status line shows its position (`7/23`),
+  and the first and last list lines count the rows out of view (`↑ 4`, `↓ 12`).
 - The mouse wheel over the list moves the cursor, as in the terminal picker; no click needed.
 - Click the list once so it takes keys (Esc hands the keyboard back to the prompt). Then `↑` `↓`
   `PgUp` `PgDn` `Home` `End` (also `Ctrl-P` / `Ctrl-N`) move; `Space` or `Enter` toggles the row,
@@ -958,8 +970,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   ...), like `disable all <name>`; `Ctrl-U` clears the search. A click moves the cursor.
 - A toggle applies at once (no staging, no Enter to apply); the toast names the target and the state
   with an emoji and a bracketed tag (no colour codes, so nothing garbles; on the Linux console and the
-  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (takes effect in a new
-  session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
+  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (/reload-plugins)`,
+  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
   The row flips the moment you press (and flips back
   if the CLI fails); the list reloads in the background. While a toggle runs, further keys are ignored.
 - Opening the pane shows the same braille spinner and `Loading resources…` as `agent-toggle ui`
@@ -970,6 +982,15 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   `undo`, `list`, `status`, `cost` or `doctor` runs the CLI instead of opening the pane and prints
   one line per result row: `/agent-toggle disable skill foo bar` (it adds `--json`, and
   `--harness claude` unless you pass `--harness`). A toggle reloads an open pane.
+- Inside Claude Code the mod then applies the change to the running session by queueing the slash
+  command for you, once per kind: skills and commands `/reload-skills`, plugins (mods included)
+  `/reload-plugins`, an MCP server `/mcp disable|enable <name>`. The toast names it, e.g.
+  `⛔ [DISABLED] skill: foo (/reload-skills)`. Agents and rules have no reload and still say
+  `takes effect in a new session`. If Claude refuses a queued command, a toast says so.
+- `agent-toggle ui` in another terminal applies on Enter and writes the Claude rows it changed to
+  `~/.agent-toggle/reload.json`. Every open session running the mod checks that file's mtime every
+  5 s (one `stat`) and queues the same reloads, toasting `agent-toggle ui: /reload-skills`. A file
+  older than the session is ignored.
 - Needs `agent-toggle` on `PATH`.
 - On Windows `agent-toggle` must resolve to a real executable on `PATH` (a pip or uv install
   provides `agent-toggle.exe`).

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

@@ -1,5 +1,7 @@
 # agent-toggle
 
+PyPI: <https://pypi.org/project/agent-toggle/>
+
 Temporarily disable and restore AI-agent resources — skills, agents, commands,
 rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok CLI, OpenCode,
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
@@ -161,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) |
@@ -335,7 +338,8 @@ off under `--dry-run`. Esc closes the prompt.
 Nothing happens while the picker is open. Changes are staged, the screen is
 torn down, and only then do the real operations run, so their output (which
 companion files moved, which were kept because they are shared) is readable
-instead of fighting curses for the terminal.
+instead of fighting curses for the terminal. Claude Code sessions running the
+[pane mod](#claude-code-pane-mod) pick up the Claude changes within 5 s and reload them.
 
 Built on stdlib `curses`, so there is nothing to install on macOS and Linux
 (on Windows, `pip install "agent-toggle[windows]"` pulls `windows-curses`).
@@ -437,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
@@ -566,7 +575,8 @@ visible rather than silent.
   hand-rolled serializer would mangle comments — a text slice is lossless and
   much less code.
 
-MCP changes need a **new session** to take effect.
+MCP changes need a **new session** to take effect, except in a Claude Code session running the
+agent-toggle mod, which runs `/mcp disable|enable <name>` for you (see the mod section).
 
 ### Claude MCP scopes
 
@@ -814,6 +824,7 @@ bookkeeping.
 | `state.json` | current disabled list (schema v3; atomic write, mode `0600`), saved before each flag write or dir move with the op in flight under an optional `pending` key, and after each MCP / plugin item |
 | `lock` | held by `disable` / `enable` / `enable --all` / `undo` / `profile apply` / `migrate` / `ui` for the whole batch; a second run waits 5 s then exits `3` (stale after 10 min *and* its PID is gone; a live batch refreshes it per item; the error says when its PID is gone, i.e. a killed run left it) |
 | `log.jsonl` | one line per operation (mode `0600`), see below |
+| `reload.json` | the Claude rows the last `ui` Enter changed, rewritten each time; open Claude Code sessions running the mod poll it and reload them |
 | `mcp-backups/` | `<harness>__<server>.json`, or `<sha8>__<harness>__<server>.json` for a project `.mcp.json` (mode `0600` -- may hold auth headers) |
 | `companions/` | parked exclusive helper files |
 | `parked/user/<owner>/<dir>/` | user-scope items, e.g. `parked/user/claude/skills/<name>` (`<owner>` = the harness whose home holds the dir; a dir shared by several harnesses parks once, under its owner); an absolute OpenCode `skills.paths` dir parks under `parked/user/opencode/ext-<sha8>/` (`<sha8>` of its resolved path). Nothing is ever parked inside a harness home |
@@ -916,7 +927,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
 - It looks like the `ui` picker: a title with the live-token total, a search line, rows under
   type headings with counts, green `●` live / yellow `○` parked, tokens and a bar per row (a
   parked row shows `(N)`, what restoring it would load), the cursor row in reverse video, and a
-  key-chip footer. The list scrolls with the cursor.
+  key-chip footer. The list scrolls with the cursor; the status line shows its position (`7/23`),
+  and the first and last list lines count the rows out of view (`↑ 4`, `↓ 12`).
 - The mouse wheel over the list moves the cursor, as in the terminal picker; no click needed.
 - Click the list once so it takes keys (Esc hands the keyboard back to the prompt). Then `↑` `↓`
   `PgUp` `PgDn` `Home` `End` (also `Ctrl-P` / `Ctrl-N`) move; `Space` or `Enter` toggles the row,
@@ -926,8 +938,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   ...), like `disable all <name>`; `Ctrl-U` clears the search. A click moves the cursor.
 - A toggle applies at once (no staging, no Enter to apply); the toast names the target and the state
   with an emoji and a bracketed tag (no colour codes, so nothing garbles; on the Linux console and the
-  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (takes effect in a new
-  session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
+  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (/reload-plugins)`,
+  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
   The row flips the moment you press (and flips back
   if the CLI fails); the list reloads in the background. While a toggle runs, further keys are ignored.
 - Opening the pane shows the same braille spinner and `Loading resources…` as `agent-toggle ui`
@@ -938,6 +950,15 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   `undo`, `list`, `status`, `cost` or `doctor` runs the CLI instead of opening the pane and prints
   one line per result row: `/agent-toggle disable skill foo bar` (it adds `--json`, and
   `--harness claude` unless you pass `--harness`). A toggle reloads an open pane.
+- Inside Claude Code the mod then applies the change to the running session by queueing the slash
+  command for you, once per kind: skills and commands `/reload-skills`, plugins (mods included)
+  `/reload-plugins`, an MCP server `/mcp disable|enable <name>`. The toast names it, e.g.
+  `⛔ [DISABLED] skill: foo (/reload-skills)`. Agents and rules have no reload and still say
+  `takes effect in a new session`. If Claude refuses a queued command, a toast says so.
+- `agent-toggle ui` in another terminal applies on Enter and writes the Claude rows it changed to
+  `~/.agent-toggle/reload.json`. Every open session running the mod checks that file's mtime every
+  5 s (one `stat`) and queues the same reloads, toasting `agent-toggle ui: /reload-skills`. A file
+  older than the session is ignored.
 - Needs `agent-toggle` on `PATH`.
 - On Windows `agent-toggle` must resolve to a real executable on `PATH` (a pip or uv install
   provides `agent-toggle.exe`).

{agent_toggle-0.9.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.9.0"
+__version__ = "0.11.0"

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

@@ -325,6 +325,7 @@ def cmd_ui(state: dict, out: Result, dry_run: bool = False, project: str | None
     if dry_run:
         out.say("\ndry run -- nothing changed")
         return
+    store.signal_reload(out.rows)
     if any(r.type in ("mcp", "plugin") for r in changes):
         out.say("\nMCP/plugin changed -- open a NEW session for it to take effect.")
 
@@ -557,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")
 
 
@@ -692,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"),
@@ -726,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:
@@ -794,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.9.0 → agent_toggle-0.11.0}/agent_toggle/fs.py

@@ -44,6 +44,10 @@ def log_file() -> Path:
     return state_dir() / "log.jsonl"
 
 
+def reload_file() -> Path:
+    return state_dir() / "reload.json"
+
+
 def backup_dir() -> Path:
     return state_dir() / "mcp-backups"
 

{agent_toggle-0.9.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.9.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.9.0 → agent_toggle-0.11.0}/agent_toggle/shims/claude.md.tmpl

@@ -1,6 +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 | update | open | close]"
 ---
 <!-- agent-toggle shim: written by `agent-toggle install-shims`; re-running it overwrites this file -->
 
@@ -16,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.9.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.9.0 → agent_toggle-0.11.0}/agent_toggle/store.py

@@ -259,6 +259,15 @@ def log(action: str, type_: str, name: str, result: str, detail: str = "", *,
         fh.write(json.dumps(rec, ensure_ascii=False) + "\n")
 
 
+def signal_reload(rows: list[dict]) -> None:
+    """`ui` runs in a terminal of its own, so it cannot reload a Claude Code session: it leaves the claude rows it
+    changed here, and every session running the agent-toggle mod polls the file and reloads them (mod/hooks/register.tsx)."""
+    done = [r for r in rows if r["harness"] == "claude" and r["status"] == "ok" and r["action"] in ("disable", "enable")]
+    if done:
+        fs.private_dir(fs.state_dir())
+        fs.atomic_write(fs.reload_file(), json.dumps({"batch": BATCH, "results": done}, ensure_ascii=False))
+
+
 def migrate(state: dict) -> int:
     """Import ~/.claude-toggle state so existing rollbacks keep working."""
     legacy_state_dir, backup_dir = fs.legacy_state_dir(), fs.backup_dir()

{agent_toggle-0.9.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.9.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.9.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.9.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
@@ -32,6 +32,8 @@ Dynamic: license-file
 
 # agent-toggle
 
+PyPI: <https://pypi.org/project/agent-toggle/>
+
 Temporarily disable and restore AI-agent resources — skills, agents, commands,
 rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok CLI, OpenCode,
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
@@ -193,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) |
@@ -367,7 +370,8 @@ off under `--dry-run`. Esc closes the prompt.
 Nothing happens while the picker is open. Changes are staged, the screen is
 torn down, and only then do the real operations run, so their output (which
 companion files moved, which were kept because they are shared) is readable
-instead of fighting curses for the terminal.
+instead of fighting curses for the terminal. Claude Code sessions running the
+[pane mod](#claude-code-pane-mod) pick up the Claude changes within 5 s and reload them.
 
 Built on stdlib `curses`, so there is nothing to install on macOS and Linux
 (on Windows, `pip install "agent-toggle[windows]"` pulls `windows-curses`).
@@ -469,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
@@ -598,7 +607,8 @@ visible rather than silent.
   hand-rolled serializer would mangle comments — a text slice is lossless and
   much less code.
 
-MCP changes need a **new session** to take effect.
+MCP changes need a **new session** to take effect, except in a Claude Code session running the
+agent-toggle mod, which runs `/mcp disable|enable <name>` for you (see the mod section).
 
 ### Claude MCP scopes
 
@@ -846,6 +856,7 @@ bookkeeping.
 | `state.json` | current disabled list (schema v3; atomic write, mode `0600`), saved before each flag write or dir move with the op in flight under an optional `pending` key, and after each MCP / plugin item |
 | `lock` | held by `disable` / `enable` / `enable --all` / `undo` / `profile apply` / `migrate` / `ui` for the whole batch; a second run waits 5 s then exits `3` (stale after 10 min *and* its PID is gone; a live batch refreshes it per item; the error says when its PID is gone, i.e. a killed run left it) |
 | `log.jsonl` | one line per operation (mode `0600`), see below |
+| `reload.json` | the Claude rows the last `ui` Enter changed, rewritten each time; open Claude Code sessions running the mod poll it and reload them |
 | `mcp-backups/` | `<harness>__<server>.json`, or `<sha8>__<harness>__<server>.json` for a project `.mcp.json` (mode `0600` -- may hold auth headers) |
 | `companions/` | parked exclusive helper files |
 | `parked/user/<owner>/<dir>/` | user-scope items, e.g. `parked/user/claude/skills/<name>` (`<owner>` = the harness whose home holds the dir; a dir shared by several harnesses parks once, under its owner); an absolute OpenCode `skills.paths` dir parks under `parked/user/opencode/ext-<sha8>/` (`<sha8>` of its resolved path). Nothing is ever parked inside a harness home |
@@ -948,7 +959,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
 - It looks like the `ui` picker: a title with the live-token total, a search line, rows under
   type headings with counts, green `●` live / yellow `○` parked, tokens and a bar per row (a
   parked row shows `(N)`, what restoring it would load), the cursor row in reverse video, and a
-  key-chip footer. The list scrolls with the cursor.
+  key-chip footer. The list scrolls with the cursor; the status line shows its position (`7/23`),
+  and the first and last list lines count the rows out of view (`↑ 4`, `↓ 12`).
 - The mouse wheel over the list moves the cursor, as in the terminal picker; no click needed.
 - Click the list once so it takes keys (Esc hands the keyboard back to the prompt). Then `↑` `↓`
   `PgUp` `PgDn` `Home` `End` (also `Ctrl-P` / `Ctrl-N`) move; `Space` or `Enter` toggles the row,
@@ -958,8 +970,8 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   ...), like `disable all <name>`; `Ctrl-U` clears the search. A click moves the cursor.
 - A toggle applies at once (no staging, no Enter to apply); the toast names the target and the state
   with an emoji and a bracketed tag (no colour codes, so nothing garbles; on the Linux console and the
-  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (takes effect in a new
-  session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
+  legacy Windows console, where emoji draw as boxes, the tag alone): `✅ [ENABLED] skill: foo`, `⛔ [DISABLED] mod: bar (/reload-plugins)`,
+  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
   The row flips the moment you press (and flips back
   if the CLI fails); the list reloads in the background. While a toggle runs, further keys are ignored.
 - Opening the pane shows the same braille spinner and `Loading resources…` as `agent-toggle ui`
@@ -970,6 +982,15 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   `undo`, `list`, `status`, `cost` or `doctor` runs the CLI instead of opening the pane and prints
   one line per result row: `/agent-toggle disable skill foo bar` (it adds `--json`, and
   `--harness claude` unless you pass `--harness`). A toggle reloads an open pane.
+- Inside Claude Code the mod then applies the change to the running session by queueing the slash
+  command for you, once per kind: skills and commands `/reload-skills`, plugins (mods included)
+  `/reload-plugins`, an MCP server `/mcp disable|enable <name>`. The toast names it, e.g.
+  `⛔ [DISABLED] skill: foo (/reload-skills)`. Agents and rules have no reload and still say
+  `takes effect in a new session`. If Claude refuses a queued command, a toast says so.
+- `agent-toggle ui` in another terminal applies on Enter and writes the Claude rows it changed to
+  `~/.agent-toggle/reload.json`. Every open session running the mod checks that file's mtime every
+  5 s (one `stat`) and queues the same reloads, toasting `agent-toggle ui: /reload-skills`. A file
+  older than the session is ignored.
 - Needs `agent-toggle` on `PATH`.
 - On Windows `agent-toggle` must resolve to a real executable on `PATH` (a pip or uv install
   provides `agent-toggle.exe`).

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

@@ -78,6 +78,7 @@ class ApplyPlanSeamTest(SandboxCase):
         self.assertEqual(plan, [ops.Op("claude", "skill", "disable", "demo-skill")])
         self.assertEqual(spy.call_args.kwargs["batch"], store.BATCH)
         self.assertFalse((self.home / "skills/demo-skill").exists())
+        self.assertFalse(fs.reload_file().exists())   # only `ui` signals: the mod reloads its own runs itself
 
     def test_cmd_ui_goes_through_apply_plan(self) -> None:
         try:
@@ -94,6 +95,10 @@ class ApplyPlanSeamTest(SandboxCase):
                          [ops.Op("claude", "skill", "disable", "demo-skill")])
         self.assertFalse((self.home / "skills/demo-skill").exists())
         self.assertIn("claude:skill:demo-skill", store.load_state()["disabled"])
+        # Enter applied it: open Claude Code sessions (the mod polls this file) reload the skill
+        sig = json.loads(fs.reload_file().read_text(encoding="utf-8"))
+        self.assertEqual([(r["type"], r["name"], r["action"], r["status"]) for r in sig["results"]],
+                         [("skill", "demo-skill", "disable", "ok")])
 
     def test_type_without_a_mechanism_is_an_unsupported_row(self) -> None:
         out = Result()
@@ -176,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:
@@ -228,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.9.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.9.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()