overcode 0.1.8__tar.gz → 0.2.0__tar.gz

{overcode-0.1.8/src/overcode.egg-info → overcode-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.1.8
+Version: 0.2.0
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode

{overcode-0.1.8 → overcode-0.2.0}/pyproject.toml

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

{overcode-0.1.8 → overcode-0.2.0}/src/overcode/claude_config.py

@@ -137,3 +137,50 @@ class ClaudeConfigEditor:
                     if cmd.startswith(command_prefix):
                         results.append((event, cmd))
         return results
+
+    # ----- Permission management -----
+
+    def add_permission(self, tool_pattern: str) -> bool:
+        """Add to permissions.allow. Returns True if newly added."""
+        settings = self.load()
+        allow_list = settings.get("permissions", {}).get("allow", [])
+        if tool_pattern in allow_list:
+            return False
+
+        updated = copy.deepcopy(settings)
+        if "permissions" not in updated:
+            updated["permissions"] = {}
+        if "allow" not in updated["permissions"]:
+            updated["permissions"]["allow"] = []
+        updated["permissions"]["allow"].append(tool_pattern)
+        self.save(updated)
+        return True
+
+    def remove_permission(self, tool_pattern: str) -> bool:
+        """Remove from permissions.allow. Returns True if found."""
+        settings = self.load()
+        allow_list = settings.get("permissions", {}).get("allow", [])
+        if tool_pattern not in allow_list:
+            return False
+
+        updated = copy.deepcopy(settings)
+        updated["permissions"]["allow"].remove(tool_pattern)
+
+        # Clean up empty allow list
+        if not updated["permissions"]["allow"]:
+            del updated["permissions"]["allow"]
+
+        # Clean up empty permissions dict
+        if not updated["permissions"]:
+            del updated["permissions"]
+
+        self.save(updated)
+        return True
+
+    def list_permissions_matching(self, prefix: str) -> list[str]:
+        """Return entries from permissions.allow that start with prefix."""
+        settings = self.load()
+        return [
+            p for p in settings.get("permissions", {}).get("allow", [])
+            if p.startswith(prefix)
+        ]

{overcode-0.1.8 → overcode-0.2.0}/src/overcode/cli.py

@@ -56,6 +56,14 @@ skills_app = typer.Typer(
 )
 app.add_typer(skills_app, name="skills")
 
+# Perms subcommand group
+perms_app = typer.Typer(
+    name="perms",
+    help="Manage Claude Code tool permissions for overcode commands.",
+    no_args_is_help=True,
+)
+app.add_typer(perms_app, name="perms")
+
 # Budget subcommand group (#244)
 budget_app = typer.Typer(
     name="budget",
@@ -244,6 +252,9 @@ def list_agents(
     cost: Annotated[
         bool, typer.Option("--cost", help="Show $ cost instead of token counts")
     ] = False,
+    sisters: Annotated[
+        bool, typer.Option("--sisters", help="Include sister (remote) agents")
+    ] = False,
     session: SessionOption = "agents",
 ):
     """List running agents with status.
@@ -260,12 +271,21 @@ def list_agents(
     )
     from .monitor_daemon_state import get_monitor_daemon_state
     from .summary_columns import build_cli_context, SUMMARY_COLUMNS
+    from .tui_logic import compute_tree_metadata, sort_sessions_by_tree
     from rich.text import Text
     from rich.console import Console
 
     launcher = ClaudeLauncher(session)
     sessions = launcher.list_sessions()
 
+    # Merge sister sessions if --sisters flag
+    if sisters:
+        from .sister_poller import SisterPoller
+        poller = SisterPoller()
+        if poller.has_sisters:
+            remote_sessions = poller.poll_all()
+            sessions = sessions + remote_sessions
+
     if not sessions:
         rprint("[dim]No running agents[/dim]")
         return
@@ -288,6 +308,10 @@ def list_agents(
         rprint("[dim]No running agents[/dim]")
         return
 
+    # Sort in tree order and compute tree metadata for depth/prefix
+    sessions = sort_sessions_by_tree(sessions)
+    tree_meta = compute_tree_metadata(sessions)
+
     # Columns to render in list mode (subset of TUI columns)
     list_columns = {
         "status_symbol", "time_in_state", "agent_name",
@@ -315,7 +339,11 @@ def list_agents(
     terminated_count = 0
 
     for sess in sessions:
-        if sess.status == "terminated":
+        if getattr(sess, 'is_remote', False):
+            # Remote sessions carry status in their stats
+            status = sess.stats.current_state or "running"
+            activity = sess.stats.current_task or ""
+        elif sess.status == "terminated":
             status = "terminated"
             activity = "(tmux window no longer exists)"
             terminated_count += 1
@@ -348,14 +376,18 @@ def list_agents(
 
         # Get git diff stats
         git_diff = None
-        try:
-            if sess.start_directory:
-                git_diff = get_git_diff_stats(sess.start_directory)
-        except Exception:
-            pass
-
-        # Build column context
-        child_count = len(launcher.sessions.get_children(sess.id))
+        if getattr(sess, 'is_remote', False):
+            git_diff = getattr(sess, 'remote_git_diff', None)
+        else:
+            try:
+                if sess.start_directory:
+                    git_diff = get_git_diff_stats(sess.start_directory)
+            except Exception:
+                pass
+
+        # Build column context using tree metadata for child count
+        meta = tree_meta.get(sess.id)
+        child_count = meta.child_count if meta else 0
         ctx = build_cli_context(
             session=sess, stats=sess.stats,
             claude_stats=claude_stats, git_diff_stats=git_diff,
@@ -370,8 +402,8 @@ def list_agents(
         ctx.summary_detail = "med"
         ctx.show_cost = cost
 
-        # Handle tree indentation (#244)
-        depth = launcher.sessions.compute_depth(sess)
+        # Handle tree indentation (#244) using compute_tree_metadata
+        depth = meta.depth if meta else 0
         indent = "  " * depth
         available = name_width - len(indent)
         ctx.display_name = (indent + sess.name[:available]).ljust(name_width)
@@ -1241,6 +1273,148 @@ def skills_status():
                 rprint(f"  {name:<20} [yellow]modified[/yellow]")
 
 
+# =============================================================================
+# Perms Commands
+# =============================================================================
+
+OVERCODE_SAFE_PERMS = [
+    "Bash(overcode report *)",
+    "Bash(overcode show *)",
+    "Bash(overcode list *)",
+    "Bash(overcode follow *)",
+    "Bash(overcode kill *)",
+    "Bash(overcode budget *)",
+]
+
+OVERCODE_PUNCHY_PERMS = [
+    "Bash(overcode launch *)",
+    "Bash(overcode send *)",
+    "Bash(overcode instruct *)",
+]
+
+
+@perms_app.command("install")
+def perms_install(
+    project: Annotated[
+        bool,
+        typer.Option("--project", "-p", help="Install to project-level .claude/settings.json instead of user-level"),
+    ] = False,
+    all_perms: Annotated[
+        bool,
+        typer.Option("--all", help="Include punchy permissions (launch, send, instruct)"),
+    ] = False,
+):
+    """Install overcode tool permissions into Claude Code settings.
+
+    By default installs safe (read-only) permissions. Use --all to also
+    include punchy permissions that can spawn or control agents.
+
+    Safe: report, show, list, follow, kill, budget
+    Punchy (--all): launch, send, instruct
+    """
+    from .claude_config import ClaudeConfigEditor
+
+    if project:
+        editor = ClaudeConfigEditor.project_level()
+        level = "project"
+    else:
+        editor = ClaudeConfigEditor.user_level()
+        level = "user"
+
+    try:
+        editor.load()
+    except ValueError as e:
+        rprint(f"[red]Error:[/red] {e}")
+        raise typer.Exit(1)
+
+    perms = OVERCODE_SAFE_PERMS + (OVERCODE_PUNCHY_PERMS if all_perms else [])
+
+    installed = 0
+    already = 0
+    for perm in perms:
+        if editor.add_permission(perm):
+            installed += 1
+        else:
+            already += 1
+
+    if installed > 0:
+        tier = "safe + punchy" if all_perms else "safe"
+        rprint(f"[green]\u2713[/green] Installed {installed} permission(s) in {level} settings ({tier})")
+        rprint(f"  [dim]{editor.path}[/dim]")
+        for perm in perms:
+            rprint(f"  {perm}")
+    elif already == len(perms):
+        rprint(f"[green]\u2713[/green] All {already} permissions already installed in {level} settings")
+
+
+@perms_app.command("uninstall")
+def perms_uninstall(
+    project: Annotated[
+        bool,
+        typer.Option("--project", "-p", help="Uninstall from project-level .claude/settings.json instead of user-level"),
+    ] = False,
+):
+    """Remove all overcode permissions from Claude Code settings."""
+    from .claude_config import ClaudeConfigEditor
+
+    if project:
+        editor = ClaudeConfigEditor.project_level()
+        level = "project"
+    else:
+        editor = ClaudeConfigEditor.user_level()
+        level = "user"
+
+    try:
+        editor.load()
+    except ValueError as e:
+        rprint(f"[red]Error:[/red] {e}")
+        raise typer.Exit(1)
+
+    all_perms = OVERCODE_SAFE_PERMS + OVERCODE_PUNCHY_PERMS
+    removed = 0
+    for perm in all_perms:
+        if editor.remove_permission(perm):
+            removed += 1
+
+    if removed > 0:
+        rprint(f"[green]\u2713[/green] Removed {removed} permission(s) from {level} settings")
+    else:
+        rprint(f"[dim]No overcode permissions found in {level} settings[/dim]")
+
+
+@perms_app.command("status")
+def perms_status():
+    """Show which overcode permissions are installed."""
+    from .claude_config import ClaudeConfigEditor
+
+    all_perms = OVERCODE_SAFE_PERMS + OVERCODE_PUNCHY_PERMS
+
+    for level_name, editor in [
+        ("User-level", ClaudeConfigEditor.user_level()),
+        ("Project-level", ClaudeConfigEditor.project_level()),
+    ]:
+        try:
+            editor.load()
+        except ValueError:
+            rprint(f"\n{level_name} ({editor.path}):")
+            rprint(f"  [red](invalid JSON)[/red]")
+            continue
+
+        if not editor.path.exists():
+            rprint(f"\n{level_name} ({editor.path}):")
+            rprint(f"  [dim](no settings file)[/dim]")
+            continue
+
+        rprint(f"\n{level_name} ({editor.path}):")
+
+        installed = editor.list_permissions_matching("Bash(overcode ")
+        for perm in all_perms:
+            if perm in installed:
+                rprint(f"  {perm}  [green]\u2713[/green]")
+            else:
+                rprint(f"  {perm:<30} [dim]not installed[/dim]")
+
+
 @app.command("hook-handler", hidden=True)
 def hook_handler_cmd():
     """Handle Claude Code hook events (internal).
@@ -1508,6 +1682,7 @@ def monitor(
     """Launch the standalone TUI monitor."""
     if restart:
         from .monitor_daemon import stop_monitor_daemon, is_monitor_daemon_running, get_monitor_daemon_pid
+        from .web_server import is_web_server_running, stop_web_server, start_web_server, get_web_server_url
 
         if is_monitor_daemon_running(session):
             pid = get_monitor_daemon_pid(session)
@@ -1517,6 +1692,16 @@ def monitor(
                 rprint("[red]Failed to stop monitor daemon[/red]")
                 raise typer.Exit(1)
 
+        if is_web_server_running(session):
+            ok, msg = stop_web_server(session)
+            if ok:
+                rprint(f"[green]✓[/green] Web server stopped")
+                started, start_msg = start_web_server(session)
+                if started:
+                    rprint(f"[green]✓[/green] Web server restarted ({start_msg})")
+                else:
+                    rprint(f"[yellow]Warning: web server failed to restart: {start_msg}[/yellow]")
+
     from .tui import run_tui
 
     run_tui(session, diagnostics=diagnostics)
@@ -2042,6 +2227,63 @@ def sister_remove(
     rprint(f"[green]✓ Removed sister '{name}'[/green]")
 
 
+@sister_app.command("allow-control")
+def sister_allow_control(
+    on: Annotated[bool, typer.Option("--on", help="Enable remote control")] = False,
+    off: Annotated[bool, typer.Option("--off", help="Disable remote control")] = False,
+):
+    """Show or toggle remote control for this machine's web server.
+
+    When enabled, sister instances can send commands (kill, restart, send
+    instructions, etc.) to agents on this machine via POST endpoints.
+
+    Examples:
+        overcode sister allow-control          # Show current status
+        overcode sister allow-control --on     # Enable remote control
+        overcode sister allow-control --off    # Disable remote control
+    """
+    from .config import load_config, save_config, get_web_api_key
+
+    config = load_config()
+    web = config.setdefault("web", {})
+
+    if on and off:
+        rprint("[red]Error: Cannot use --on and --off together[/red]")
+        raise typer.Exit(code=1)
+
+    if on:
+        api_key = get_web_api_key()
+        web["allow_control"] = True
+        save_config(config)
+        rprint(f"[green]✓ Remote control enabled (web.allow_control = true)[/green]")
+        if api_key:
+            masked_key = api_key[:4] + "..."
+            rprint(f"  API key: {masked_key}")
+        else:
+            rprint(f"  [yellow]Warning: web.api_key is not set — endpoints are unauthenticated[/yellow]")
+            rprint(f"  [dim]This is fine if you're using SSH tunnels. Otherwise set it in ~/.overcode/config.yaml:[/dim]")
+            rprint()
+            rprint("  web:")
+            rprint('    api_key: "your-secret-key"')
+        rprint(f"  Restart web server for changes to take effect.")
+    elif off:
+        web["allow_control"] = False
+        save_config(config)
+        rprint(f"[green]✓ Remote control disabled (web.allow_control = false)[/green]")
+    else:
+        # Show current status
+        enabled = web.get("allow_control", False)
+        api_key = get_web_api_key()
+        if enabled:
+            masked_key = (api_key[:4] + "...") if api_key else "(not set)"
+            rprint(f"Remote control: [green]enabled[/green]")
+            rprint(f"  API key: {masked_key}")
+        else:
+            rprint(f"Remote control: [red]disabled[/red]")
+            if not api_key:
+                rprint(f"  [dim]Note: web.api_key is also not set[/dim]")
+
+
 # =============================================================================
 # Config Commands
 # =============================================================================

{overcode-0.1.8 → overcode-0.2.0}/src/overcode/config.py

@@ -247,6 +247,23 @@ def get_web_api_key() -> Optional[str]:
     return web.get("api_key") or None
 
 
+def get_web_allow_control() -> bool:
+    """Check if remote control is enabled for the web server.
+
+    When False (default), all POST/PUT/DELETE endpoints return 403.
+
+    Config format in ~/.overcode/config.yaml:
+        web:
+          allow_control: true
+
+    Returns:
+        True if remote control is enabled, False otherwise
+    """
+    config = load_config()
+    web = config.get("web", {})
+    return bool(web.get("allow_control", False))
+
+
 def get_sisters_config() -> List[dict]:
     """Get sister instance configuration for cross-machine monitoring.