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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.9.0
+Version: 0.10.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
@@ -367,7 +369,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`).
@@ -598,7 +601,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 +850,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 +953,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 +964,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 +976,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.10.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
@@ -335,7 +337,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`).
@@ -566,7 +569,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 +818,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 +921,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 +932,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 +944,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.10.0}/agent_toggle/__init__.py

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

{agent_toggle-0.9.0 → agent_toggle-0.10.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.")
 

{agent_toggle-0.9.0 → agent_toggle-0.10.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.10.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 | open | close]"
 ---
 <!-- agent-toggle shim: written by `agent-toggle install-shims`; re-running it overwrites this file -->
 

{agent_toggle-0.9.0 → agent_toggle-0.10.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.10.0}/agent_toggle.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.9.0
+Version: 0.10.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
@@ -367,7 +369,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`).
@@ -598,7 +601,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 +850,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 +953,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 +964,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 +976,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.10.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()