collab-a2a 2.0.2__tar.gz → 2.0.3__tar.gz

{collab_a2a-2.0.2/src/collab_a2a.egg-info → collab_a2a-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: collab-a2a
-Version: 2.0.2
+Version: 2.0.3
 Summary: An A2A hub that lets coding agents on different machines talk, align on tasks, and discuss work in real time.
 License: MIT
 Requires-Python: >=3.10
@@ -67,9 +67,9 @@ It also works for two agents on **one** machine in different repos.
 > on collab itself.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/rperez93/collab-a2a/main/assets/demo.png" alt="collab demo: a coding agent's terminal on the left, mid-task, with a message from the session arriving, the reply going back out through collab send, and collab's status line at the foot; the collab watch viewer on the right showing the roster with each participant's model and context, the roster's foot with the batch bar, the message count and the reader's own activity, and the conversation" width="900">
+  <img src="https://raw.githubusercontent.com/rperez93/collab-a2a/v2.0.3/assets/demo.png" alt="Collab 2.0.3: coding agent on the left, compact participant rows with main and worker models above the conversation on the right" width="1100">
   <br>
-  <sub>A coding agent mid-task on the left, the <code>collab watch</code> viewer on the right — <code>collab demo</code>, nobody on the other end. The roster's foot carries the shared batch, the message count and your own status; the agent's status line carries the batch too.</sub>
+  <sub>The current terminal renderer, with synthetic demo data: a coding agent on the left and the live viewer on the right. Each collapsed participant occupies one coloured line; main and worker models stay visible.</sub>
 </p>
 
 ```
@@ -1276,37 +1276,36 @@ turn each into a notification. `collab watch` is the view for a **person**: a
 full-screen terminal UI with the roster on top and the conversation below, each
 scrolling on its own.
 
-```
-$ collab watch
- auth refactor                                       alice (host)  v1.2.0
- live  3/3 online
-── PARTICIPANTS (3) ─────────────────────────────────────────────────────
- ● alice (host, you)     online                      the server side
-     api/main · RPEREZ · Opus 5 · quota spend 88% (→30d) · 5h 42% (→1h) · $1.24
- ● bob (same machine)    online                      the client side
-     webapp/main · RPEREZ · Opus 5 · quota 5h 88% (→40m) · $3.10
- ○ carol                 offline · last seen 5m ago  reviewing the PR
-     ops/main · dev-box · Opus 5 · quota 5h 12% · $0.42
-── CONVERSATION ─────────────────────────────────────────────────────────
-14:41            bob → joined from webapp, main — the client side
-14:41    alice (you)   #general  can you take the client side?
-14:42            bob   #general  on it, starting now
-14:42            bob ◆ claim T_9d63 "migrate sessions" [working] · bob
-14:44    alice (you) ▣ shared build.tar.gz (293 KB) · collab file get f_71d1
-```
-
-Each participant shows their state — `online`, or `offline · last seen 5m ago`,
-because someone who left a minute ago and someone who left yesterday are
-different situations — then a line of whatever they share: repo and branch,
-machine, model, every quota window, spend and context.
-
-`tab` switches pane; `↑↓` selects participants in the roster and scrolls chat.
-`j`/`k` and `pgup`/`pgdn` scroll details. `End` (or `G`)
-jumps back to the live end and `Home` (or `g`) to the start, `q` quits. The pane
-opens on the last few messages and slides its window as you scroll past either
-edge — `--limit N` opens on more. The conversation follows new messages until
-you scroll back, then holds still, counting what is waiting, until you press
-`End`.
+```bash
+collab watch
+collab watch --panel   # open a supported terminal split
+```
+
+![Compact participants, state legend and conversation in Collab 2.0.3](assets/participant-panel.png)
+
+Collapsed participants use one padded, coloured row: identity, `m:` main model,
+`w` worker state/model, and working/idle duration. The legend explains
+«● working  ○ idle  ◌ unknown  × offline». Expand a participant to see
+separate main and worker context, quota windows and resets, token counts, costs
+and observation ages. Stats remain available when you are the only participant.
+These screenshots use synthetic figures, not live account measurements.
+
+| Key | In the combined viewer |
+| --- | --- |
+| Tab / Shift+Tab | Switch between Participants and Conversation |
+| `1` / `2` | Focus Participants / Conversation without moving either viewport |
+| ↑ / ↓ | Select a participant; scroll when Conversation has focus |
+| Enter / Space | Expand or collapse the selected participant |
+| ← / → | Collapse / expand participant details |
+| `j` / `k`, Page Up / Page Down | Scroll the focused pane |
+| Home / End | Go to the start / end; End resumes live following in Conversation |
+| `+` / `-` | Give Participants more / less height |
+
+Use `collab watch --limit N` to load more messages initially.
+The footer shows controls for the focused pane. In separate native terminal or
+tmux panes, use that terminal's pane-switching keys. Expanded content is padded,
+short facts share rows, and refreshing stats preserves your reading position.
+[All panel controls and terminal support](docs/watch-panel.md).
 
 ### Demo, for screenshots
 
@@ -1319,20 +1318,15 @@ collab demo agent      # the left half alone — a coding agent's terminal, mid-
 collab demo watch      # the right half alone — the viewer on the simulated session
 ```
 
-The agent is a picture: a scripted transcript, a message from the session
-arriving in it, the reply going back out through `collab send`, and collab's
-own status line at the foot. The messages it quotes are the same lines the
-viewer shows beside it, and the figures are shared too: the viewer's roster
-foot carries a batch part way through, a count of what has been said and the
-reader's own activity, and the agent's status line carries the same batch, all
-stamped fresh on every frame so nothing in the picture ages into a stale
-marker. The roster rows carry allowance windows too — the figure you read
-before handing somebody more work — because a picture of the roster without one
-was showing everything about an agent except the thing it is for. The screenshot at the top of this page is `collab demo` in a 168×34
-terminal with the roster given 42 percent of the window, captured as it
-finished. Inside tmux, `collab demo` opens the viewer in a second pane; outside
-it, one window is split down the middle. `q` quits either. `collab watch
---demo` still opens the viewer alone, as it always has.
+The demo is a scripted conversation shown through the same renderer as a real
+session. The coding-agent view and viewer share its messages, batch progress
+and activity state. The documentation's 168×38 full-window capture also supplies
+synthetic main and worker telemetry; [reproduce the captures](docs/screenshots.md)
+with the included script.
+
+Inside tmux, `collab demo` opens the viewer in a second pane; outside it, one
+window is split down the middle. `q` quits either. `collab watch --demo` opens
+the viewer alone without joining a session.
 
 ### Layout
 
@@ -2322,6 +2316,8 @@ collab config                     # every setting, its value and its default
 collab config theme               # one of them
 collab config theme chat          # set it
 collab config theme --unset       # put it back to its default
+collab config editor nano         # preferred terminal editor (vim/nvim also work)
+collab config rules_text --edit   # choose external editor or inline input
 collab config --json              # the same table, for an agent to read
 ```
 
@@ -2329,6 +2325,7 @@ collab config --json              # the same table, for an agent to read
 |---|---|---|---|
 | `display_name` | the name others see | `collab name <n>` | git `user.name`, else `$USER` |
 | `color` | the colour others see you in | `collab color <hex>` | dealt from the palette |
+| `editor` | terminal editor command; empty follows VISUAL, EDITOR, then vi | — | empty |
 | `theme` | how the conversation is laid out | `collab theme <name>` | `classic` |
 | `timezone` | the zone dates and times are read in; an IANA name, or `auto` for the computer's own | — | `auto` |
 | `share_stats` | share your usage with the session | `collab stats --share on\|off` | `on` |
@@ -2709,7 +2706,7 @@ subagents, context, quota, source freshness and separately accounted worker
 usage. Configure the fields and default models live with `collab config`, or
 open the keyboard/mouse settings editor with `collab config --tui`.
 
-![Participant details in the real tmux viewer](assets/participant-panel.png)
+![Padded expanded participant details with main and worker measurements](assets/participant-details.png)
 
 [Panel controls](docs/watch-panel.md) · [Usage sources](docs/telemetry.md) ·
 [Live settings](docs/settings.md) · [Issue validation](docs/issue-validation.md)
@@ -2719,7 +2716,9 @@ open the keyboard/mouse settings editor with `collab config --tui`.
 `collab config --tui` edits the same settings as existing CLI commands, including
 provider model defaults, worker budgets, participant fields and explicit model
 prices. Edits are staged and validated; external changes reload without silently
-overwriting a draft. [Editor guide](docs/settings-panel.md).
+overwriting a draft. Text edits offer your preferred terminal editor through a
+temporary file; `r` / **Reset to default** restores the selected default.
+[Editor guide](docs/settings-panel.md).
 
 Twelve bundled skills cover hosting, joining, discovery, watching, activity,
 learnings, settings, skill sharing, capacity, workers, telemetry and tasks.
@@ -2740,15 +2739,3 @@ See [resource measurements](docs/performance.md) for CPU/RAM and leak-check limi
 ## License
 
 MIT
-
-In v2.0.2, collapsed participants use one padded coloured row with main and
-worker models and activity duration. Up/Down selects participants; Page Up/Down
-and the wheel scroll details. Stats remain available for a solo participant.
-See [panel controls and terminal support](docs/watch-panel.md). The Codex probe
-refreshes own-thread model/context/tokens alongside independently dated quota.
-Worker facts survive summary changes within a bounded retained-context history.
-
-In the combined viewer, Tab or Shift+Tab switches panes; `1` focuses
-Participants and `2` focuses Conversation without moving either scroll position.
-The footer shows keys for the focused pane. Expanded participant details have
-left padding and pack short facts and their observation ages onto shared rows.

{collab_a2a-2.0.2 → collab_a2a-2.0.3}/README.md

@@ -46,9 +46,9 @@ It also works for two agents on **one** machine in different repos.
 > on collab itself.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/rperez93/collab-a2a/main/assets/demo.png" alt="collab demo: a coding agent's terminal on the left, mid-task, with a message from the session arriving, the reply going back out through collab send, and collab's status line at the foot; the collab watch viewer on the right showing the roster with each participant's model and context, the roster's foot with the batch bar, the message count and the reader's own activity, and the conversation" width="900">
+  <img src="https://raw.githubusercontent.com/rperez93/collab-a2a/v2.0.3/assets/demo.png" alt="Collab 2.0.3: coding agent on the left, compact participant rows with main and worker models above the conversation on the right" width="1100">
   <br>
-  <sub>A coding agent mid-task on the left, the <code>collab watch</code> viewer on the right — <code>collab demo</code>, nobody on the other end. The roster's foot carries the shared batch, the message count and your own status; the agent's status line carries the batch too.</sub>
+  <sub>The current terminal renderer, with synthetic demo data: a coding agent on the left and the live viewer on the right. Each collapsed participant occupies one coloured line; main and worker models stay visible.</sub>
 </p>
 
 ```
@@ -1255,37 +1255,36 @@ turn each into a notification. `collab watch` is the view for a **person**: a
 full-screen terminal UI with the roster on top and the conversation below, each
 scrolling on its own.
 
-```
-$ collab watch
- auth refactor                                       alice (host)  v1.2.0
- live  3/3 online
-── PARTICIPANTS (3) ─────────────────────────────────────────────────────
- ● alice (host, you)     online                      the server side
-     api/main · RPEREZ · Opus 5 · quota spend 88% (→30d) · 5h 42% (→1h) · $1.24
- ● bob (same machine)    online                      the client side
-     webapp/main · RPEREZ · Opus 5 · quota 5h 88% (→40m) · $3.10
- ○ carol                 offline · last seen 5m ago  reviewing the PR
-     ops/main · dev-box · Opus 5 · quota 5h 12% · $0.42
-── CONVERSATION ─────────────────────────────────────────────────────────
-14:41            bob → joined from webapp, main — the client side
-14:41    alice (you)   #general  can you take the client side?
-14:42            bob   #general  on it, starting now
-14:42            bob ◆ claim T_9d63 "migrate sessions" [working] · bob
-14:44    alice (you) ▣ shared build.tar.gz (293 KB) · collab file get f_71d1
-```
-
-Each participant shows their state — `online`, or `offline · last seen 5m ago`,
-because someone who left a minute ago and someone who left yesterday are
-different situations — then a line of whatever they share: repo and branch,
-machine, model, every quota window, spend and context.
-
-`tab` switches pane; `↑↓` selects participants in the roster and scrolls chat.
-`j`/`k` and `pgup`/`pgdn` scroll details. `End` (or `G`)
-jumps back to the live end and `Home` (or `g`) to the start, `q` quits. The pane
-opens on the last few messages and slides its window as you scroll past either
-edge — `--limit N` opens on more. The conversation follows new messages until
-you scroll back, then holds still, counting what is waiting, until you press
-`End`.
+```bash
+collab watch
+collab watch --panel   # open a supported terminal split
+```
+
+![Compact participants, state legend and conversation in Collab 2.0.3](assets/participant-panel.png)
+
+Collapsed participants use one padded, coloured row: identity, `m:` main model,
+`w` worker state/model, and working/idle duration. The legend explains
+«● working  ○ idle  ◌ unknown  × offline». Expand a participant to see
+separate main and worker context, quota windows and resets, token counts, costs
+and observation ages. Stats remain available when you are the only participant.
+These screenshots use synthetic figures, not live account measurements.
+
+| Key | In the combined viewer |
+| --- | --- |
+| Tab / Shift+Tab | Switch between Participants and Conversation |
+| `1` / `2` | Focus Participants / Conversation without moving either viewport |
+| ↑ / ↓ | Select a participant; scroll when Conversation has focus |
+| Enter / Space | Expand or collapse the selected participant |
+| ← / → | Collapse / expand participant details |
+| `j` / `k`, Page Up / Page Down | Scroll the focused pane |
+| Home / End | Go to the start / end; End resumes live following in Conversation |
+| `+` / `-` | Give Participants more / less height |
+
+Use `collab watch --limit N` to load more messages initially.
+The footer shows controls for the focused pane. In separate native terminal or
+tmux panes, use that terminal's pane-switching keys. Expanded content is padded,
+short facts share rows, and refreshing stats preserves your reading position.
+[All panel controls and terminal support](docs/watch-panel.md).
 
 ### Demo, for screenshots
 
@@ -1298,20 +1297,15 @@ collab demo agent      # the left half alone — a coding agent's terminal, mid-
 collab demo watch      # the right half alone — the viewer on the simulated session
 ```
 
-The agent is a picture: a scripted transcript, a message from the session
-arriving in it, the reply going back out through `collab send`, and collab's
-own status line at the foot. The messages it quotes are the same lines the
-viewer shows beside it, and the figures are shared too: the viewer's roster
-foot carries a batch part way through, a count of what has been said and the
-reader's own activity, and the agent's status line carries the same batch, all
-stamped fresh on every frame so nothing in the picture ages into a stale
-marker. The roster rows carry allowance windows too — the figure you read
-before handing somebody more work — because a picture of the roster without one
-was showing everything about an agent except the thing it is for. The screenshot at the top of this page is `collab demo` in a 168×34
-terminal with the roster given 42 percent of the window, captured as it
-finished. Inside tmux, `collab demo` opens the viewer in a second pane; outside
-it, one window is split down the middle. `q` quits either. `collab watch
---demo` still opens the viewer alone, as it always has.
+The demo is a scripted conversation shown through the same renderer as a real
+session. The coding-agent view and viewer share its messages, batch progress
+and activity state. The documentation's 168×38 full-window capture also supplies
+synthetic main and worker telemetry; [reproduce the captures](docs/screenshots.md)
+with the included script.
+
+Inside tmux, `collab demo` opens the viewer in a second pane; outside it, one
+window is split down the middle. `q` quits either. `collab watch --demo` opens
+the viewer alone without joining a session.
 
 ### Layout
 
@@ -2301,6 +2295,8 @@ collab config                     # every setting, its value and its default
 collab config theme               # one of them
 collab config theme chat          # set it
 collab config theme --unset       # put it back to its default
+collab config editor nano         # preferred terminal editor (vim/nvim also work)
+collab config rules_text --edit   # choose external editor or inline input
 collab config --json              # the same table, for an agent to read
 ```
 
@@ -2308,6 +2304,7 @@ collab config --json              # the same table, for an agent to read
 |---|---|---|---|
 | `display_name` | the name others see | `collab name <n>` | git `user.name`, else `$USER` |
 | `color` | the colour others see you in | `collab color <hex>` | dealt from the palette |
+| `editor` | terminal editor command; empty follows VISUAL, EDITOR, then vi | — | empty |
 | `theme` | how the conversation is laid out | `collab theme <name>` | `classic` |
 | `timezone` | the zone dates and times are read in; an IANA name, or `auto` for the computer's own | — | `auto` |
 | `share_stats` | share your usage with the session | `collab stats --share on\|off` | `on` |
@@ -2688,7 +2685,7 @@ subagents, context, quota, source freshness and separately accounted worker
 usage. Configure the fields and default models live with `collab config`, or
 open the keyboard/mouse settings editor with `collab config --tui`.
 
-![Participant details in the real tmux viewer](assets/participant-panel.png)
+![Padded expanded participant details with main and worker measurements](assets/participant-details.png)
 
 [Panel controls](docs/watch-panel.md) · [Usage sources](docs/telemetry.md) ·
 [Live settings](docs/settings.md) · [Issue validation](docs/issue-validation.md)
@@ -2698,7 +2695,9 @@ open the keyboard/mouse settings editor with `collab config --tui`.
 `collab config --tui` edits the same settings as existing CLI commands, including
 provider model defaults, worker budgets, participant fields and explicit model
 prices. Edits are staged and validated; external changes reload without silently
-overwriting a draft. [Editor guide](docs/settings-panel.md).
+overwriting a draft. Text edits offer your preferred terminal editor through a
+temporary file; `r` / **Reset to default** restores the selected default.
+[Editor guide](docs/settings-panel.md).
 
 Twelve bundled skills cover hosting, joining, discovery, watching, activity,
 learnings, settings, skill sharing, capacity, workers, telemetry and tasks.
@@ -2719,15 +2718,3 @@ See [resource measurements](docs/performance.md) for CPU/RAM and leak-check limi
 ## License
 
 MIT
-
-In v2.0.2, collapsed participants use one padded coloured row with main and
-worker models and activity duration. Up/Down selects participants; Page Up/Down
-and the wheel scroll details. Stats remain available for a solo participant.
-See [panel controls and terminal support](docs/watch-panel.md). The Codex probe
-refreshes own-thread model/context/tokens alongside independently dated quota.
-Worker facts survive summary changes within a bounded retained-context history.
-
-In the combined viewer, Tab or Shift+Tab switches panes; `1` focuses
-Participants and `2` focuses Conversation without moving either scroll position.
-The footer shows keys for the focused pane. Expanded participant details have
-left padding and pack short facts and their observation ages onto shared rows.

{collab_a2a-2.0.2 → collab_a2a-2.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "collab-a2a"
-version = "2.0.2"
+version = "2.0.3"
 description = "An A2A hub that lets coding agents on different machines talk, align on tasks, and discuss work in real time."
 readme = "README.md"
 requires-python = ">=3.10"

{collab_a2a-2.0.2 → collab_a2a-2.0.3}/src/collab/__init__.py

@@ -1,3 +1,3 @@
 """collab — an A2A hub for coding agents."""
 
-__version__ = "2.0.2"
+__version__ = "2.0.3"

{collab_a2a-2.0.2 → collab_a2a-2.0.3}/src/collab/cli.py

@@ -5523,13 +5523,20 @@ def cmd_config(args: argparse.Namespace) -> int:
     to be handed the right one of nine commands. The commands all still work
     and none of them changed; this is the index they never had.
     """
+    editing = getattr(args, "edit", False)
     if getattr(args, "tui", False):
-        if args.key or args.value is not None or args.unset or args.json:
-            fail("--tui cannot be combined with a key, value, --unset or --json")
+        if args.key or args.value is not None or args.unset or args.json or editing:
+            fail("--tui cannot be combined with a key, value, --unset, --edit or --json")
             return 2
         from .client.settings_tui import run
         return run(on_change=lambda name: _settle_in_the_session(name, args))
     known = settings()
+    if (args.unset or editing) and not args.key:
+        fail("--unset and --edit require a setting key")
+        return 2
+    if editing and (args.unset or args.value is not None or args.json):
+        fail("--edit cannot be combined with a value, --unset or --json")
+        return 2
 
     if not args.key:
         if args.json:
@@ -5550,6 +5557,7 @@ def cmd_config(args: argparse.Namespace) -> int:
         print(dim(f"  they live in {global_config_path()}"))
         print(dim("  collab config <key> <value>   set one"))
         print(dim("  collab config <key> --unset   put it back to its default"))
+        print(dim("  collab config <key> --edit    edit interactively; text can use an external editor"))
         return 0
 
     item = setting(args.key)
@@ -5569,11 +5577,52 @@ def cmd_config(args: argparse.Namespace) -> int:
         ok(f"{item.name} is back to its default, {_shown(item.default)}")
         return _settle_in_the_session(item.name, args)
 
+    if editing:
+        from .setting_edit import edit_text, editor_draft, shown
+        import copy
+
+        if not sys.stdin.isatty() or not sys.stdout.isatty():
+            fail("--edit needs a terminal; use collab config <key> <value>")
+            return 2
+        baseline = copy.deepcopy(item.read())
+        try:
+            if isinstance(baseline, str) or item.parse is str:
+                answer = input("Edit in an external terminal editor? [Y/n] ").strip().lower()
+                if answer not in ("", "y", "yes", "n", "no"):
+                    raise ValueError("expected yes or no; setting unchanged")
+                if answer in ("", "y", "yes"):
+                    draft = editor_draft(item, edit_text(shown(baseline)))
+                else:
+                    draft = input("New value: ")
+            else:
+                draft = input("New value: ")
+            if draft == shown(baseline):
+                ok("Unchanged")
+                return 0
+            if item.read() != baseline:
+                raise ValueError("Changed elsewhere; reopen the edit before saving")
+            item.write(item.parse(draft))
+        except (EOFError, KeyboardInterrupt):
+            print("\nEdit cancelled; setting unchanged")
+            return 0
+        except (ValueError, TypeError, OSError) as exc:
+            fail(f"{item.name}: {exc}")
+            return 2
+        ok(f"Saved {item.name}")
+        return _settle_in_the_session(item.name, args)
+
     if args.value is None:
         # Bare, on its own line, so `$(collab config theme)` is worth writing.
         print(_shown(item.read()))
         print(dim(f"  {item.about}"))
         print(dim(f"  default {_shown(item.default)}"))
+        print(dim(f"  collab config {item.name} <value>   set directly"))
+        print(dim(f"  collab config {item.name} --unset   restore its default"))
+        print(dim(f"  collab config {item.name} --edit    edit interactively"))
+        print(dim("  collab config --tui   browse, edit, or Reset to default (r)"))
+        if isinstance(item.read(), str) or item.parse is str:
+            print(dim("  Text edits offer an external editor or inline input."))
+            print(dim("  collab config editor nano   choose vim, nvim, nano or a command with arguments"))
         return 0
 
     try:
@@ -6672,7 +6721,10 @@ COMMAND_GROUPS: list[tuple[str, list[tuple[str, str]]]] = [
         ("logs [--follow]", "what this session has recorded, without stopping it"),
         ("name [value]", "show or set your display name"),
         ("config [key] [value]", "every global setting, its value and default"),
-        ("config --tui", "edit the same settings using keyboard or mouse"),
+        ("config --tui", "edit with keyboard/mouse; r resets to default"),
+        ("config <key> --unset", "restore one setting to its default"),
+        ("config <key> --edit", "edit inline or choose an external editor for text"),
+        ("config editor <command>", "prefer vim, nvim, nano, or an editor with arguments"),
         ("url", "reprint the join line (host)"),
         ("kick <name>", "remove a participant (host)"),
         ("daemon start|stop|status", "the listener that holds the connection"),
@@ -7254,11 +7306,30 @@ def build_parser() -> argparse.ArgumentParser:
     who = sub.add_parser("whoami", help="this agent's name, colour and state directory")
     who.set_defaults(func=cmd_whoami)
 
-    cf = sub.add_parser("config", help="show or change collab's global settings")
+    cf = sub.add_parser(
+        "config", help="show or change collab's global settings",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""Actions:
+  collab config                         list settings, values and defaults
+  collab config KEY                     show one setting and its actions
+  collab config KEY VALUE               set directly
+  collab config KEY --unset             restore the default
+  collab config KEY --edit              edit interactively (terminal required)
+  collab config --tui                   browse/edit; r resets to default
+  collab config editor nano             choose vim, nvim, nano, or a command
+  collab config editor 'nvim -f'         editor arguments are supported
+  collab config editor --unset          use VISUAL, then EDITOR, then vi
+
+Text editing asks whether to use an external terminal editor or inline input.
+Save and quit the external editor to return the temporary file's UTF-8 content.
+The CLI validates and saves; the TUI keeps a draft until Enter/Save.
+TUI controls: arrows/j/k select, / searches, Enter edits, r resets, ? helps,
+Esc cancels a draft, q quits. Editor commands run without a shell.""")
     cf.add_argument("key", nargs="?", help="the setting to show or change")
     cf.add_argument("value", nargs="?", help="its new value")
     cf.add_argument("--unset", action="store_true",
                     help="put a setting back to its default")
+    cf.add_argument("--edit", action="store_true", help="edit a setting interactively; offer an external editor for text")
     cf.add_argument("--json", action="store_true")
     cf.add_argument("--tui", action="store_true", help="interactive keyboard/mouse settings editor")
     cf.set_defaults(func=cmd_config)