overcode 0.5.1__tar.gz → 0.5.4__tar.gz

overcode-0.5.4/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include src/overcode *.md *.sh *.js *.mjs *.json *.yaml

{overcode-0.5.1/src/overcode.egg-info → overcode-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.5.1
+Version: 0.5.4
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode
@@ -42,7 +42,7 @@ Dynamic: license-file
 
 # overcode
 
-A TUI supervisor for managing multiple coding agents (Claude Code, opencode, Codex, Grok) in tmux.
+A TUI supervisor for managing multiple coding agents (Claude Code, opencode, opencode2, Codex, Grok, Hermes) in tmux.
 
 Launch autonomous coding agents, monitor their progress in real-time, track costs and activity, and coordinate work across your projects—all from a single dashboard.
 
@@ -81,7 +81,7 @@ overcode tmux
 
 This creates a split layout: the overcode dashboard on top, the focused agent's live terminal on the bottom. Navigate agents with `j/k` — the bottom pane follows automatically. Press `Tab` to toggle focus between panes.
 
-**Requirements:** Python 3.12+, tmux, and an agent CLI — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [opencode](https://opencode.ai), [Codex CLI](https://github.com/openai/codex), or [Grok Build](https://x.ai)
+**Requirements:** Python 3.12+, tmux, and an agent CLI — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [opencode](https://opencode.ai) (v1, or the opencode2 2.0 preview), [Codex CLI](https://github.com/openai/codex), [Grok Build](https://x.ai), or [Hermes Agent](https://github.com/NousResearch/hermes-agent)
 
 See the [Getting Started Guide](docs/getting-started.md) for a complete walkthrough.
 
@@ -129,14 +129,15 @@ Run agents in custom environments — containers, VMs, or any setup your project
 See the [Wrappers Guide](docs/wrappers.md) for setup and customisation.
 
 ### Agent Backends
-Overcode is not Claude-Code-only. It supports four agent CLIs today: Claude Code, opencode,
-Codex, and Grok. Launch a non-default one with `overcode launch -n my-agent --backend
-opencode` (or `codex` / `grok`) and it appears in the same dashboard with live hook-grade
-status, previews, AI summaries, send-instruction, restart, kill, resume, fork, and
-token/cost/context columns. Backends declare their capabilities, so the Claude-only
-subsystems — skills, the sandbox badge, the subscription-usage widget, agent teams — are
-hidden rather than shown as misleading zeros. A backend badge column appears only when your
-fleet actually mixes backends, so a Claude-only setup looks exactly as it did. See the
+Overcode is not Claude-Code-only. It supports six agent CLIs today: Claude Code, opencode,
+the opencode2 2.0 preview, Codex, Grok, and Hermes. Launch a non-default one with `overcode launch
+-n my-agent --backend opencode` (or `opencode2` / `codex` / `grok` / `hermes`) and it appears in the
+same dashboard with live hook-grade status, previews, AI summaries, send-instruction, restart,
+kill, resume, and token/cost/context columns (fork where the CLI has one — opencode2's preview
+TUI has no `--fork`, Hermes only branches in-session). Backends declare their capabilities, so
+the Claude-only subsystems — skills, the sandbox badge, the subscription-usage widget, agent
+teams — are hidden rather than shown as misleading zeros. A backend badge column appears only
+when your fleet actually mixes backends, so a Claude-only setup looks exactly as it did. See the
 [Backends Guide](docs/backends.md) for the full support matrix, flag mapping, and current
 limitations.
 

{overcode-0.5.1 → overcode-0.5.4}/README.md

@@ -1,6 +1,6 @@
 # overcode
 
-A TUI supervisor for managing multiple coding agents (Claude Code, opencode, Codex, Grok) in tmux.
+A TUI supervisor for managing multiple coding agents (Claude Code, opencode, opencode2, Codex, Grok, Hermes) in tmux.
 
 Launch autonomous coding agents, monitor their progress in real-time, track costs and activity, and coordinate work across your projects—all from a single dashboard.
 
@@ -39,7 +39,7 @@ overcode tmux
 
 This creates a split layout: the overcode dashboard on top, the focused agent's live terminal on the bottom. Navigate agents with `j/k` — the bottom pane follows automatically. Press `Tab` to toggle focus between panes.
 
-**Requirements:** Python 3.12+, tmux, and an agent CLI — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [opencode](https://opencode.ai), [Codex CLI](https://github.com/openai/codex), or [Grok Build](https://x.ai)
+**Requirements:** Python 3.12+, tmux, and an agent CLI — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [opencode](https://opencode.ai) (v1, or the opencode2 2.0 preview), [Codex CLI](https://github.com/openai/codex), [Grok Build](https://x.ai), or [Hermes Agent](https://github.com/NousResearch/hermes-agent)
 
 See the [Getting Started Guide](docs/getting-started.md) for a complete walkthrough.
 
@@ -87,14 +87,15 @@ Run agents in custom environments — containers, VMs, or any setup your project
 See the [Wrappers Guide](docs/wrappers.md) for setup and customisation.
 
 ### Agent Backends
-Overcode is not Claude-Code-only. It supports four agent CLIs today: Claude Code, opencode,
-Codex, and Grok. Launch a non-default one with `overcode launch -n my-agent --backend
-opencode` (or `codex` / `grok`) and it appears in the same dashboard with live hook-grade
-status, previews, AI summaries, send-instruction, restart, kill, resume, fork, and
-token/cost/context columns. Backends declare their capabilities, so the Claude-only
-subsystems — skills, the sandbox badge, the subscription-usage widget, agent teams — are
-hidden rather than shown as misleading zeros. A backend badge column appears only when your
-fleet actually mixes backends, so a Claude-only setup looks exactly as it did. See the
+Overcode is not Claude-Code-only. It supports six agent CLIs today: Claude Code, opencode,
+the opencode2 2.0 preview, Codex, Grok, and Hermes. Launch a non-default one with `overcode launch
+-n my-agent --backend opencode` (or `opencode2` / `codex` / `grok` / `hermes`) and it appears in the
+same dashboard with live hook-grade status, previews, AI summaries, send-instruction, restart,
+kill, resume, and token/cost/context columns (fork where the CLI has one — opencode2's preview
+TUI has no `--fork`, Hermes only branches in-session). Backends declare their capabilities, so
+the Claude-only subsystems — skills, the sandbox badge, the subscription-usage widget, agent
+teams — are hidden rather than shown as misleading zeros. A backend badge column appears only
+when your fleet actually mixes backends, so a Claude-only setup looks exactly as it did. See the
 [Backends Guide](docs/backends.md) for the full support matrix, flag mapping, and current
 limitations.
 

{overcode-0.5.1 → overcode-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "overcode"
-version = "0.5.1"
+version = "0.5.4"
 description = "A supervisor for managing multiple Claude Code instances in tmux"
 authors = [
     {name = "Mike Bond"}
@@ -61,7 +61,7 @@ export = [
 ]
 
 [project.scripts]
-overcode = "overcode.cli:main"
+overcode = "overcode.entrypoint:main"
 tui-eye = "overcode.testing.tui_eye:main"
 
 [tool.setuptools.packages.find]
@@ -75,7 +75,16 @@ overcode = [
     "web/templates/*.html",
     # Bundled opencode telemetry plugin — copied into a project's
     # .opencode/plugins/ at launch, so it has to ship with the wheel.
+    # v1 is a single .js file; v2 ships a plugin directory (server stub
+    # index.js + TUI entry tui.js + the shared core .mjs it imports).
     "opencode_plugin/*.js",
+    "opencode_plugin/overcode-telemetry-v2/*",
+    # Bundled Hermes telemetry plugin — copied into $HERMES_HOME/plugins/
+    # overcode/ at launch (the .py ships as a module; the manifest must too).
+    "hermes_plugin/*.yaml",
+    # Bundled models.dev snapshot (context windows + list prices, #473) —
+    # refreshed by scripts/refresh_model_metadata.py.
+    "data/*.json",
 ]
 
 [tool.black]

{overcode-0.5.1 → overcode-0.5.4}/src/overcode/backends/__init__.py

@@ -17,15 +17,19 @@ from .base import (
 from .claude_code import ClaudeCodeBackend
 from .codex import CodexBackend
 from .grok import GrokBackend
+from .hermes import HermesBackend
 from .opencode import OpencodeBackend
+from .opencode2 import Opencode2Backend
 
 DEFAULT_BACKEND = "claude-code"
 
 _BACKENDS: Dict[str, AgentBackend] = {
     ClaudeCodeBackend.name: ClaudeCodeBackend(),
     OpencodeBackend.name: OpencodeBackend(),
+    Opencode2Backend.name: Opencode2Backend(),
     CodexBackend.name: CodexBackend(),
     GrokBackend.name: GrokBackend(),
+    HermesBackend.name: HermesBackend(),
 }
 
 
@@ -151,7 +155,9 @@ __all__ = [
     "ClaudeCodeBackend",
     "CodexBackend",
     "GrokBackend",
+    "HermesBackend",
     "OpencodeBackend",
+    "Opencode2Backend",
     "DEFAULT_BACKEND",
     "DialogRule",
     "KeyPress",

{overcode-0.5.1 → overcode-0.5.4}/src/overcode/backends/base.py

@@ -35,6 +35,7 @@ class BackendCapability(Flag):
     HOOK_EVENTS = auto()              # push telemetry (hook-state files) available
     TRANSCRIPT_STATS = auto()         # tokens/cost/context readable from disk
     PERMISSION_INJECTION = auto()     # per-launch permission allowlist
+    AGENT_INJECTION = auto()           # launch-time persona/agent flag (--agent) is honored
     SKILLS = auto()                   # skills/persona file discovery
     SANDBOX_PROBE = auto()
     SUBSCRIPTION_USAGE = auto()
@@ -107,7 +108,7 @@ class LaunchSpec:
 class AgentBackend(Protocol):
     """Adapter for one agent CLI."""
 
-    name: str                       # "claude-code" | "opencode" | "codex" | "grok"
+    name: str                       # "claude-code" | "opencode" | "opencode2" | "codex" | "grok" | "hermes"
     display_name: str
     binary: str                     # for dependency_check + doctor process matching
     version_args: Sequence[str]
@@ -136,6 +137,16 @@ class AgentBackend(Protocol):
     # default documents the fallback, it isn't inherited automatically.)
     fork_prescribes_new_session_id: bool = False
 
+    # Optional. Substrings that identify the agent's live process by argv when
+    # its basename is not distinctive — hermes runs as Hermes's own venv
+    # python (`.../venv/bin/python .../hermes-agent/hermes --cli`), so
+    # matching ``process_basenames`` alone would have to match "python".
+    # ``doctor.find_agent_process`` reads this via ``getattr`` and accepts a
+    # process whose basename is in ``process_basenames`` OR whose argv
+    # contains any marker. Same "not inherited from the Protocol" caveat as
+    # fork_prescribes_new_session_id above.
+    process_argv_markers: Sequence[str] = ()
+
     def build_command(self, spec: LaunchSpec) -> List[str]: ...
 
     def prepare_launch(self, spec: LaunchSpec) -> None:
@@ -165,6 +176,37 @@ class AgentBackend(Protocol):
 
     def prompt_ready_chars(self) -> Set[str]: ...
 
+    def prompt_ready_line(self, line: str) -> bool:
+        """Optional. Is this (ANSI-stripped, whitespace-trimmed) pane line the
+        live, empty input prompt?
+
+        ``launcher._wait_for_prompt`` consults this via ``getattr`` before
+        falling back to an exact match against ``prompt_ready_chars()``. The
+        exact-set form can't express a prompt that is never drawn bare —
+        hermes always follows its glyph with a rotating placeholder hint —
+        so a backend with that shape implements this instead.
+        """
+        ...
+
+    def uninstall_telemetry(self, project_dir: Optional[str] = None) -> Tuple[bool, str]:
+        """Optional. Remove this backend's on-disk telemetry footprint.
+
+        Backs ``overcode hooks uninstall-backend <name>``. Returns ``(ok,
+        message)``: ``ok`` False means the footprint was found but *not*
+        removed (not overcode-managed, or ``project_dir`` was needed and
+        missing) and the CLI exits non-zero. A backend whose telemetry
+        leaves nothing on disk (Claude Code's ``--settings``, codex's ``-c``
+        overrides) returns ``(True, "nothing installed on disk …")``.
+        """
+        ...
+
+    def doctor_findings(self) -> List[str]:
+        """Optional. Fleet-level warnings for ``overcode doctor`` — version
+        outside the tested range, missing auth, stats-store schema drift.
+        Only called when the fleet actually has an agent on this backend.
+        """
+        ...
+
     def status_patterns(self) -> "StatusPatterns": ...
 
     def make_stats_reader(self) -> "StatsReader": ...

{overcode-0.5.1 → overcode-0.5.4}/src/overcode/backends/claude_code.py

@@ -99,6 +99,7 @@ class ClaudeCodeBackend:
         | BackendCapability.HOOK_EVENTS
         | BackendCapability.TRANSCRIPT_STATS
         | BackendCapability.PERMISSION_INJECTION
+        | BackendCapability.AGENT_INJECTION
         | BackendCapability.SKILLS
         | BackendCapability.SANDBOX_PROBE
         | BackendCapability.SUBSCRIPTION_USAGE
@@ -218,7 +219,21 @@ class ClaudeCodeBackend:
 
     def startup_dialog_rules(self) -> List[DialogRule]:
         return [
-            # Trust prompt: default is accept, just Enter
+            # Trust prompt, Claude Code ≥ 2.1.27x (seen live Sep 19 2026,
+            # v2.1.274/278): "Accessing workspace: … ❯ No, exit / Yes, I
+            # trust this folder" — the safe option is preselected and a
+            # bare Enter leaves the dialog up (verified live), so navigate
+            # Down to the trust line first. Listed before the legacy rule
+            # so it wins whenever the "❯ No, exit" cursor line is present.
+            DialogRule(
+                marker="❯ No, exit",
+                presses=[
+                    KeyPress("Down", enter=False, delay_after=0.3),
+                    KeyPress("", enter=True),
+                ],
+                settle_seconds=1.5,
+            ),
+            # Trust prompt, older builds: accept was preselected, just Enter
             DialogRule(
                 marker="I trust this folder",
                 presses=[KeyPress("", enter=True)],
@@ -247,6 +262,10 @@ class ClaudeCodeBackend:
         from ..stats_reader import ClaudeStatsReader
         return ClaudeStatsReader()
 
+    def uninstall_telemetry(self, project_dir: Optional[str] = None) -> Tuple[bool, str]:
+        """Nothing on disk: telemetry rides on per-launch argv (see cli/hooks.py)."""
+        return True, f"nothing installed on disk for this backend ({self.name})"
+
     def health_verdict(self, argv: str) -> Tuple[str, str]:
         """Hooks reach Claude Code only via the injected --settings payload."""
         from ..doctor import VERDICT_MISSING_SETTINGS, VERDICT_OK

{overcode-0.5.1 → overcode-0.5.4}/src/overcode/backends/codex.py

@@ -446,6 +446,23 @@ class CodexBackend:
         # continue"), which persists trust per-path in ~/.codex/config.toml
         # so a revisited directory shows no dialog at all.
         return [
+            # Seen live on codex 0.153.4 (Sep 19 2026) when 0.155.1 was out,
+            # drawn BEFORE the trust dialog:
+            #   ✨ Update available! 0.153.4 -> 0.155.1
+            #   › 1. Update now (runs `npm install -g @openai/codex`)
+            #     2. Skip
+            #     3. Skip until next version
+            #   Press enter to continue
+            # The preselected option runs a global npm install, so a bare
+            # Enter here (or a supervisor's `approve` gesture) would start
+            # upgrading the CLI under the agent. Digits select immediately
+            # in this widget (verified on the trust dialog, same widget):
+            # "2" skips for this launch only and persists nothing.
+            DialogRule(
+                marker="Update available!",
+                presses=[KeyPress("2", enter=False)],
+                settle_seconds=1.5,
+            ),
             DialogRule(
                 marker="Do you trust the contents of this directory?",
                 presses=[KeyPress("", enter=True)],
@@ -489,6 +506,14 @@ class CodexBackend:
             "not fire. Relaunch via `overcode restart` to re-inject."
         )
 
+    def uninstall_telemetry(self, project_dir: Optional[str] = None) -> Tuple[bool, str]:
+        """Nothing on disk: telemetry rides on per-launch argv (see cli/hooks.py)."""
+        return True, f"nothing installed on disk for this backend ({self.name})"
+
+    def doctor_findings(self) -> List[str]:
+        """Fleet-level warnings for ``overcode doctor`` (see cli/doctor.py)."""
+        return version_findings()
+
     def check_binary(self):
         from ..dependency_check import check_agent_cli
         return check_agent_cli(self)

{overcode-0.5.1 → overcode-0.5.4}/src/overcode/backends/grok.py

@@ -508,6 +508,7 @@ class GrokBackend:
         | BackendCapability.FORK
         | BackendCapability.SESSION_ID_PRESCRIPTION
         | BackendCapability.PERMISSION_INJECTION
+        | BackendCapability.AGENT_INJECTION
         | BackendCapability.HOOK_EVENTS
         | BackendCapability.TRANSCRIPT_STATS
     )
@@ -747,6 +748,29 @@ class GrokBackend:
             "restart` to install it."
         )
 
+    def uninstall_telemetry(self, project_dir: Optional[str] = None) -> Tuple[bool, str]:
+        """Remove the global hooks file if it is ours (see cli/hooks.py)."""
+        import json
+
+        path = hooks_file_path()
+        try:
+            existing = json.loads(path.read_text(encoding="utf-8"))
+        except OSError:
+            return True, f"No grok hooks file found at {path}"
+        except (ValueError, TypeError):
+            return False, f"{path} is not valid JSON — leaving it alone"
+        if not _is_ours(existing):
+            return False, f"{path} exists but is not overcode-managed — leaving it alone"
+        try:
+            path.unlink()
+        except OSError as exc:
+            return False, f"could not remove {path}: {exc}"
+        return True, f"Removed {path}"
+
+    def doctor_findings(self) -> List[str]:
+        """Fleet-level warnings for ``overcode doctor`` (see cli/doctor.py)."""
+        return version_findings()
+
     def check_binary(self):
         from ..dependency_check import check_agent_cli
         return check_agent_cli(self)