agent-toggle 0.13.1__tar.gz → 0.15.0__tar.gz

{agent_toggle-0.13.1 → agent_toggle-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.13.1
+Version: 0.15.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.2,>=0.1
 Provides-Extra: windows
 Requires-Dist: windows-curses; sys_platform == "win32" and extra == "windows"
 Provides-Extra: telegram
@@ -202,7 +203,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. Exit `0` updated or already current, `1` the check or install failed (offline, rate limit), `2` a dev install (use `git pull`) or an install it cannot manage (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) |
@@ -316,7 +317,7 @@ agent-toggle             # same, on a terminal; elsewhere prints help and exits
   ●   delta                             codex         10 ▏             │ cost       0 now; ~300 tok if restored
                                                                        │ since      2026-09-19 10:00:00
  5 of 5 shown · 2/5
- Space toggle  Enter apply  Esc cancel  ? help  / search  ←→ harness  t type  s sort  p profile  a all
+ Tab toggle  Enter apply  Esc cancel  ? help  / search  ←→ harness  t type  s sort  p profile  a all
 ```
 
 What is on screen:
@@ -344,38 +345,54 @@ What is on screen:
 
 | key | action |
 |---|---|
-| `Space` | toggle the highlighted row (live / parked) and stay on it (while searching, the first `Space` separates search terms and a second one toggles) |
-| `Tab` | toggle the highlighted row and advance to the next |
+| `Tab` | toggle the highlighted row (live / parked) and stay on it, including while searching |
+| `Space` | enter a space in the search (separates search terms) |
 | `Enter` | apply every staged change (with `--dry-run`: show the plan) |
-| `Esc` / `Ctrl-C` | cancel; nothing is applied |
+| `Esc` | leave; if changes are staged, review them in a centered Save changes? dialog |
+| `Ctrl-C` | discard staged changes and leave |
 | `↑` `↓` `PgUp` `PgDn` `Home` `End`, `Ctrl-P` / `Ctrl-N` | move |
-| `/` | start a search; any other non-command letter starts one too. Terms are ANDed, case-insensitive, and match the harness/type/name, the group (`mod` or `mods` finds every mod) and the path; when nothing matches, letters-in-order (fuzzy) is tried: `ctxmd` finds `context-md`, and the bar says `≈ fuzzy match` |
+| `/` | start a search; any letter or digit starts one too. Terms are ANDed, case-insensitive, and match the harness/type/name, the group (`mod` or `mods` finds every mod) and the path; when nothing matches, letters-in-order (fuzzy) is tried: `ctxmd` finds `context-md`, and the bar says `≈ fuzzy match` |
 | `Backspace` / `Ctrl-U` | delete one character / clear the filter |
-| `←` `→` | switch harness tab (also while typing a filter); `0` = All, `1`-`9` = that tab, `h` = next tab |
-| `t` | cycle the type filter |
-| `s` | cycle sort: name, cost (biggest first); applies within each type group |
-| `p` | profiles: stage a saved one, or save the live state (see below) |
+| `←` `→` | switch harness tab (also while typing a filter) |
+| `Ctrl-T` | cycle the type filter |
+| `Ctrl-S` | cycle sort: name, cost (biggest first); applies within each type group |
+| `Ctrl-O` | profiles: stage a saved one, or save the live state (see below) |
 | `?` | show the key list |
-| `a` / `Ctrl-A` | toggle every visible row |
-| `n` | toggle every row on this row's harness with the same name, of any type (skill, command, MCP, ...), shown or filtered out; like `disable all <name>` |
+| `Ctrl-A` | toggle every visible row |
+| `Ctrl-E` | toggle every row on this row's harness with the same name, of any type (skill, command, MCP, ...), shown or filtered out; like `disable all <name>` |
 
-The command keys (`t`, `s`, `p`, `h`, `a`, `n`, `0`-`9`, `?`) act only while no filter is active.
-Press `/` first to type a filter that begins with one of them; once the filter is non-empty,
-every letter just types.
+Commands are `Ctrl` chords, so every letter and digit types into the search, and the chords
+work while a filter is active too. `?` and `/` act only while no filter is active. The picker
+reads keys in raw mode, so `Ctrl-S`, `Ctrl-T` and `Ctrl-O` reach it instead of the terminal
+(flow control, `SIGINFO`, discard).
 
 The start view (sort, harness tab, type filter) comes from the `picker_sort`, `picker_harness`
 and `picker_type` [settings](#settings--config-menu). A profile skips harnesses that are hidden
 and counts those items as `hidden by settings`; `ui --harness <name>` shows that harness even
 when it is switched off.
 
-`p` opens a prompt over the list of saved profiles: type a number or name (or
+`Ctrl-O` opens a prompt over the list of saved profiles: type a number or name (or
 `apply <name>`) and Enter to **stage** that profile's changes (only the items it
 mentions; ones this machine lacks are skipped), then Enter in the picker applies
 them like any other change, so `ui --dry-run` previews a profile and a stray
-`p` changes nothing. `save <name>` writes the live state (not your staged changes) as
+`Ctrl-O` changes nothing. `save <name>` writes the live state (not your staged changes) as
 a profile, with the same name rules and project scope as `profile save`; it is
 off under `--dry-run`. Esc closes the prompt.
 
+The exit dialog lists all staged changes, including rows hidden by a filter. Choose
+**Yes** to apply and leave, or **No** to discard and leave. Use Left/Right
+to select, Enter to confirm, Y/N shortcuts, or click either button (hovering selects it and underlines it). Esc in the
+dialog returns to editing. Up/Down, PgUp/PgDn, Home/End and the mouse wheel scroll
+a long change list. Its height is capped at 80% of the terminal (up to 24 lines,
+with a compact layout on tiny terminals); the confirmation buttons stay visible.
+Up/Down and the mouse wheel move the selected row, just like the main picker;
+the list scrolls when the selection reaches its edge. Tab or a click toggles the
+row's staged enabled/disabled state. The picker stays visible behind the opaque
+dialog; both are painted together in one refresh to prevent background flashes.
+Reverted rows stay in the review so they can be toggled again; Yes applies only
+the remaining changes. The dialog follows the selected language and color mode;
+with `--dry-run`, Yes only shows the plan.
+
 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
@@ -390,7 +407,8 @@ numbers (`1 3 5-7`) to tick or untick, `n <number>` to toggle every type with th
 row's name, `/text` to filter (`/` alone clears it),
 `s` / `h` / `t` to sort and cycle the harness and type filters, `p` to list profiles,
 `p <number|name>` to stage one and `p save <name>` to save the live state, `a` to
-apply, `q` (or end of input) to cancel.
+apply, `q` to review staged changes with a `y/n` save prompt (no changes: exit
+immediately). End of input discards changes.
 
 ### Mods
 
@@ -408,7 +426,7 @@ plugin: it ships skills, commands, agents, MCP servers or hooks and draws nothin
   grep -l modules ~/.claude/plugins/cache/*/*/*/hooks/hooks.json
   ```
 
-- The picker lists mods under **Mods**, right after Plugins. `t` cycles to it, the
+- The picker lists mods under **Mods**, right after Plugins. `Ctrl-T` cycles to it, the
   `picker_type` setting can open on it, and a search for `mod` or `mods` finds every mod.
   The detail pane shows its type as `mod (plugin)`.
 - A mod is still a plugin everywhere else: it toggles through `claude plugin
@@ -470,33 +488,37 @@ invalid value in either is ignored with one warning on stderr.
 - `default_harness` is what `disable` / `enable` act on without `--harness`, even when that
   harness is switched off (with one warning on stderr);
   `disable` / `enable --project` without `--harness` still default to `claude`.
-- `language` translates the config menu, help, update prompt and picker chrome; command output stays English.
+- `language` translates the config menu, help, update messages and picker chrome; command output stays English.
 - telegram-kit is a regular dependency now, so reinstalling keeps the Telegram settings working;
   `agent-toggle[telegram]` still resolves.
 
-## Update check
-
-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.
-
-- **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.
-- **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
-timeout, cached for 10 minutes in `~/.agent-toggle/update-check.json`. Nothing is sent beyond a
-normal HTTP request with the User-Agent `agent-toggle-update-check`. See `SECURITY.md`
-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 when that is newer than the running version it installs it with
+`uv tool install --force --no-sources git+<repo>@<tag>` (`pipx install --force` for a pipx install).
+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` | a dev install (`git pull` instead), or an install kind it cannot manage (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\`).
+
+**The hint.** After a command, on an interactive terminal only (stderr is a TTY, never under
+`--json`, pipes, launchd or timers), agent-toggle prints one stderr line when a newer release
+exists, `agent-toggle vX.Y.Z is available (you have A) — run `agent-toggle update``. The check is
+`git ls-remote` with a 1.5 s timeout, cached for 24 hours (failures too) in
+`~/.update-kit/state.json`. It never changes the exit code or stdout. To turn it off, set
+`AGENT_TOGGLE_UPDATE_CHECK=0` or the `update_check` setting to off (the settings menu's
+"Check for updates").
 
 ## Help
 
@@ -888,7 +910,6 @@ bookkeeping.
 | `parked/<sha8>/` | items parked by `--project` (`<sha8>` = first 8 hex of the SHA-1 of the resolved project dir) |
 | `profiles/` | `<name>.json` profiles (dir `0700`, files `0600`) |
 | `config.json` | [settings](#settings--config-menu) and the Telegram chat id (mode `0600`, atomic write, unknown keys kept) |
-| `update-check.json` | the [update check](#update-check)'s 10-minute cache (mode `0600`, atomic write) |
 
 A killed run loses at most the one item in flight. If that was a flag write or a
 dir move (with its companions), its `pending` record (the full entry, a flag's
@@ -989,20 +1010,20 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   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,
-  `Tab` toggles and moves on; `/` or any other letter starts a search (terms ANDed over
-  `type/name` and the group, letters-in-order if nothing matches; a second `Space` toggles);
-  `s` sorts by name or cost; `n` toggles every type with this row's name (skill, command, MCP,
+  `PgUp` `PgDn` `Home` `End` (also `Ctrl-P` / `Ctrl-N`) move; `Tab` toggles the row
+  and stays on it, including while searching; `/` or any letter starts a search (terms ANDed over
+  `type/name` and the group, letters-in-order if nothing matches; `Space` separates terms);
+  `Ctrl-S` sorts by name or cost; `Ctrl-E` toggles every type with this row's name (skill, command, MCP,
   ...), 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 (/reload-plugins)`,
-  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
+  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `Ctrl-E`, 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`
   until the list arrives, and a spinner beside `working…` while a toggle runs.
-- Not in the pane: harness tabs (claude only), and the `t` `p` `a` keys. Where Claude draws no
+- Not in the pane: harness tabs (claude only), and the `Ctrl-T` `Ctrl-O` `Ctrl-A` keys. Where Claude draws no
   such pane (the mobile app, VS Code) it is a plain list of buttons instead.
 - `/agent-toggle <command> ...` with `disable`, `enable`,
   `undo`, `list`, `status`, `cost` or `doctor` runs the CLI instead of opening the pane and prints

{agent_toggle-0.13.1 → agent_toggle-0.15.0}/README.md

@@ -169,7 +169,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. Exit `0` updated or already current, `1` the check or install failed (offline, rate limit), `2` a dev install (use `git pull`) or an install it cannot manage (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) |
@@ -283,7 +283,7 @@ agent-toggle             # same, on a terminal; elsewhere prints help and exits
   ●   delta                             codex         10 ▏             │ cost       0 now; ~300 tok if restored
                                                                        │ since      2026-09-19 10:00:00
  5 of 5 shown · 2/5
- Space toggle  Enter apply  Esc cancel  ? help  / search  ←→ harness  t type  s sort  p profile  a all
+ Tab toggle  Enter apply  Esc cancel  ? help  / search  ←→ harness  t type  s sort  p profile  a all
 ```
 
 What is on screen:
@@ -311,38 +311,54 @@ What is on screen:
 
 | key | action |
 |---|---|
-| `Space` | toggle the highlighted row (live / parked) and stay on it (while searching, the first `Space` separates search terms and a second one toggles) |
-| `Tab` | toggle the highlighted row and advance to the next |
+| `Tab` | toggle the highlighted row (live / parked) and stay on it, including while searching |
+| `Space` | enter a space in the search (separates search terms) |
 | `Enter` | apply every staged change (with `--dry-run`: show the plan) |
-| `Esc` / `Ctrl-C` | cancel; nothing is applied |
+| `Esc` | leave; if changes are staged, review them in a centered Save changes? dialog |
+| `Ctrl-C` | discard staged changes and leave |
 | `↑` `↓` `PgUp` `PgDn` `Home` `End`, `Ctrl-P` / `Ctrl-N` | move |
-| `/` | start a search; any other non-command letter starts one too. Terms are ANDed, case-insensitive, and match the harness/type/name, the group (`mod` or `mods` finds every mod) and the path; when nothing matches, letters-in-order (fuzzy) is tried: `ctxmd` finds `context-md`, and the bar says `≈ fuzzy match` |
+| `/` | start a search; any letter or digit starts one too. Terms are ANDed, case-insensitive, and match the harness/type/name, the group (`mod` or `mods` finds every mod) and the path; when nothing matches, letters-in-order (fuzzy) is tried: `ctxmd` finds `context-md`, and the bar says `≈ fuzzy match` |
 | `Backspace` / `Ctrl-U` | delete one character / clear the filter |
-| `←` `→` | switch harness tab (also while typing a filter); `0` = All, `1`-`9` = that tab, `h` = next tab |
-| `t` | cycle the type filter |
-| `s` | cycle sort: name, cost (biggest first); applies within each type group |
-| `p` | profiles: stage a saved one, or save the live state (see below) |
+| `←` `→` | switch harness tab (also while typing a filter) |
+| `Ctrl-T` | cycle the type filter |
+| `Ctrl-S` | cycle sort: name, cost (biggest first); applies within each type group |
+| `Ctrl-O` | profiles: stage a saved one, or save the live state (see below) |
 | `?` | show the key list |
-| `a` / `Ctrl-A` | toggle every visible row |
-| `n` | toggle every row on this row's harness with the same name, of any type (skill, command, MCP, ...), shown or filtered out; like `disable all <name>` |
+| `Ctrl-A` | toggle every visible row |
+| `Ctrl-E` | toggle every row on this row's harness with the same name, of any type (skill, command, MCP, ...), shown or filtered out; like `disable all <name>` |
 
-The command keys (`t`, `s`, `p`, `h`, `a`, `n`, `0`-`9`, `?`) act only while no filter is active.
-Press `/` first to type a filter that begins with one of them; once the filter is non-empty,
-every letter just types.
+Commands are `Ctrl` chords, so every letter and digit types into the search, and the chords
+work while a filter is active too. `?` and `/` act only while no filter is active. The picker
+reads keys in raw mode, so `Ctrl-S`, `Ctrl-T` and `Ctrl-O` reach it instead of the terminal
+(flow control, `SIGINFO`, discard).
 
 The start view (sort, harness tab, type filter) comes from the `picker_sort`, `picker_harness`
 and `picker_type` [settings](#settings--config-menu). A profile skips harnesses that are hidden
 and counts those items as `hidden by settings`; `ui --harness <name>` shows that harness even
 when it is switched off.
 
-`p` opens a prompt over the list of saved profiles: type a number or name (or
+`Ctrl-O` opens a prompt over the list of saved profiles: type a number or name (or
 `apply <name>`) and Enter to **stage** that profile's changes (only the items it
 mentions; ones this machine lacks are skipped), then Enter in the picker applies
 them like any other change, so `ui --dry-run` previews a profile and a stray
-`p` changes nothing. `save <name>` writes the live state (not your staged changes) as
+`Ctrl-O` changes nothing. `save <name>` writes the live state (not your staged changes) as
 a profile, with the same name rules and project scope as `profile save`; it is
 off under `--dry-run`. Esc closes the prompt.
 
+The exit dialog lists all staged changes, including rows hidden by a filter. Choose
+**Yes** to apply and leave, or **No** to discard and leave. Use Left/Right
+to select, Enter to confirm, Y/N shortcuts, or click either button (hovering selects it and underlines it). Esc in the
+dialog returns to editing. Up/Down, PgUp/PgDn, Home/End and the mouse wheel scroll
+a long change list. Its height is capped at 80% of the terminal (up to 24 lines,
+with a compact layout on tiny terminals); the confirmation buttons stay visible.
+Up/Down and the mouse wheel move the selected row, just like the main picker;
+the list scrolls when the selection reaches its edge. Tab or a click toggles the
+row's staged enabled/disabled state. The picker stays visible behind the opaque
+dialog; both are painted together in one refresh to prevent background flashes.
+Reverted rows stay in the review so they can be toggled again; Yes applies only
+the remaining changes. The dialog follows the selected language and color mode;
+with `--dry-run`, Yes only shows the plan.
+
 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
@@ -357,7 +373,8 @@ numbers (`1 3 5-7`) to tick or untick, `n <number>` to toggle every type with th
 row's name, `/text` to filter (`/` alone clears it),
 `s` / `h` / `t` to sort and cycle the harness and type filters, `p` to list profiles,
 `p <number|name>` to stage one and `p save <name>` to save the live state, `a` to
-apply, `q` (or end of input) to cancel.
+apply, `q` to review staged changes with a `y/n` save prompt (no changes: exit
+immediately). End of input discards changes.
 
 ### Mods
 
@@ -375,7 +392,7 @@ plugin: it ships skills, commands, agents, MCP servers or hooks and draws nothin
   grep -l modules ~/.claude/plugins/cache/*/*/*/hooks/hooks.json
   ```
 
-- The picker lists mods under **Mods**, right after Plugins. `t` cycles to it, the
+- The picker lists mods under **Mods**, right after Plugins. `Ctrl-T` cycles to it, the
   `picker_type` setting can open on it, and a search for `mod` or `mods` finds every mod.
   The detail pane shows its type as `mod (plugin)`.
 - A mod is still a plugin everywhere else: it toggles through `claude plugin
@@ -437,33 +454,37 @@ invalid value in either is ignored with one warning on stderr.
 - `default_harness` is what `disable` / `enable` act on without `--harness`, even when that
   harness is switched off (with one warning on stderr);
   `disable` / `enable --project` without `--harness` still default to `claude`.
-- `language` translates the config menu, help, update prompt and picker chrome; command output stays English.
+- `language` translates the config menu, help, update messages and picker chrome; command output stays English.
 - telegram-kit is a regular dependency now, so reinstalling keeps the Telegram settings working;
   `agent-toggle[telegram]` still resolves.
 
-## Update check
-
-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.
-
-- **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.
-- **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
-timeout, cached for 10 minutes in `~/.agent-toggle/update-check.json`. Nothing is sent beyond a
-normal HTTP request with the User-Agent `agent-toggle-update-check`. See `SECURITY.md`
-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 when that is newer than the running version it installs it with
+`uv tool install --force --no-sources git+<repo>@<tag>` (`pipx install --force` for a pipx install).
+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` | a dev install (`git pull` instead), or an install kind it cannot manage (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\`).
+
+**The hint.** After a command, on an interactive terminal only (stderr is a TTY, never under
+`--json`, pipes, launchd or timers), agent-toggle prints one stderr line when a newer release
+exists, `agent-toggle vX.Y.Z is available (you have A) — run `agent-toggle update``. The check is
+`git ls-remote` with a 1.5 s timeout, cached for 24 hours (failures too) in
+`~/.update-kit/state.json`. It never changes the exit code or stdout. To turn it off, set
+`AGENT_TOGGLE_UPDATE_CHECK=0` or the `update_check` setting to off (the settings menu's
+"Check for updates").
 
 ## Help
 
@@ -855,7 +876,6 @@ bookkeeping.
 | `parked/<sha8>/` | items parked by `--project` (`<sha8>` = first 8 hex of the SHA-1 of the resolved project dir) |
 | `profiles/` | `<name>.json` profiles (dir `0700`, files `0600`) |
 | `config.json` | [settings](#settings--config-menu) and the Telegram chat id (mode `0600`, atomic write, unknown keys kept) |
-| `update-check.json` | the [update check](#update-check)'s 10-minute cache (mode `0600`, atomic write) |
 
 A killed run loses at most the one item in flight. If that was a flag write or a
 dir move (with its companions), its `pending` record (the full entry, a flag's
@@ -956,20 +976,20 @@ claude --plugin-dir ./mod    # then run /agent-toggle inside Claude
   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,
-  `Tab` toggles and moves on; `/` or any other letter starts a search (terms ANDed over
-  `type/name` and the group, letters-in-order if nothing matches; a second `Space` toggles);
-  `s` sorts by name or cost; `n` toggles every type with this row's name (skill, command, MCP,
+  `PgUp` `PgDn` `Home` `End` (also `Ctrl-P` / `Ctrl-N`) move; `Tab` toggles the row
+  and stays on it, including while searching; `/` or any letter starts a search (terms ANDed over
+  `type/name` and the group, letters-in-order if nothing matches; `Space` separates terms);
+  `Ctrl-S` sorts by name or cost; `Ctrl-E` toggles every type with this row's name (skill, command, MCP,
   ...), 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 (/reload-plugins)`,
-  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `n`, or `❌ [FAILED] disable skill: foo - <error>`.
+  `⛔ [DISABLED] rule: baz (takes effect in a new session)`, `⛔ [DISABLED] all: foo` after `Ctrl-E`, 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`
   until the list arrives, and a spinner beside `working…` while a toggle runs.
-- Not in the pane: harness tabs (claude only), and the `t` `p` `a` keys. Where Claude draws no
+- Not in the pane: harness tabs (claude only), and the `Ctrl-T` `Ctrl-O` `Ctrl-A` keys. Where Claude draws no
   such pane (the mobile app, VS Code) it is a plain list of buttons instead.
 - `/agent-toggle <command> ...` with `disable`, `enable`,
   `undo`, `list`, `status`, `cost` or `doctor` runs the CLI instead of opening the pane and prints

{agent_toggle-0.13.1 → agent_toggle-0.15.0}/agent_toggle/__init__.py

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

{agent_toggle-0.13.1 → agent_toggle-0.15.0}/agent_toggle/cli.py

@@ -36,7 +36,7 @@ Usage:
     failure, 2 usage error, 3 locked, 4 unsupported pair / harness missing.
     Settings: $HOME/.agent-toggle/config.json (see `config`); env overrides
     AGENT_TOGGLE_UPDATE_CHECK / _COLOR / _LANG / _DEFAULT_HARNESS.
-    Update check: on by default, stderr only; AGENT_TOGGLE_UPDATE_CHECK=0 turns it off.
+    Update hint: on by default, a terminal's stderr only; AGENT_TOGGLE_UPDATE_CHECK=0 turns it off.
 """
 from __future__ import annotations
 
@@ -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"),
@@ -723,9 +723,9 @@ def build_parser() -> argparse.ArgumentParser:
 def main(argv: list[str] | None = None) -> int:
     """Run one command and return its exit code (the process exit code).
 
-    Settings apply first; the update check starts before dispatch and is offered in a
-    `finally`, so every way out (a command, --help/--version, a usage error, Locked,
-    CliError) gets it. It writes to stderr only and never changes the exit code."""
+    Settings apply first; the update hint is printed in a `finally`, so every way out
+    (a command, --help/--version, a usage error, Locked, CliError) gets it. It writes
+    to stderr only and never changes the exit code."""
     argv = normalize_argv(sys.argv[1:] if argv is None else argv)
     try:
         language, color = settings.get("language"), settings.get("color")
@@ -734,16 +734,17 @@ 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 "$(...)")
-    started = None if argv[i:i + 1] in (["update"], ["completion"]) else update_prompt.start()
+    hint = True
     try:
         return _main(argv, color)
     except KeyboardInterrupt:
-        started = None                  # never prompt after the user hit Ctrl-C
+        hint = False                    # never ask anything after the user hit Ctrl-C
         raise
     finally:
-        with contextlib.suppress(KeyboardInterrupt):     # Ctrl-C while waiting on the check
-            update_prompt.offer(started, json_mode="--json" in argv, color_mode=color)
+        # `update` is the update; `completion` may run on every shell start (eval "$(...)")
+        if hint and argv[i:i + 1] not in (["update"], ["completion"]):
+            with contextlib.suppress(KeyboardInterrupt):
+                update_prompt.hint(json_mode="--json" in argv)
 
 
 def _main(argv: list[str], color: str) -> int:
@@ -804,7 +805,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.13.1 → agent_toggle-0.15.0}/agent_toggle/help.py

@@ -137,12 +137,13 @@ 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. A dev "
+                                  "install says to git pull (exit 2). Exit 1 when the check or "
+                                  "the install fails."),
+            examples=["update"]),
         "completion": Cmd(
             "completion bash|zsh|fish|powershell",
             t("help.completion.summary", "print the shell completion script"),

{agent_toggle-0.13.1 → agent_toggle-0.15.0}/agent_toggle/locales/zh_tw_cli.py

@@ -27,9 +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.update.summary": "安裝最新版本，並更新外掛與 shim",
+    "help.update.desc": "安裝最新的發行標籤（uv tool / pipx），完成後以新版更新 Claude Code 外掛（若已安裝）"
+                        "並重新安裝 shim。不會提問；`--update` 等同 `update`。開發版安裝請改用 git pull（結束碼 2）。",
     "help.completion.summary": "印出 shell 自動補完腳本",
     "help.completion.desc": "在 stdout 印出某個 shell 的 Tab 補完腳本；"
                             "存到該 shell 載入補完的位置（見 README「Shell completion」）。",
@@ -85,16 +85,4 @@ CATALOG: dict[str, str] = {
     "help.opt.help": "顯示說明（`help <command>` 看單一指令）",
     "help.arguments": "參數",
     "help.options": "選項",
-    # update prompt
-    "update.available": "agent-toggle %s 已推出（目前版本 %s）",
-    "update.keys": "↑↓ 選擇 · ⏎ 確認 · q/Ctrl+C 略過",
-    "update.keys_ascii": "上/下 選擇，Enter 確認，q/Ctrl+C 略過",
-    "update.choose": "請選擇 1-3（Enter = 1，q/Ctrl+C = 略過）：",
-    "update.now": "立即更新",
-    "update.skip": "略過",
-    "update.skip_detail": "下次執行再問",
-    "update.skip_version": "略過到下一個版本",
-    "update.skip_version_detail": "有更新的版本時再問",
-    "update.notes": "版本說明：%s",
-    "update.failed": "更新未完成 — 請自行執行：%s",
 }