agent-toggle 0.5.2__tar.gz → 0.6.0__tar.gz

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.5.2
+Version: 0.6.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
@@ -159,7 +159,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `enable --all` | put back **every** disabled item (`--harness H` narrows it, `--project <dir>` takes only that project's) |
 | `undo` | reverse the last logged batch (`--dry-run` shows the plan) |
 | `profile save\|apply\|diff\|list` | named sets of live items; see [Profiles](#profiles) |
-| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting; see [Settings & config menu](#settings--config-menu) |
+| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting and the package version; see [Settings & config menu](#settings--config-menu) |
 | `config test\|sync-ci` | send one Telegram test message / set the GitHub CI secrets; needs the `[telegram]` extra; see [CI notifications](#ci-notifications) |
 | `help [command]` | styled help; `help ui` = `--help ui` = `ui --help`; see [Help](#help) |
 | `doctor` | check each harness layout and `state.json` against disk; exit `1` only on an `error` row; on a terminal, asks y/n per fix it can run itself |
@@ -274,7 +274,8 @@ What is on screen:
 - **Cost column**: estimated startup tokens (chars / 4, about +-25 %) with a colored bar. A parked
   row shows `(N)` in brackets, what restoring it would load. Plugins appear as rows too (via
   `claude plugin list --json`; skipped under `ui --dry-run`, which never shells out).
-- **Detail pane** at 100 columns or wider: harness, type, state, staged, path, cost, since,
+- **Detail pane** at 100 columns or wider: the file's frontmatter `description` (skills,
+  agents, commands, rules), then harness, type, state, staged, path, cost, since,
   mechanism, and what it is shared with.
 - **Search bar** (🔍; plain `/` on terminals that cannot draw emoji: the Linux console, the legacy
   Windows console, non-UTF-8 locales) under the tabs, always visible.
@@ -337,11 +338,12 @@ The chrome (title, tabs, footer, help, detail labels) is translated when `langua
 
 ```sh
 agent-toggle config           # or: agent-toggle --config
-agent-toggle config --json    # every setting with its value and source; the token is masked
+agent-toggle config --json    # every setting with its value and source, plus the package version; the token is masked
 ```
 
-`config` opens the settings menu: curses on a terminal, a numbered list otherwise. Each change
-is saved the moment you make it. On a numbered list, end of input, `q` or an empty line exits `0`
+`config` opens the settings menu: curses on a terminal, a numbered list otherwise. The title
+shows the package version. Each change is saved the moment you make it. On a numbered list,
+end of input, `q` or an empty line exits `0`
 (safe in CI; note it reads piped digits, so an open stdin pipe waits).
 
 | group | rows |

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/README.md

@@ -127,7 +127,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `enable --all` | put back **every** disabled item (`--harness H` narrows it, `--project <dir>` takes only that project's) |
 | `undo` | reverse the last logged batch (`--dry-run` shows the plan) |
 | `profile save\|apply\|diff\|list` | named sets of live items; see [Profiles](#profiles) |
-| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting; see [Settings & config menu](#settings--config-menu) |
+| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting and the package version; see [Settings & config menu](#settings--config-menu) |
 | `config test\|sync-ci` | send one Telegram test message / set the GitHub CI secrets; needs the `[telegram]` extra; see [CI notifications](#ci-notifications) |
 | `help [command]` | styled help; `help ui` = `--help ui` = `ui --help`; see [Help](#help) |
 | `doctor` | check each harness layout and `state.json` against disk; exit `1` only on an `error` row; on a terminal, asks y/n per fix it can run itself |
@@ -242,7 +242,8 @@ What is on screen:
 - **Cost column**: estimated startup tokens (chars / 4, about +-25 %) with a colored bar. A parked
   row shows `(N)` in brackets, what restoring it would load. Plugins appear as rows too (via
   `claude plugin list --json`; skipped under `ui --dry-run`, which never shells out).
-- **Detail pane** at 100 columns or wider: harness, type, state, staged, path, cost, since,
+- **Detail pane** at 100 columns or wider: the file's frontmatter `description` (skills,
+  agents, commands, rules), then harness, type, state, staged, path, cost, since,
   mechanism, and what it is shared with.
 - **Search bar** (🔍; plain `/` on terminals that cannot draw emoji: the Linux console, the legacy
   Windows console, non-UTF-8 locales) under the tabs, always visible.
@@ -305,11 +306,12 @@ The chrome (title, tabs, footer, help, detail labels) is translated when `langua
 
 ```sh
 agent-toggle config           # or: agent-toggle --config
-agent-toggle config --json    # every setting with its value and source; the token is masked
+agent-toggle config --json    # every setting with its value and source, plus the package version; the token is masked
 ```
 
-`config` opens the settings menu: curses on a terminal, a numbered list otherwise. Each change
-is saved the moment you make it. On a numbered list, end of input, `q` or an empty line exits `0`
+`config` opens the settings menu: curses on a terminal, a numbered list otherwise. The title
+shows the package version. Each change is saved the moment you make it. On a numbered list,
+end of input, `q` or an empty line exits `0`
 (safe in CI; note it reads piped digits, so an open stdin pipe waits).
 
 | group | rows |

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/__init__.py

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

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/config.py

@@ -13,7 +13,7 @@ from __future__ import annotations
 import shutil
 import subprocess
 
-from . import settings
+from . import __version__, settings
 from .output import CliError, Result, die
 
 SERVICE = "agent-toggle"
@@ -80,6 +80,7 @@ def show(tk, store, out: Result) -> None:
             text = ("on" if value else "off") if isinstance(value, bool) else str(value)
             out.row(None, "setting", key, "show", "ok", text, value=value,
                     source=settings.source(key))
+    out.row(None, "info", "version", "show", "ok", __version__, value=__version__)
 
 
 def need(tk, store) -> tuple[str, str]:

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/cost.py

@@ -70,6 +70,7 @@ class Item:
     chars: int | None
     basis: str
     shared_with: tuple[str, ...] = ()
+    description: str = ""             # frontmatter description, when the file has one
 
 
 def tokens_of(chars: int) -> int:
@@ -102,24 +103,32 @@ def parse_frontmatter(head: str) -> dict[str, str]:
 
 
 def file_estimate(type_: str, name: str, path: Path | None) -> Estimate:
-    """skill / agent / command / rule from one file (a skill dir -> its SKILL.md)."""
+    """skill / agent / command / rule from one file (a skill dir -> its SKILL.md).
+
+    Returns `(tokens, chars, basis, description)`. Other estimate helpers stay
+    3-tuples; `_fill` only reads the description when a 4th element is present.
+    """
     if path is None:
-        return 0, None, "file not found"
+        return 0, None, "file not found", ""
     if type_ == "skill" and path.is_dir():
         path = path / "SKILL.md"
     try:
         if type_ == "rule":
-            chars = len(read_head(path, RULE_CAP))
-            return tokens_of(chars), chars, f"whole file {chars} chars"
+            head = read_head(path, RULE_CAP)
+            chars = len(head)
+            return (tokens_of(chars), chars, f"whole file {chars} chars",
+                    parse_frontmatter(head).get("description", ""))
         fm = parse_frontmatter(read_head(path, HEAD_CAP))
     except OSError as e:
-        return 0, None, f"unreadable: {e.strerror or e}"
+        return 0, None, f"unreadable: {e.strerror or e}", ""
     vals = {f: fm.get(f, "") for f in FIELDS[type_]}
     if not vals.get("name"):
         vals["name"] = name
     chars = sum(map(len, vals.values()))
     parts = "+".join(f for f, v in vals.items() if v)
-    return tokens_of(chars), chars, f"{parts} {chars} chars" + ("" if fm else " (no frontmatter)")
+    return (tokens_of(chars), chars,
+            f"{parts} {chars} chars" + ("" if fm else " (no frontmatter)"),
+            fm.get("description", ""))
 
 
 def mcp_estimate(harness: str, tools: int | None) -> Estimate:
@@ -222,6 +231,8 @@ def plugin_estimate(root: Path) -> Estimate:
 def _fill(item: Item, est: Estimate) -> None:
     item.tokens, item.would_save = (est[0], 0) if item.enabled else (0, est[0])
     item.chars, item.basis = est[1], est[2]
+    if len(est) > 3:                   # file rows carry the frontmatter description
+        item.description = est[3]
 
 
 def inventory(state: dict, table: dict, warn: Callable[[str], None] = lambda m: None,

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/locales/zh_tw_cli.py

@@ -72,9 +72,9 @@ CATALOG: dict[str, str] = {
     "help.options": "選項",
     # update prompt
     "update.available": "agent-toggle %s 已推出（目前版本 %s）",
-    "update.keys": "↑↓ 選擇 · ⏎ 確認 · q 略過",
-    "update.keys_ascii": "上/下 選擇，Enter 確認，q 略過",
-    "update.choose": "請選擇 1-3（Enter = 1，q = 略過）：",
+    "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": "下次執行再問",

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/locales/zh_tw_config.py

@@ -46,7 +46,7 @@ CATALOG: dict[str, str] = {
     "config.interrupted": "已中斷",
     "config.key_change": "變更",
     "config.key_move": "移動",
-    "config.key_quit": "離開",
+    "config.key_quit": "離開 · 自動儲存",
     "config.key_reset": "重設",
     "config.key_reset_all": "全部重設",
     "config.key_run": "變更/執行",
@@ -66,7 +66,7 @@ CATALOG: dict[str, str] = {
     "config.picker_harness": "預設工具篩選",
     "config.picker_sort": "預設排序",
     "config.picker_type": "預設類型篩選",
-    "config.prompt": "選擇要變更的設定（1-%s，q 離開）：",
+    "config.prompt": "選擇要變更的設定（1-%s）：",
     "config.prompt_chat_id": "Telegram 聊天 ID（Enter 保留，- 清除）：",
     "config.prompt_token": "Telegram 機器人權杖（隱藏輸入；Enter 保留，- 清除）：",
     "config.reset_all_done": "所有設定已重設為預設值",
@@ -75,6 +75,7 @@ CATALOG: dict[str, str] = {
     "config.save_failed": "無法儲存：%s",
     "config.saved": "已儲存",
     "config.saves": "變更即時儲存",
+    "config.status.leave": "q/Ctrl+C 離開 · 自動儲存",
     "config.send_test": "傳送測試訊息",
     "config.shims": "安裝 shim",
     "config.sync_ci": "同步 CI 密鑰",

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/locales/zh_tw_picker.py

@@ -27,10 +27,12 @@ CATALOG: dict[str, str] = {
     "picker.empty": "沒有符合的項目 -- Ctrl-U 清除篩選，Left/Right 換 harness，t 換類型",
     "picker.status.shown": "顯示 %s / %s",
     "picker.status.dry_run": "試跑：Enter 只顯示計畫",
+    "picker.status.leave": "Ctrl+C 離開 · 自動儲存",
     "picker.badge.shared": "+共用",
     # detail pane
     "picker.state.live": "啟用",
     "picker.state.parked": "停用",
+    "picker.d.description": "說明",
     "picker.d.harness": "harness",
     "picker.d.type": "類型",
     "picker.d.state": "狀態",

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/ui/config_menu.py

@@ -326,7 +326,7 @@ def numbered(ctx: Ctx, stdin=None, stdout=None) -> int:
     while True:
         ctx.refresh()
         lw = label_width(40)
-        say([(t("config.title", "agent-toggle config"), "title"), (f"  v{__version__}", "muted")])
+        say([(f"{t('config.title', 'agent-toggle config')}  v{__version__}", "title")])
         n = 0
         for row in ROWS:
             if row.kind == "heading":
@@ -338,7 +338,8 @@ def numbered(ctx: Ctx, stdin=None, stdout=None) -> int:
             say([(f"  {n:>2}. {label}{' ' * (lw - cell_width(label))}  ", "text"),
                  *value_segments(ctx, row, g)])
         say([])
-        stdout.write(theme.encodable(t("config.prompt", "Pick a setting to change (1-%s, q to quit): ",
+        say([(t("config.status.leave", "q/Ctrl+C to leave · auto-save"), "muted")])
+        stdout.write(theme.encodable(t("config.prompt", "Pick a setting to change (1-%s): ",
                                   len(ITEMS)), stdout))
         stdout.flush()
         choice = _read(stdin)
@@ -411,8 +412,8 @@ def screen(ctx: Ctx, cur: int, top: int, h: int, w: int, g: theme.Glyphs,
            msg: Segment = ("", "text"), editing: str | None = None) -> list[list[Segment]]:
     """The whole menu as one segment list per screen line (pure: no curses)."""
     body = max(1, h - 5)
-    lines = [theme.title_bar(t("config.title", "agent-toggle config"),
-                             f"{t('config.saves', 'saves as you go')}  v{__version__}", w, g),
+    lines = [theme.title_bar(f"{t('config.title', 'agent-toggle config')}  v{__version__}",
+                             t("config.saves", "saves as you go"), w, g),
              _rule(g.tl, g.tr, w, g, t("config.more", "%s more", top) if top else "")]
     lw = label_width(max(8, (w - 2) // 2 - 4))
     for i in range(top, min(len(ROWS), top + body)):
@@ -427,7 +428,8 @@ def screen(ctx: Ctx, cur: int, top: int, h: int, w: int, g: theme.Glyphs,
     lines.append(theme.key_chips([
         (arrows[0], t("config.key_move", "move")), (arrows[1], t("config.key_change", "change")),
         (arrows[2], t("config.key_run", "change/run")), ("r", t("config.key_reset", "reset")),
-        ("R", t("config.key_reset_all", "reset all")), ("q", t("config.key_quit", "quit"))], w - 1, g))
+        ("R", t("config.key_reset_all", "reset all")),
+        ("q/Ctrl+C", t("config.key_quit", "to leave · auto-save"))], w - 1, g))
     return lines
 
 

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/ui/model.py

@@ -17,17 +17,19 @@ SORTS = ("name", "cost")
 
 class Row:
     __slots__ = ("harness", "type", "name", "enabled", "staged", "tokens", "would_save",
-                 "shared", "path", "since", "mechanism", "basis")
+                 "shared", "path", "since", "mechanism", "basis", "description")
 
     def __init__(self, harness: str, type_: str, name: str, enabled: bool,
                  tokens: int = 0, would_save: int = 0, shared: tuple[str, ...] = (),
-                 path: str = "", since: str = "", mechanism: str = "", basis: str = ""):
+                 path: str = "", since: str = "", mechanism: str = "", basis: str = "",
+                 description: str = ""):
         self.harness, self.type, self.name = harness, type_, name
         self.enabled = enabled
         self.staged = enabled          # what the user has ticked so far
         self.tokens, self.would_save, self.shared = tokens, would_save, shared
         # detail-pane facts; "" = unknown (a plugin has no path, a live row no `since`)
         self.path, self.since, self.mechanism, self.basis = path, since, mechanism, basis
+        self.description = description
 
     @property
     def changed(self) -> bool:
@@ -68,7 +70,8 @@ def collect(state: dict, harnesses: dict, warn=lambda m: None,
         else:
             path = e.get("parked_at") or e.get("backup") or ""
         rows.append(Row(i.harness, i.type, i.name, i.enabled, i.tokens, i.would_save,
-                        i.shared_with, str(path), str(e.get("at") or ""), str(mech), i.basis))
+                        i.shared_with, str(path), str(e.get("at") or ""), str(mech), i.basis,
+                        i.description))
     rows.sort(key=lambda r: (r.harness, r.type, r.name))
     return rows
 

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/ui/picker.py

@@ -95,6 +95,39 @@ def pad(text: str, cells: int) -> str:
     return text + " " * max(0, cells - theme.cell_width(text))
 
 
+def wrap_cells(text: str, width: int) -> list[str]:
+    """Wrap `text` on spaces into lines of at most `width` terminal cells.
+
+    A word wider than `width` is cut. Path fields still slice by character
+    because a path is one token."""
+    width = max(1, width)
+    lines: list[str] = []
+    cur = ""
+    for word in text.split():
+        if not cur:
+            cur = word
+        elif theme.cell_width(f"{cur} {word}") <= width:
+            cur = f"{cur} {word}"
+        else:
+            lines.append(cur)
+            cur = word
+    if cur:
+        lines.append(cur)
+    out: list[str] = []
+    for line in lines or [""]:
+        while theme.cell_width(line) > width:
+            cut = theme.truncate(line, width)
+            if not cut or cut == line:        # a single cell wider than `width`
+                out.append(line)
+                line = ""
+                break
+            out.append(cut)
+            line = line[len(cut):]
+        if line:
+            out.append(line)
+    return out or [""]
+
+
 def _sep(g: theme.Glyphs) -> str:
     return " · " if g.unicode else " | "
 
@@ -170,7 +203,7 @@ def heading(type_: str, count: int, width: int, g: theme.Glyphs) -> list[theme.S
 
 def detail_lines(r: Row, width: int, g: theme.Glyphs) -> list[list[theme.Segment]]:
     """The detail pane for the cursor row: one segment list per screen line."""
-    lab = 11
+    lab = 12                                 # "description" is 11 cells; leave a gap
     val = max(1, width - lab)
     out = [[(theme.truncate(r.name, width, g.ellipsis), "title")], []]
 
@@ -178,6 +211,13 @@ def detail_lines(r: Row, width: int, g: theme.Glyphs) -> list[list[theme.Segment
         for n in range(0, max(1, len(text)), val):          # a long path wraps
             out.append([(pad(label if n == 0 else "", lab), "muted"), (text[n:n + val], role)])
 
+    if r.description:                        # frontmatter prose, not a path
+        chunks = wrap_cells(r.description, val)
+        label = t("picker.d.description", "description")
+        for n, chunk in enumerate(chunks):
+            out.append([(pad(label if n == 0 else "", lab), "muted"), (chunk, "text")])
+        out.append([])
+
     state = t("picker.state.live", "live") if r.enabled else t("picker.state.parked", "parked")
     field(t("picker.d.harness", "harness"), r.harness, theme.harness_role(r.harness))
     field(t("picker.d.type", "type"), r.type, "type")
@@ -250,7 +290,7 @@ def draw(win, v: View, shown: list[Row], pal: theme.Palette, g: theme.Glyphs,
     if end + theme.cell_width(right) + 2 <= w:
         put(2, [(right, "muted")], w - theme.cell_width(right))
 
-    body = max(0, h - BODY_TOP - 2)                  # 0 on a tiny window: status + keys only
+    body = max(0, h - BODY_TOP - 3)                  # 0 on a tiny window: footer only
     v.page = max(1, body)                            # draw owns the page size and scroll
     dw = min(48, w * 2 // 5) if w >= DETAIL_MIN else 0
     lw = w - dw - (1 if dw else 0)
@@ -288,14 +328,15 @@ def draw(win, v: View, shown: list[Row], pal: theme.Palette, g: theme.Glyphs,
                 lw)
 
     if v.note:                                       # last profile result, until the next key
-        put(h - 2, [(" " + v.note, "error" if v.note.startswith("error") else "accent")])
+        put(h - 3, [(" " + v.note, "error" if v.note.startswith("error") else "accent")])
     else:
         status = t("picker.status.shown", "%s of %s shown", len(shown), len(v.rows))
         if shown:
             status += f"{_sep(g)}{v.cur + 1}/{len(shown)}"
         if dry_run:
             status += _sep(g) + t("picker.status.dry_run", "dry run: Enter only shows the plan")
-        put(h - 2, [(" " + status, "muted")])
+        put(h - 3, [(" " + status, "muted")])
+    put(h - 2, [(" " + t("picker.status.leave", "Ctrl+C to leave · auto-save"), "muted")])
     put(h - 1, [(" ", "text"), *theme.key_chips(chips(v, g), w - 2, g)])
     win.refresh()
 

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle/update_prompt.py

@@ -87,8 +87,8 @@ def _lines(found: update_check.UpdateAvailable, selected: int, color: bool,
         label += " " * (width - theme.cell_width(name))
         lines.append("  " + theme.ansi("cursor" if on else "text", label, color)
                      + "  " + theme.ansi("muted", detail, color))
-    keys = (t("update.keys", "↑↓ select · ⏎ confirm · q skip") if g.unicode
-            else t("update.keys_ascii", "up/down select, enter confirm, q skip"))
+    keys = (t("update.keys", "↑↓ select · ⏎ confirm · q/Ctrl+C skip") if g.unicode
+            else t("update.keys_ascii", "up/down select, enter confirm, q/Ctrl+C skip"))
     lines += ["  " + t("update.notes", "Release notes: %s", RELEASE_NOTES % _clean(found.latest).removeprefix("v")),
               "  " + theme.ansi("muted", keys, color)]
     return lines
@@ -137,7 +137,7 @@ def _posix_keys(fd: int) -> Iterator[str]:
 
 def _typed_keys(stream, out) -> Iterator[str]:
     """The numbered fallback: one typed line per answer ('' = the highlighted row)."""
-    out.write(t("update.choose", "Choose 1-3 (Enter = 1, q = skip): "))
+    out.write(t("update.choose", "Choose 1-3 (Enter = 1, q/Ctrl+C = skip): "))
     out.flush()
     line = stream.readline()
     if not line:

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/agent_toggle.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toggle
-Version: 0.5.2
+Version: 0.6.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
@@ -159,7 +159,7 @@ agent-toggle <command> [args]          # or: python3 agent_toggle.py <command> [
 | `enable --all` | put back **every** disabled item (`--harness H` narrows it, `--project <dir>` takes only that project's) |
 | `undo` | reverse the last logged batch (`--dry-run` shows the plan) |
 | `profile save\|apply\|diff\|list` | named sets of live items; see [Profiles](#profiles) |
-| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting; see [Settings & config menu](#settings--config-menu) |
+| `config` | settings menu (curses, else a numbered list); `config --json` lists every setting and the package version; see [Settings & config menu](#settings--config-menu) |
 | `config test\|sync-ci` | send one Telegram test message / set the GitHub CI secrets; needs the `[telegram]` extra; see [CI notifications](#ci-notifications) |
 | `help [command]` | styled help; `help ui` = `--help ui` = `ui --help`; see [Help](#help) |
 | `doctor` | check each harness layout and `state.json` against disk; exit `1` only on an `error` row; on a terminal, asks y/n per fix it can run itself |
@@ -274,7 +274,8 @@ What is on screen:
 - **Cost column**: estimated startup tokens (chars / 4, about +-25 %) with a colored bar. A parked
   row shows `(N)` in brackets, what restoring it would load. Plugins appear as rows too (via
   `claude plugin list --json`; skipped under `ui --dry-run`, which never shells out).
-- **Detail pane** at 100 columns or wider: harness, type, state, staged, path, cost, since,
+- **Detail pane** at 100 columns or wider: the file's frontmatter `description` (skills,
+  agents, commands, rules), then harness, type, state, staged, path, cost, since,
   mechanism, and what it is shared with.
 - **Search bar** (🔍; plain `/` on terminals that cannot draw emoji: the Linux console, the legacy
   Windows console, non-UTF-8 locales) under the tabs, always visible.
@@ -337,11 +338,12 @@ The chrome (title, tabs, footer, help, detail labels) is translated when `langua
 
 ```sh
 agent-toggle config           # or: agent-toggle --config
-agent-toggle config --json    # every setting with its value and source; the token is masked
+agent-toggle config --json    # every setting with its value and source, plus the package version; the token is masked
 ```
 
-`config` opens the settings menu: curses on a terminal, a numbered list otherwise. Each change
-is saved the moment you make it. On a numbered list, end of input, `q` or an empty line exits `0`
+`config` opens the settings menu: curses on a terminal, a numbered list otherwise. The title
+shows the package version. Each change is saved the moment you make it. On a numbered list,
+end of input, `q` or an empty line exits `0`
 (safe in CI; note it reads piped digits, so an open stdin pipe waits).
 
 | group | rows |

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_cli.py

@@ -255,7 +255,7 @@ class UpdateCheckTest(CliCase):
         for part in ("✨ " + HINT, "› 1) Update now", "uv tool upgrade agent-toggle",
                      "ask again next run", "3) Skip until next version",
                      "Release notes: https://github.com/weskao/agent-toggle/releases/tag/v99.0.0",
-                     "↑↓ select · ⏎ confirm · q skip"):
+                     "↑↓ select · ⏎ confirm · q/Ctrl+C skip"):
             self.assertIn(part, text)
 
 

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_cli_surface.py

@@ -307,7 +307,7 @@ class SpellingTest(CliCase):
         # v0.3.0-v0.5.0 shipped with __version__ still at 0.2.0; ahead is fine (bumped, unreleased)
         changelog = Path(__file__).resolve().parents[1] / "CHANGELOG.md"
         top = next(line for line in changelog.read_text(encoding="utf-8").splitlines()
-                   if line.startswith("## ["))
+                   if line.startswith("## [") and "Unreleased" not in line)
         released = top[4:top.index("]")]
         as_tuple = lambda v: tuple(int(p) for p in v.split("."))  # noqa: E731
         self.assertGreaterEqual(as_tuple(__version__), as_tuple(released), top)

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_config.py

@@ -13,7 +13,7 @@ from unittest import mock
 
 from test_cli_surface import CliCase
 
-from agent_toggle import config, settings
+from agent_toggle import __version__, config, settings
 from agent_toggle.ui import config_menu
 
 
@@ -130,11 +130,19 @@ class ConfigTest(CliCase):
         self.assertEqual(rc, 0)
         names = [r["name"] for r in env["results"] if r["type"] == "setting"]
         self.assertEqual(names, [k for k in settings.DEFAULTS if k != config.CHAT_KEY])
-        sources = {r["name"]: r["source"] for r in env["results"][2:]}
+        sources = {r["name"]: r["source"] for r in env["results"] if r["type"] == "setting"}
         # tests/base.py sets AGENT_TOGGLE_UPDATE_CHECK=0 for the whole run
         self.assertEqual(sources.pop("update_check"), "env")
         self.assertEqual(set(sources.values()), {"default"})
 
+    def test_json_includes_the_package_version(self) -> None:
+        rc, env = self.run_json("config")
+        self.assertEqual(rc, 0)
+        row = next(r for r in env["results"] if r["name"] == "version")
+        self.assertEqual((row["type"], row["action"], row["status"], row["detail"]),
+                         ("info", "show", "ok", __version__))
+        self.assertEqual(row["value"], __version__)
+
     def test_test_message_needs_both_values_and_reports_delivery(self) -> None:
         self.assertEqual(self.run_cli("config", "test")[0], 2)
         self.interactive("-100123")

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_config_menu.py

@@ -106,11 +106,20 @@ class CursesMenuTest(MenuCase):
         text = win.text()
         for want in ("agent-toggle config", f"v{__version__}", "saves as you go", "General", "Harnesses",
                      "Picker", "Notifications", "Tools", "Check for updates", "Sync CI secrets",
-                     "› Check for updates", "╭", "╰", "↑↓ move", "R reset all", "q quit",
+                     "› Check for updates", "╭", "╰", "↑↓ move", "R reset all",
                      "found ~/.claude", "not on this machine"):
             self.assertIn(want, text)
-        # the help line shows the selected row's help
-        self.assertIn("look for a newer agent-toggle", text)
+        self.assertNotIn("q quit", text)
+        keys = next(ln for ln in text.splitlines() if "↑↓ move" in ln)
+        self.assertIn("q/Ctrl+C to leave · auto-save", keys)
+        help_line = next(ln for ln in text.splitlines() if "look for a newer agent-toggle" in ln)
+        self.assertNotIn("q/Ctrl+C", help_line)
+
+    def test_title_puts_version_next_to_the_name(self) -> None:
+        win, _ = self.menu(["q"])
+        first = win.text().splitlines()[0]
+        self.assertIn(f"agent-toggle config  v{__version__}", first)
+        self.assertLess(first.index(f"v{__version__}"), first.index("saves as you go"))
 
     def test_toggle_update_check_saves_at_once(self) -> None:
         win, _ = self.menu(["\n", "q"])
@@ -171,8 +180,11 @@ class CursesMenuTest(MenuCase):
         self.assertEqual(i18n.LANGUAGE, "zh-TW")
         self.assertEqual(self.file()["language"], "zh-TW")
         last = win.text()
-        for want in ("繁體中文", "一般", "檢查更新", "變更即時儲存", "離開"):
+        for want in ("繁體中文", "一般", "檢查更新", "變更即時儲存"):
             self.assertIn(want, last)
+        keys = next(ln for ln in last.splitlines() if "↑↓ 移動" in ln)
+        self.assertIn("q/Ctrl+C 離開 · 自動儲存", keys)
+        self.assertNotIn("q 離開", last)
         self.assertNotIn("Check for updates", last)
 
     def test_env_override_is_tagged(self) -> None:
@@ -306,10 +318,15 @@ class NumberedTest(MenuCase):
         rc = cm.numbered(self.ctx(telegram), io.StringIO(text), out)
         return rc, out.getvalue()
 
+    def test_title_shows_the_package_version(self) -> None:
+        _, out = self.run_numbered("q\n")
+        self.assertIn(f"agent-toggle config  v{__version__}", out.splitlines()[0])
+
     def test_digits_toggle_and_cycle_then_eof_quits(self) -> None:
         rc, out = self.run_numbered(f"1\n{number('Color')}\n")
         self.assertEqual(rc, 0)
-        self.assertIn(f"Pick a setting to change (1-{len(cm.ITEMS)}, q to quit): ", out)
+        self.assertIn(f"Pick a setting to change (1-{len(cm.ITEMS)}): ", out)
+        self.assertIn("q/Ctrl+C to leave · auto-save", out)
         self.assertIn(" 1. Check for updates", out)
         self.assertIs(settings.get("update_check"), False)
         self.assertEqual(settings.get("color"), "always")

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_cost.py

@@ -26,14 +26,15 @@ class EstimatorTest(CliCase):
 
     def test_skill_counts_name_and_description_not_the_body(self) -> None:
         tokens, chars, basis = self.est(
-            "skill", "skills/s/SKILL.md", FM.format(n="abcd", d="x" * 96, body="B" * 50000))
+            "skill", "skills/s/SKILL.md", FM.format(n="abcd", d="x" * 96, body="B" * 50000))[:3]
         self.assertEqual((tokens, chars), (25, 100))
         self.assertIn("name+description 100 chars", basis)
 
     def test_folded_description_and_missing_frontmatter(self) -> None:
         folded = "---\nname: f\ndescription: >\n  one two\n  three\n---\n"
         self.assertEqual(self.est("skill", "skills/f/SKILL.md", folded)[1], len("f") + len("one two three"))
-        tokens, chars, basis = self.est("skill", "skills/g/SKILL.md", "# no frontmatter", name="gname")
+        tokens, chars, basis = self.est(
+            "skill", "skills/g/SKILL.md", "# no frontmatter", name="gname")[:3]
         self.assertEqual(chars, len("gname"))
         self.assertIn("no frontmatter", basis)
 

{agent_toggle-0.5.2 → agent_toggle-0.6.0}/tests/test_picker.py

@@ -107,6 +107,28 @@ class PickerTest(SandboxCase):
         # name (3) + description (396) = 399 chars -> 100 tokens
         self.assertEqual(rows["big"].tokens, 100)
 
+    def test_collect_carries_the_frontmatter_description(self) -> None:
+        self.write("skills/solo/SKILL.md",
+                   "---\nname: solo\ndescription: park a skill without deleting it\n---\nbody\n")
+        self.write("commands/go.md", "---\ndescription: run the go helper\n---\n")
+        self.write("agents/helper.md", "---\nname: helper\ndescription: >\n  one two\n  three\n---\n")
+        self.write("skills/bare/SKILL.md", "# no frontmatter\n")
+        self.write("rules/note.md", "---\ndescription: always on note\n---\nbody\n")
+        park = self.tmp / "parked-skill"
+        park.mkdir()
+        (park / "SKILL.md").write_text(
+            "---\ndescription: parked copy of the skill\n---\n", encoding="utf-8")
+        state = {"disabled": {"claude:skill:parked-skill": {
+            "harness": "claude", "type": "skill", "name": "parked-skill",
+            "parked_at": str(park)}}}
+        rows = {r.name: r for r in model.collect(state, build(self.tmp))}
+        self.assertEqual(rows["solo"].description, "park a skill without deleting it")
+        self.assertEqual(rows["go"].description, "run the go helper")
+        self.assertEqual(rows["helper"].description, "one two three")
+        self.assertEqual(rows["bare"].description, "")
+        self.assertEqual(rows["note"].description, "always on note")
+        self.assertEqual(rows["parked-skill"].description, "parked copy of the skill")
+
     def test_visible_filters_and_sorts(self) -> None:
         rows = [model.Row("claude", "skill", "a", True, 5),
                 model.Row("codex", "skill", "b", True, 50, shared=("opencode",)),
@@ -378,7 +400,7 @@ class KeysTest(ScreenCase):
         C = picker.curses
         _, win = self.run_keys([C.KEY_NPAGE, "\x1b"], rows=rows, size=(12, 80))
         cursor = next(line for line in win.screen if line.startswith("›"))
-        self.assertIn("s07", cursor)                         # 7-line body: one page down
+        self.assertIn("s06", cursor)                         # 6-line body: one page down
         self.assertNotIn("s00", win.text())
         out, win = self.run_keys([C.KEY_END, " ", "\n"], rows=rows, size=(12, 80))
         self.assertEqual([r.name for r in out], ["last"])
@@ -401,7 +423,7 @@ class KeysTest(ScreenCase):
     def test_a_tiny_window_keeps_status_and_keys(self) -> None:
         out, win = self.run_keys([" ", "\n"], size=(5, 40))
         self.assertEqual([r.name for r in out], ["alpha"])
-        self.assertIn("of 5 shown", win.frames[0][-2])
+        self.assertIn("of 5 shown", win.frames[0][-3])
         self.assertIn("Space toggle", win.frames[0][-1])
 
     def test_resize_redraws_at_the_new_size(self) -> None:
@@ -420,6 +442,38 @@ class LayoutTest(ScreenCase):
         self.assertIn("5 resources · ~6.3k tok live", win.frames[0][0])
         self.assertIn("1 staged (-1.2k tok)", win.screen[0])
 
+    def test_status_line_says_ctrl_c_leaves_and_auto_saves(self) -> None:
+        _, win = self.run_keys(["\x1b"])
+        self.assertEqual(win.screen[-3].strip(), "5 of 5 shown · 1/5")
+        self.assertEqual(win.screen[-2].strip(), "Ctrl+C to leave · auto-save")
+
+    def test_detail_pane_shows_the_description(self) -> None:
+        text = "park a skill without deleting it"
+        rows = [model.Row("claude", "skill", "solo", True, description=text)]
+        _, win = self.run_keys(["\x1b"], rows=rows, size=(24, 120))
+        pane = "\n".join(line[72:] for line in win.screen)
+        self.assertIn("description", pane)
+        self.assertIn(text, pane)
+        bare = [model.Row("claude", "mcp", "srv", True)]
+        _, win = self.run_keys(["\x1b"], rows=bare, size=(24, 120))
+        self.assertNotIn("description", "\n".join(line[72:] for line in win.screen))
+
+    def test_detail_pane_wraps_the_description_on_words(self) -> None:
+        r = model.Row("claude", "skill", "solo", True, description="alpha beta gamma delta")
+        lines = picker.detail_lines(r, 23, theme.ASCII)
+        body = ["".join(s for s, role in line if role == "text").strip() for line in lines]
+        self.assertIn("alpha beta", body)
+        self.assertIn("gamma delta", body)
+
+    def test_detail_pane_description_is_translated(self) -> None:
+        self.addCleanup(i18n.set_language, i18n.LANGUAGE)
+        i18n.set_language("zh-TW")
+        rows = [model.Row("claude", "skill", "solo", True, description="park a skill")]
+        _, win = self.run_keys(["\x1b"], rows=rows, size=(24, 120))
+        pane = "\n".join(line[72:] for line in win.screen)
+        self.assertIn("說明", pane)
+        self.assertIn("park a skill", pane)
+
     def test_detail_pane_shows_at_wide_widths_only(self) -> None:
         down = picker.curses.KEY_DOWN
         _, win = self.run_keys([down, "\x1b"], size=(24, 120))
@@ -451,7 +505,7 @@ class LayoutTest(ScreenCase):
     def test_empty_result_says_how_to_get_back(self) -> None:
         _, win = self.run_keys(["/", "q", "q", "\x1b"])
         self.assertIn("nothing matches", win.text())
-        self.assertIn("0 of 5 shown", win.screen[-2])
+        self.assertIn("0 of 5 shown", win.screen[-3])
         # with the detail pane, the message is cut at the list's edge, not drawn under the pane
         _, win = self.run_keys(["/", "q", "q", "\x1b"], size=(24, 120))
         line = win.screen[3]
@@ -466,7 +520,7 @@ class LayoutTest(ScreenCase):
 
     def test_dry_run_is_announced(self) -> None:
         _, win = self.run_keys(["\x1b"], dry_run=True)
-        self.assertIn("dry run", win.screen[-2])
+        self.assertIn("dry run", win.screen[-3])
 
     def test_mono_draw_uses_attributes_only(self) -> None:
         _, win = self.run_keys(["\x1b"], size=(24, 90))
@@ -510,6 +564,7 @@ class LayoutTest(ScreenCase):
         _, win = self.run_keys(["\x1b"], size=(24, 100))
         self.assertIn("技能", win.text())
         self.assertIn("全部", win.screen[1])
+        self.assertIn("Ctrl+C 離開 · 自動儲存", win.screen[-2])
 
 
 class SettingsTest(ScreenCase):
@@ -655,7 +710,7 @@ class ProfileKeyTest(SandboxCase):
         everything = "\n".join(win.text(i) for i in range(len(win.frames)))
         self.assertIn("profile> work", everything)
         self.assertIn("1) work", everything)
-        self.assertIn("profile work: 1 staged", win.screen[-2])
+        self.assertIn("profile work: 1 staged", win.screen[-3])
         # Esc at the prompt stages nothing (even a full valid name) and the picker carries on
         self.rows[0].staged = True
         self.assertEqual(picker.loop(FakeWin(["p", *"work", "\x1b", "\n"], size=(12, 70)),