overcode 0.5.4__tar.gz → 0.5.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.5.4
+Version: 0.5.6
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode
@@ -176,7 +176,7 @@ See the [TUI Guide](docs/tui-guide.md) for all keyboard shortcuts.
 - [TUI Guide](docs/tui-guide.md) - Keyboard shortcuts and display modes
 - [Configuration](docs/configuration.md) - Config file and environment variables
 - [Wrappers](docs/wrappers.md) - Run agents in containers and custom environments
-- [Advanced Features](docs/advanced-features.md) - Sleep mode, handover, remote monitoring
+- [Advanced Features](docs/advanced-features.md) - Sleep mode, remote monitoring
 
 ## Testing
 

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

@@ -134,7 +134,7 @@ See the [TUI Guide](docs/tui-guide.md) for all keyboard shortcuts.
 - [TUI Guide](docs/tui-guide.md) - Keyboard shortcuts and display modes
 - [Configuration](docs/configuration.md) - Config file and environment variables
 - [Wrappers](docs/wrappers.md) - Run agents in containers and custom environments
-- [Advanced Features](docs/advanced-features.md) - Sleep mode, handover, remote monitoring
+- [Advanced Features](docs/advanced-features.md) - Sleep mode, remote monitoring
 
 ## Testing
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "overcode"
-version = "0.5.4"
+version = "0.5.6"
 description = "A supervisor for managing multiple Claude Code instances in tmux"
 authors = [
     {name = "Mike Bond"}

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/backends/opencode.py

@@ -14,7 +14,10 @@ remains the fallback for a launch where the plugin could not be installed.
 Everything below the flag table was captured from a real opencode
 v1.18.19 session; the pane corpus lives in
 ``tests/fixtures_opencode_panes/`` and is replayed by
-``tests/unit/test_status_detector_opencode.py``.
+``tests/unit/test_status_detector_opencode.py``. Re-verified unchanged
+against v1.18.29 (Sep 2026, #474): a second pane corpus under
+``tests/fixtures_opencode_panes/v1.18.29/`` and the plugin's event-stream
+corpus in ``tests/fixtures_opencode_events/``.
 """
 
 import json

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/_shared.py

@@ -109,6 +109,24 @@ app.add_typer(models_app, name="models")
 
 # Console for rich output
 console = Console()
+# Notices that must not mix into output a script may parse
+err_console = Console(stderr=True)
+
+
+def find_agent(manager, name: str):
+    """Look up the agent ``name`` addresses, following renames (#478).
+
+    ``manager`` is a SessionManager. When ``name`` is an agent's old name,
+    the agent is returned and a one-line notice goes to stderr, so a person
+    or script still using the old name learns the new one.
+    """
+    from ..session_manager import rename_notice
+
+    session = manager.resolve_session_name(name)
+    notice = rename_notice(name, session)
+    if notice:
+        err_console.print(f"[yellow]{notice}[/yellow]")
+    return session
 
 # Global session option (hidden advanced usage)
 SessionOption = Annotated[

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/agent.py

@@ -9,7 +9,7 @@ import typer
 from rich import print as rprint
 
 from ..launcher import AgentLauncher
-from ._shared import app, SessionOption, _parse_duration
+from ._shared import app, SessionOption, _parse_duration, find_agent
 
 
 def _parse_oversight_policy(on_stuck: Optional[str], oversight_timeout: Optional[str]) -> tuple[str, float]:
@@ -427,7 +427,7 @@ def fork(
     from ..backends import BackendCapability, get_backend, supports
 
     sm = SessionManager()
-    source_session = sm.get_session_by_name(source)
+    source_session = find_agent(sm, source)
     if not source_session:
         rprint(f"[red]Error: Agent '{source}' not found[/red]")
         raise typer.Exit(code=1)
@@ -546,7 +546,7 @@ def list_agents(
 
     # Filter to specific agent + descendants if name given (#244)
     if name:
-        root = launcher.sessions.get_session_by_name(name)
+        root = find_agent(launcher.sessions, name)
         if not root:
             rprint(f"[red]Error: Agent '{name}' not found[/red]")
             raise typer.Exit(code=1)
@@ -842,7 +842,7 @@ def restart(
     from ..launcher import AgentLauncher
 
     launcher = AgentLauncher(session)
-    sess = launcher.sessions.get_session_by_name(name)
+    sess = find_agent(launcher.sessions, name)
     if not sess:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -879,6 +879,83 @@ def follow(
     raise typer.Exit(code=exit_code)
 
 
+@app.command()
+def rename(
+    name: Annotated[str, typer.Argument(help="Current name of agent")],
+    new_name: Annotated[str, typer.Argument(help="New name for the agent")],
+    force: Annotated[
+        bool,
+        typer.Option(
+            "--force",
+            help="Rename even if the agent is mid-turn (its turn is cancelled)",
+        ),
+    ] = False,
+    session: SessionOption = "agents",
+):
+    """Rename an agent, keeping its conversation and history.
+
+    A live agent is briefly stopped and resumed under the new name, in the
+    same window with the same conversation; it is told its new name with
+    its next prompt. The old name keeps working as an alias — `send`,
+    `follow`, `kill` and the rest reach the agent and say it was renamed —
+    so a parent or script still using it is not broken.
+
+    An agent that is busy (working, or showing a permission dialog) is not
+    renamed, because stopping it would cancel its turn; wait until it is
+    idle, or pass --force. A terminated agent just has its record renamed.
+
+    Examples:
+        overcode rename bugfix-1 auth-refactor
+    """
+    from ..exceptions import AgentBusyError, InvalidSessionNameError
+    from ..launcher import AgentLauncher
+
+    launcher = AgentLauncher(session)
+    sess = find_agent(launcher.sessions, name)
+    if not sess:
+        rprint(f"[red]Error: Agent '{name}' not found[/red]")
+        raise typer.Exit(code=1)
+    name = sess.name
+
+    try:
+        renamed = launcher.rename(sess, new_name, force=force)
+    except InvalidSessionNameError:
+        rprint(
+            f"[red]Error: '{new_name}' is not a valid agent name "
+            f"(letters, digits, - and _ only, max 64 chars)[/red]"
+        )
+        raise typer.Exit(code=1)
+    except AgentBusyError as exc:
+        state = (
+            "could not be checked" if exc.status == "unknown" else f"is busy ({exc.status})"
+        )
+        rprint(
+            f"[yellow]Agent '{name}' {state}.[/yellow] Renaming restarts it, "
+            "which would cancel a turn in progress. Try again when it is idle, "
+            "or use --force."
+        )
+        raise typer.Exit(code=1)
+    except ValueError as exc:
+        rprint(f"[red]Error: {exc}[/red]")
+        raise typer.Exit(code=1)
+
+    if not renamed:
+        current = launcher.sessions.get_session(sess.id)
+        if current is not None and current.name == new_name:
+            rprint(
+                f"[yellow]Renamed '{name}' → '{new_name}', but the relaunch could "
+                f"not be sent.[/yellow] Run: overcode restart {new_name}"
+            )
+        else:
+            rprint(
+                f"[red]Error: tmux refused to rename the window; '{name}' was "
+                "restarted under its old name.[/red]"
+            )
+        raise typer.Exit(code=1)
+
+    rprint(f"[green]Renamed agent: {name} → {new_name} (conversation preserved)[/green]")
+
+
 @app.command()
 def report(
     status: Annotated[
@@ -930,7 +1007,7 @@ def report(
     # Also update session fields for persistence
     from ..session_manager import SessionManager
     sm = SessionManager()
-    session = sm.get_session_by_name(agent_name)
+    session = find_agent(sm, agent_name)
     if session:
         sm.update_session(
             session.id,
@@ -996,7 +1073,7 @@ def set_value(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -1018,7 +1095,7 @@ def set_budget(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -1055,7 +1132,7 @@ def annotate(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -1099,7 +1176,9 @@ def send(
     sm = SessionManager()
 
     # Auto-wake sleeping agent (#168)
-    agent_session = sm.get_session_by_name(name)
+    agent_session = find_agent(sm, name)
+    if agent_session:
+        name = agent_session.name  # an old name resolved; say the current one
     if agent_session and agent_session.is_asleep:
         sm.update_session(agent_session.id, is_asleep=False)
         rprint(f"[dim]Woke agent '{name}' to send command[/dim]")
@@ -1149,10 +1228,11 @@ def show(
     launcher = AgentLauncher(session)
 
     # Get the Session object
-    sess = launcher.sessions.get_session_by_name(name)
+    sess = find_agent(launcher.sessions, name)
     if sess is None:
         rprint(f"[red]✗[/red] Agent '[bold]{name}[/bold]' not found")
         raise typer.Exit(1)
+    name = sess.name  # an old name resolved; show under the current one
 
     # Read daemon state for status/activity (single source of truth)
     daemon_state = get_monitor_daemon_state(session)

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/budget.py

@@ -7,7 +7,7 @@ from typing import Annotated, Optional
 import typer
 from rich import print as rprint
 
-from ._shared import budget_app, SessionOption
+from ._shared import budget_app, SessionOption, find_agent
 
 
 @budget_app.command("set")
@@ -28,7 +28,7 @@ def budget_set(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -73,12 +73,12 @@ def budget_transfer(
 
     manager = SessionManager()
 
-    source_agent = manager.get_session_by_name(source)
+    source_agent = find_agent(manager, source)
     if not source_agent:
         rprint(f"[red]Error: Source agent '{source}' not found[/red]")
         raise typer.Exit(code=1)
 
-    target_agent = manager.get_session_by_name(target)
+    target_agent = find_agent(manager, target)
     if not target_agent:
         rprint(f"[red]Error: Target agent '{target}' not found[/red]")
         raise typer.Exit(code=1)
@@ -118,7 +118,7 @@ def budget_reclaim(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -162,7 +162,7 @@ def budget_show(
 
     if name:
         agents = []
-        agent = manager.get_session_by_name(name)
+        agent = find_agent(manager, name)
         if not agent:
             rprint(f"[red]Error: Agent '{name}' not found[/red]")
             raise typer.Exit(code=1)

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/focal.py

@@ -7,7 +7,7 @@ from typing import Annotated, Optional
 import typer
 from rich import print as rprint
 
-from ._shared import app, SessionOption
+from ._shared import app, SessionOption, find_agent
 
 
 @app.command("focal-repo")
@@ -40,7 +40,7 @@ def focal_repo(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/jobs.py

@@ -7,7 +7,7 @@ from typing import Annotated, Optional
 import typer
 from rich import print as rprint
 
-from ._shared import app, jobs_app
+from ._shared import app, jobs_app, find_agent
 
 
 @app.command()
@@ -32,7 +32,7 @@ def bash(
         agent = os.environ.get("OVERCODE_SESSION_NAME")
     if agent:
         sm = SessionManager()
-        sess = sm.get_session_by_name(agent)
+        sess = find_agent(sm, agent)
         if sess:
             agent_session_id = sess.id
             agent_name = sess.name

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/monitoring.py

@@ -9,7 +9,7 @@ from typing import Annotated, Optional, List
 import typer
 from rich import print as rprint
 
-from ._shared import app, SessionOption
+from ._shared import app, SessionOption, find_agent
 
 
 @app.command("hook-handler", hidden=True)
@@ -67,7 +67,7 @@ def instruct(
         raise typer.Exit(1)
 
     sessions = SessionManager()
-    sess = sessions.get_session_by_name(name)
+    sess = find_agent(sessions, name)
 
     if sess is None:
         rprint(f"[red]✗[/red] Agent '[bold]{name}[/bold]' not found")
@@ -150,7 +150,7 @@ def heartbeat(
     from ..tui_helpers import format_duration
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -463,9 +463,9 @@ def history(
     sessions = SessionManager()
 
     if name:
-        # Show specific archived session
-        archived = sessions.list_archived_sessions()
-        session = next((s for s in archived if s.name == name), None)
+        # Show specific archived session: stream the archive (one record
+        # at a time, file order) instead of materialising every entry.
+        session = next((s for s in sessions.iter_archived_sessions() if s.name == name), None)
         if not session:
             rprint(f"[red]✗[/red] No archived session named '[bold]{name}[/bold]'")
             raise typer.Exit(1)

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/split.py

@@ -72,9 +72,40 @@ def _acquire_setup_lock() -> bool:
 
 
 def _release_setup_lock() -> None:
-    """Release the setup lock."""
+    """Release the setup lock, but only if this process still owns it.
+
+    Release is ownership-aware because it can legitimately run twice: once in
+    `_exec_tmux_attach` just before exec, and again from the outer `finally:`
+    in `_tmux_layout` if that exec raises. Between the two, another
+    `overcode tmux` may have acquired the lock; unlinking unconditionally
+    would delete *its* lock and let a third invocation run setup concurrently.
+    """
     lock_path = Path.home() / ".overcode" / "tmux-setup.lock"
-    lock_path.unlink(missing_ok=True)
+    try:
+        holder = lock_path.read_text().strip()
+    except FileNotFoundError:
+        return  # already released, or never acquired
+    if holder == str(os.getpid()):
+        lock_path.unlink(missing_ok=True)
+
+
+def _exec_tmux_attach(oc_session: str) -> None:
+    """Release the setup lock, then replace this process with `tmux attach`.
+
+    `os.execvp` never returns, so any `finally:` that would normally release
+    the lock is skipped. Worse, the PID recorded in the lock file becomes the
+    long-lived tmux client, so the stale-lock check treats it as a genuine
+    holder for as long as the client stays attached and every later
+    `overcode tmux` is refused. Always go through this helper to exec.
+
+    If exec itself fails, the caller's `finally:` releases again; that is
+    safe because `_release_setup_lock` only removes a lock this PID owns.
+    """
+    from ..tmux_utils import _build_tmux_cmd
+
+    _release_setup_lock()
+    _cmd = [*_build_tmux_cmd(), "attach-session", "-t", oc_session]
+    os.execvp("tmux", _cmd)
 
 
 def _find_overcode_cmd() -> str:
@@ -785,22 +816,22 @@ def _tmux_layout_locked(session: str, ratio: int, rprint, *, restart: bool = Fal
     if existing:
         if _is_split_window_healthy(existing):
             if in_tmux:
-                # Check if a real (non-nested) client is already on overcode.
-                # If so, no switch needed — the user is already there or
-                # another terminal has it open.  Switching blindly can
-                # accidentally move the bottom pane's nested client from
-                # oc-view-agents to overcode, creating a recursive display
+                # Move the caller's own client to the split window — but
+                # never the bottom pane's nested client. Switching that one
+                # from oc-view-agents to overcode creates a recursive display
                 # that collapses the window.
                 #
                 # Detect nested clients by comparing client TTYs against
                 # pane TTYs in the split window (#387). A nested tmux
                 # client's TTY matches one of the pane TTYs.
-                pane_ttys = set(
-                    _tmux_output(
+                pane_ttys = {
+                    tty.strip()
+                    for tty in _tmux_output(
                         "list-panes", "-t", f"{oc_session}:{SPLIT_WINDOW_NAME}",
                         "-F", "#{pane_tty}",
                     ).splitlines()
-                )
+                    if tty.strip()
+                }
                 oc_clients = _tmux_output(
                     "list-clients", "-t", oc_session,
                     "-F", "#{client_tty}",
@@ -810,29 +841,33 @@ def _tmux_layout_locked(session: str, ratio: int, rprint, *, restart: bool = Fal
                     for tty in oc_clients.splitlines()
                     if tty.strip()
                 )
-                if not has_real_client:
-                    # No real client on overcode yet — switch the caller's
-                    client_tty = _tmux_output(
-                        "display-message", "-p", "#{client_tty}",
-                    )
-                    if client_tty:
-                        _tmux("switch-client", "-c", client_tty,
-                              "-t", f"{oc_session}:{SPLIT_WINDOW_NAME}")
-                    else:
-                        # Can't determine client — tell user how to get there
-                        rprint(f"[green]Split layout is running.[/green] Switch to it with:")
-                        rprint(f"  tmux switch-client -t {oc_session}")
-                        return
+                client_tty = _tmux_output(
+                    "display-message", "-p", "#{client_tty}",
+                ).strip()
+                if client_tty and client_tty not in pane_ttys:
+                    # The caller may already be attached to the overcode
+                    # session but sitting on another window (e.g. an agent
+                    # window opened there), so always target the split
+                    # window explicitly rather than just the session.
+                    _tmux("switch-client", "-c", client_tty,
+                          "-t", f"{oc_session}:{SPLIT_WINDOW_NAME}")
+                elif client_tty:
+                    # Caller is inside the nested bottom pane — it's already
+                    # looking at the split; leave the client alone.
+                    pass
+                elif not has_real_client:
+                    # Can't determine client — tell user how to get there
+                    rprint(f"[green]Split layout is running.[/green] Switch to it with:")
+                    rprint(f"  tmux switch-client -t {oc_session}")
+                    return
             else:
-                # Respawn before attach — execlp replaces this process
+                # Respawn before attach — exec replaces this process
                 _tmux("respawn-pane", "-k",
                       "-t", f"{oc_session}:{SPLIT_WINDOW_NAME}.{get_pane_base_index()}",
                       monitor_cmd)
                 rprint(f"[green]Attaching to existing {SPLIT_WINDOW_NAME} window (monitor restarted)...[/green]")
                 time.sleep(0.2)
-                from ..tmux_utils import _build_tmux_cmd
-                _cmd = [*_build_tmux_cmd(), "attach-session", "-t", oc_session]
-                os.execvp("tmux", _cmd)
+                _exec_tmux_attach(oc_session)
             # Always restart the monitor so code changes take effect
             _tmux("respawn-pane", "-k",
                   "-t", f"{oc_session}:{SPLIT_WINDOW_NAME}.{get_pane_base_index()}",
@@ -1004,6 +1039,4 @@ def _tmux_layout_locked(session: str, ratio: int, rprint, *, restart: bool = Fal
         # Attach to the session (replaces this process)
         rprint(f"[green]Attaching to split layout...[/green]")
         time.sleep(0.2)
-        from ..tmux_utils import _build_tmux_cmd
-        _cmd = [*_build_tmux_cmd(), "attach-session", "-t", oc_session]
-        os.execvp("tmux", _cmd)
+        _exec_tmux_attach(oc_session)

{overcode-0.5.4 → overcode-0.5.6}/src/overcode/cli/tags.py

@@ -11,7 +11,7 @@ import typer
 from rich import print as rprint
 from rich.table import Table
 
-from ._shared import app, SessionOption
+from ._shared import app, SessionOption, find_agent
 
 
 @app.command("tag")
@@ -32,7 +32,7 @@ def tag_add(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -66,7 +66,7 @@ def tag_remove(
     from ..session_manager import SessionManager
 
     manager = SessionManager()
-    agent = manager.get_session_by_name(name)
+    agent = find_agent(manager, name)
     if not agent:
         rprint(f"[red]Error: Agent '{name}' not found[/red]")
         raise typer.Exit(code=1)
@@ -95,7 +95,7 @@ def tags_list(
 
     manager = SessionManager()
     if name:
-        agent = manager.get_session_by_name(name)
+        agent = find_agent(manager, name)
         if not agent:
             rprint(f"[red]Error: Agent '{name}' not found[/red]")
             raise typer.Exit(code=1)