agent-toggle 0.14.0__tar.gz → 0.16.0__tar.gz

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.14.0
+Version: 0.16.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
@@ -25,6 +25,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: telegram-kit<0.3,>=0.2.2
+Requires-Dist: update-kit<0.3,>=0.2.1
 Provides-Extra: windows
 Requires-Dist: windows-curses; sys_platform == "win32" and extra == "windows"
 Provides-Extra: telegram
@@ -40,6 +41,10 @@ rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
 session start.
 
+It ships in two forms: a **CLI** (`agent-toggle`, all harnesses) and a **Claude Code mod**
+(the `/agent-toggle` pane, claude harness only; see [Claude Code pane mod](#claude-code-pane-mod)).
+Both drive the same toggle engine and state.
+
 **Nothing is ever deleted.** Everything is parked and recorded, and `enable`
 puts it back where it came from.
 
@@ -202,7 +207,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 |
+| `update` (also `--update`) | install the newest release tag (`uv tool install --force --no-sources git+<repo>@<tag>`, or `pipx install --force` for a pipx install), then, with the new version, update the Claude Code plugin (when installed) and the shims. Never asks. Always the newest tag: a dev checkout, a branch or an unmanaged install is replaced by it. Exit `0` updated or already current, `1` the check or install failed (offline, rate limit), `2` neither uv nor pipx is found (the manual command is printed). Messages go to stderr; `--json` has no JSON for it. The `/agent-toggle` pane command has no `update`: run it in a terminal |
 | `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) |
@@ -495,18 +500,17 @@ invalid value in either is ignored with one warning on stderr.
 
 On every invocation (unless disabled) agent-toggle checks PyPI for a newer release. It starts
 before the command and is offered after it, on every exit path; it overlaps the command and waits at most 0.8 s afterwards.
+`update` and `completion` skip it.
 
 - **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, 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.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs [`agent-toggle update`](#update) (the
+  newest release tag, then the Claude Code plugin and the shims). A failure gives a yellow warning
+  naming the command 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.
+  command is 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.
+  then `  agent-toggle update`.
 - 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
@@ -515,6 +519,28 @@ normal HTTP request with the User-Agent `agent-toggle-update-check`. See `SECURI
 for the hardening. To turn it off, set `AGENT_TOGGLE_UPDATE_CHECK=0` or the `update_check` setting
 to off (the settings menu's "Check for updates").
 
+## Update
+
+`agent-toggle update` (or `agent-toggle --update`) is a self-update through
+update-kit (a small stdlib-only helper library): it asks the repository for its newest `vX.Y.Z`
+tag (`git ls-remote --tags`) and always installs that tag with
+`uv tool install --force --no-sources git+<repo>@<tag>` (`pipx install --force` for a pipx install).
+A dev checkout, a branch or commit install, or an unmanaged install is replaced by the tag too
+(with uv, else pipx); only an install made from exactly that tag is already up to date.
+It then runs, with the new binary and in order: 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 failing step prints a warning and makes the exit code `1`.
+It never prompts and writes to stderr only.
+
+| Exit | Meaning |
+|---|---|
+| `0` | updated, or already up to date |
+| `1` | could not check (offline, rate limit) or the install failed |
+| `2` | neither uv nor pipx is found (the manual command is printed) |
+
+On Windows a running `agent-toggle.exe` cannot be replaced, so the install runs detached after
+agent-toggle exits (log in `%USERPROFILE%\.update-kit\`).
+
 ## Help
 
 ```sh

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/README.md

@@ -7,6 +7,10 @@ rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
 session start.
 
+It ships in two forms: a **CLI** (`agent-toggle`, all harnesses) and a **Claude Code mod**
+(the `/agent-toggle` pane, claude harness only; see [Claude Code pane mod](#claude-code-pane-mod)).
+Both drive the same toggle engine and state.
+
 **Nothing is ever deleted.** Everything is parked and recorded, and `enable`
 puts it back where it came from.
 
@@ -169,7 +173,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 |
+| `update` (also `--update`) | install the newest release tag (`uv tool install --force --no-sources git+<repo>@<tag>`, or `pipx install --force` for a pipx install), then, with the new version, update the Claude Code plugin (when installed) and the shims. Never asks. Always the newest tag: a dev checkout, a branch or an unmanaged install is replaced by it. Exit `0` updated or already current, `1` the check or install failed (offline, rate limit), `2` neither uv nor pipx is found (the manual command is printed). Messages go to stderr; `--json` has no JSON for it. The `/agent-toggle` pane command has no `update`: run it in a terminal |
 | `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) |
@@ -462,18 +466,17 @@ invalid value in either is ignored with one warning on stderr.
 
 On every invocation (unless disabled) agent-toggle checks PyPI for a newer release. It starts
 before the command and is offered after it, on every exit path; it overlaps the command and waits at most 0.8 s afterwards.
+`update` and `completion` skip it.
 
 - **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, 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.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs [`agent-toggle update`](#update) (the
+  newest release tag, then the Claude Code plugin and the shims). A failure gives a yellow warning
+  naming the command 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.
+  command is 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.
+  then `  agent-toggle update`.
 - 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
@@ -482,6 +485,28 @@ normal HTTP request with the User-Agent `agent-toggle-update-check`. See `SECURI
 for the hardening. To turn it off, set `AGENT_TOGGLE_UPDATE_CHECK=0` or the `update_check` setting
 to off (the settings menu's "Check for updates").
 
+## Update
+
+`agent-toggle update` (or `agent-toggle --update`) is a self-update through
+update-kit (a small stdlib-only helper library): it asks the repository for its newest `vX.Y.Z`
+tag (`git ls-remote --tags`) and always installs that tag with
+`uv tool install --force --no-sources git+<repo>@<tag>` (`pipx install --force` for a pipx install).
+A dev checkout, a branch or commit install, or an unmanaged install is replaced by the tag too
+(with uv, else pipx); only an install made from exactly that tag is already up to date.
+It then runs, with the new binary and in order: 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 failing step prints a warning and makes the exit code `1`.
+It never prompts and writes to stderr only.
+
+| Exit | Meaning |
+|---|---|
+| `0` | updated, or already up to date |
+| `1` | could not check (offline, rate limit) or the install failed |
+| `2` | neither uv nor pipx is found (the manual command is printed) |
+
+On Windows a running `agent-toggle.exe` cannot be replaced, so the install runs detached after
+agent-toggle exits (log in `%USERPROFILE%\.update-kit\`).
+
 ## Help
 
 ```sh

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle/__init__.py

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

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle/cli.py

@@ -695,7 +695,7 @@ def build_parser() -> argparse.ArgumentParser:
     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")
+                   help="install the newest release, then refresh the plugin and shims")
     cf = sub.add_parser("config", parents=[common],
                         help="Telegram settings for the CI failure alerts")
     cf.add_argument("action", nargs="?", choices=("test", "sync-ci"),
@@ -734,7 +734,7 @@ def main(argv: list[str] | None = None) -> int:
     i18n.set_language(language)
     color = scan_color(argv, color)     # --color > env > setting > auto
     i = _command_index(argv)
-    # `update` is the check; `completion` may run on every shell start (eval "$(...)")
+    # `update` is the update; `completion` may run on every shell start (eval "$(...)")
     started = None if argv[i:i + 1] in (["update"], ["completion"]) else update_prompt.start()
     try:
         return _main(argv, color)
@@ -804,7 +804,7 @@ def _main(argv: list[str], color: str) -> int:
             if fixes and _interactive(out):
                 doctor.offer_fixes(fixes, out)
         elif cmd == "update":
-            update_prompt.cmd_update(out)
+            return update_prompt.cmd_update()
         elif cmd == "config":
             config.cmd_config(args, out)
         elif cmd == "completion":

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle/help.py

@@ -137,12 +137,14 @@ def commands(default_harness: str = "claude") -> dict[str, Cmd]:
             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"]),
+            t("help.update.summary", "install the newest release; refresh the plugin and shims"),
+            t("help.update.desc", "Install the newest release tag (uv tool or pipx), then, with the "
+                                  "new version, update the Claude Code plugin (if installed) and "
+                                  "reinstall the shims. Never asks; `--update` is the same. Always "
+                                  "the newest tag: a dev or unmanaged install is replaced by it. "
+                                  "Exit 1 when the check or the install fails, 2 when neither uv "
+                                  "nor pipx is found."),
+            examples=["update"]),
         "completion": Cmd(
             "completion bash|zsh|fish|powershell",
             t("help.completion.summary", "print the shell completion script"),

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle/locales/zh_tw_cli.py

@@ -27,9 +27,10 @@ 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.update.summary": "安裝最新版本，並更新外掛與 shim",
+    "help.update.desc": "安裝最新的發行標籤（uv tool / pipx），完成後以新版更新 Claude Code 外掛（若已安裝）"
+                        "並重新安裝 shim。不會提問；`--update` 等同 `update`。一律安裝最新標籤：開發版或非受管安裝也會被取代。"
+                        "檢查或安裝失敗時結束碼 1；找不到 uv 與 pipx 時結束碼 2。",
     "help.completion.summary": "印出 shell 自動補完腳本",
     "help.completion.desc": "在 stdout 印出某個 shell 的 Tab 補完腳本；"
                             "存到該 shell 載入補完的位置（見 README「Shell completion」）。",

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle/shims/claude.md.tmpl

@@ -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), `update` (checks for a newer release and lists the commands that update it; run none yourself, relay them), `list [type]`,
+Commands: `status` (run first), `doctor` (read-only health check), `update` (installs the newest release, then refreshes the plugin and shims; run it only when the user asks to update), `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.14.0 → agent_toggle-0.16.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), `update` (checks for a newer release and lists the commands that update it; run none yourself, relay them), `list [type]`, `cost [--type T]` (startup
+`doctor` (read-only health check), `update` (installs the newest release, then refreshes the plugin and shims; run it only when the user asks to update), `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.14.0 → agent_toggle-0.16.0}/agent_toggle/update_prompt.py

@@ -1,12 +1,15 @@
-"""The update check's UI: start it before a command, offer the update after it.
+"""The update check's UI, and `update` / `--update`.
 
     started = start()          # None when update_check is off; never raises
     ...                        # the command
     offer(started, json_mode=..., color=...)   # never raises, never touches stdout
 
+    cmd_update()               # install the newest tag (update_kit), then the plugin and shims
+
 On a terminal (stdin AND stderr are TTYs) and not under --json, :func:`ask` shows
 a small arrow-key panel on stderr; elsewhere :func:`hint` prints two plain lines
-on stderr. What each answer does lives in :func:`update_check.offer`.
+on stderr. What each answer does lives in :func:`update_check.offer`; Update now
+is :func:`cmd_update`.
 """
 from __future__ import annotations
 
@@ -14,20 +17,20 @@ import os
 import re
 import subprocess
 import sys
-from collections.abc import Iterable, Iterator
+from collections.abc import Iterable, Iterator, Sequence
+from functools import cached_property
 from pathlib import Path
 
-from . import __version__, fs, settings, update_check
+from . import __version__, fs, i18n, settings, update_check
 from .backends import plugin_cli
 from .i18n import t
 from .output import use_color
 from .ui import theme
 
 DIST = "agent-toggle"
+REPO = "weskao/agent-toggle"
 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])
+UPDATE = [DIST, "update"]
 RELEASE_NOTES = "https://github.com/weskao/agent-toggle/releases/tag/v%s"
 ANSWERS = (update_check.UPDATE_NOW, update_check.SKIP, update_check.SKIP_VERSION)
 
@@ -40,16 +43,51 @@ 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
+def after_steps() -> list[list[str]]:
+    """Run with the NEW binary once the install is done: the Claude Code plugin when it is
+    installed, then the shims."""
+    steps: list[list[str]] = []
+    # bare "claude": what a person pastes; _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"]]
 
 
+class _LazySteps(Sequence):
+    """after_steps(), computed on first use: update_kit only reads `after` once an install
+    will happen, so a failed check / "already the latest" skips `claude plugin list` (0.8 s)."""
+
+    @cached_property
+    def _steps(self) -> list[list[str]]:
+        return after_steps()
+
+    def __len__(self) -> int:
+        return len(self._steps)
+
+    def __getitem__(self, i):
+        return self._steps[i]
+
+
+def _run(cmd, **kw):
+    """update_kit's subprocess runner: their output stays off stdout and no step may prompt,
+    and a step like `install-shims` must not re-check for updates and print the hint."""
+    if cmd[0] == "claude":
+        cmd = [plugin_cli.claude_bin() or "claude", *cmd[1:]]
+    # update_kit passes its own env (no-prompt git vars) for the install step: merge, don't replace
+    kw["env"] = {**kw.get("env", os.environ), "AGENT_TOGGLE_UPDATE_CHECK": "0"}
+    return subprocess.run(cmd, stdout=sys.stderr, stdin=subprocess.DEVNULL, **kw)
+
+
+def cmd_update() -> int:
+    """`update` / `--update` and the panel's Update now: install the newest release tag, then
+    refresh the plugin and shims. Returns update_kit's exit code."""
+    # imported here, like telegram_kit: a checkout run (`python3 agent_toggle.py`) or a stale env lacks it
+    import update_kit
+    return update_kit.update(app=DIST, repo=REPO, dist=DIST, lang=i18n.LANGUAGE,
+                             after=_LazySteps(), out=sys.stderr, run=_run)
+
+
 def cache_path() -> Path:
     return fs.state_dir() / "update-check.json"
 
@@ -78,17 +116,16 @@ def _available(found: update_check.UpdateAvailable) -> str:
 
 
 def hint(found: update_check.UpdateAvailable) -> str:
-    """The `ask` off a terminal (CI, pipes, --json): the headline, then one command per line."""
+    """The `ask` off a terminal (CI, pipes, --json): the headline, then the command to run."""
     print(_available(found), file=sys.stderr)
-    for step in upgrade_steps():
-        print("  " + " ".join(step), file=sys.stderr)
+    print("  " + " ".join(UPDATE), file=sys.stderr)
     return update_check.SKIP
 
 
 def _lines(found: update_check.UpdateAvailable, selected: int, color: bool,
            g: theme.Glyphs) -> list[str]:
     rows = (
-        (t("update.now", "Update now"), " ".join(UPGRADE)),
+        (t("update.now", "Update now"), " ".join(UPDATE)),
         (t("update.skip", "Skip"), t("update.skip_detail", "ask again next run")),
         (t("update.skip_version", "Skip until next version"),
          t("update.skip_version_detail", "ask again once a newer version ships")),
@@ -197,46 +234,27 @@ 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
-    # Windows cannot replace the agent-toggle.exe that is running: print the commands, run none
+    # Windows cannot replace the agent-toggle.exe that is running: print the command, 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):                 # their output must never reach stdout; no step may prompt
-        if cmd[0] == "claude":
-            cmd = [plugin_cli.claude_bin() or "claude", *cmd[1:]]
-        # the install-shims step is agent-toggle itself: it must not re-check and print the hint again
-        env = {**os.environ, settings.DEFAULTS["update_check"].env: "0"}
-        return subprocess.run(cmd, stdout=sys.stderr, stdin=subprocess.DEVNULL, env=env, **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)
+    # no steps for update_check to run: Update now is cmd_update() (update_kit, newest tag)
+    answer = update_check.offer(started, asker, cache_path=cache_path(), upgrade=lambda _found: ())
+    if answer == update_check.UPDATE_NOW:
+        try:
+            failed = cmd_update() != 0
+        except Exception:  # noqa: BLE001 - an update offer must never fail the command
+            failed = True
+        if failed:
+            answer = update_check.UPGRADE_FAILED
     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",
-                                 "\n  ".join(map(" ".join, steps or [UPGRADE]))), file=sys.stderr)
+                                 " ".join(UPDATE)), 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.14.0 → agent_toggle-0.16.0}/agent_toggle.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.14.0
+Version: 0.16.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
@@ -25,6 +25,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: telegram-kit<0.3,>=0.2.2
+Requires-Dist: update-kit<0.3,>=0.2.1
 Provides-Extra: windows
 Requires-Dist: windows-curses; sys_platform == "win32" and extra == "windows"
 Provides-Extra: telegram
@@ -40,6 +41,10 @@ rules, plugins (mods included), MCP servers — across Claude Code, Codex, Grok
 OpenClaw, Copilot, Vibe, Devin and Antigravity — and show what each one costs at
 session start.
 
+It ships in two forms: a **CLI** (`agent-toggle`, all harnesses) and a **Claude Code mod**
+(the `/agent-toggle` pane, claude harness only; see [Claude Code pane mod](#claude-code-pane-mod)).
+Both drive the same toggle engine and state.
+
 **Nothing is ever deleted.** Everything is parked and recorded, and `enable`
 puts it back where it came from.
 
@@ -202,7 +207,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 |
+| `update` (also `--update`) | install the newest release tag (`uv tool install --force --no-sources git+<repo>@<tag>`, or `pipx install --force` for a pipx install), then, with the new version, update the Claude Code plugin (when installed) and the shims. Never asks. Always the newest tag: a dev checkout, a branch or an unmanaged install is replaced by it. Exit `0` updated or already current, `1` the check or install failed (offline, rate limit), `2` neither uv nor pipx is found (the manual command is printed). Messages go to stderr; `--json` has no JSON for it. The `/agent-toggle` pane command has no `update`: run it in a terminal |
 | `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) |
@@ -495,18 +500,17 @@ invalid value in either is ignored with one warning on stderr.
 
 On every invocation (unless disabled) agent-toggle checks PyPI for a newer release. It starts
 before the command and is offered after it, on every exit path; it overlaps the command and waits at most 0.8 s afterwards.
+`update` and `completion` skip it.
 
 - **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, 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.
+  notes link, and `↑` `↓` `Enter` `q`. `Update now` runs [`agent-toggle update`](#update) (the
+  newest release tag, then the Claude Code plugin and the shims). A failure gives a yellow warning
+  naming the command 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.
+  command is 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.
+  then `  agent-toggle update`.
 - 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
@@ -515,6 +519,28 @@ normal HTTP request with the User-Agent `agent-toggle-update-check`. See `SECURI
 for the hardening. To turn it off, set `AGENT_TOGGLE_UPDATE_CHECK=0` or the `update_check` setting
 to off (the settings menu's "Check for updates").
 
+## Update
+
+`agent-toggle update` (or `agent-toggle --update`) is a self-update through
+update-kit (a small stdlib-only helper library): it asks the repository for its newest `vX.Y.Z`
+tag (`git ls-remote --tags`) and always installs that tag with
+`uv tool install --force --no-sources git+<repo>@<tag>` (`pipx install --force` for a pipx install).
+A dev checkout, a branch or commit install, or an unmanaged install is replaced by the tag too
+(with uv, else pipx); only an install made from exactly that tag is already up to date.
+It then runs, with the new binary and in order: 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 failing step prints a warning and makes the exit code `1`.
+It never prompts and writes to stderr only.
+
+| Exit | Meaning |
+|---|---|
+| `0` | updated, or already up to date |
+| `1` | could not check (offline, rate limit) or the install failed |
+| `2` | neither uv nor pipx is found (the manual command is printed) |
+
+On Windows a running `agent-toggle.exe` cannot be replaced, so the install runs detached after
+agent-toggle exits (log in `%USERPROFILE%\.update-kit\`).
+
 ## Help
 
 ```sh

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/agent_toggle.egg-info/requires.txt

@@ -1,4 +1,5 @@
 telegram-kit<0.3,>=0.2.2
+update-kit<0.3,>=0.2.1
 
 [telegram]
 telegram-kit<0.3,>=0.2.2

{agent_toggle-0.14.0 → agent_toggle-0.16.0}/pyproject.toml

@@ -27,7 +27,7 @@ classifiers = [
 ]
 requires-python = ">=3.10"
 # telegram-kit is core (stdlib-only) so a plain reinstall can't drop the Telegram settings
-dependencies = ["telegram-kit>=0.2.2,<0.3"]
+dependencies = ["telegram-kit>=0.2.2,<0.3", "update-kit>=0.2.1,<0.3"]
 
 [project.urls]
 Homepage = "https://github.com/weskao/agent-toggle"