overcode 0.2.2__tar.gz → 0.2.3__tar.gz

{overcode-0.2.2/src/overcode.egg-info → overcode-0.2.3}/PKG-INFO

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

{overcode-0.2.2 → overcode-0.2.3}/pyproject.toml

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

overcode-0.2.3/src/overcode/agent_scanner.py

@@ -0,0 +1,38 @@
+"""
+Scan for Claude Code agent definitions (.md files in .claude/agents/).
+"""
+
+from pathlib import Path
+from typing import List
+
+
+def scan_agents(directory: str) -> List[str]:
+    """Scan for available Claude agent definitions.
+
+    Checks both project-level (.claude/agents/) and user-level (~/.claude/agents/)
+    directories for .md files. Returns deduplicated, sorted list of agent names
+    (filenames without .md extension).
+
+    Args:
+        directory: Project directory to scan for project-level agents.
+
+    Returns:
+        Sorted list of agent names. Empty list if none found.
+    """
+    names: set = set()
+
+    # Project-level agents
+    project_dir = Path(directory) / ".claude" / "agents"
+    if project_dir.is_dir():
+        for f in project_dir.iterdir():
+            if f.is_file() and f.suffix == ".md":
+                names.add(f.stem)
+
+    # User-level agents
+    user_dir = Path.home() / ".claude" / "agents"
+    if user_dir.is_dir():
+        for f in user_dir.iterdir():
+            if f.is_file() and f.suffix == ".md":
+                names.add(f.stem)
+
+    return sorted(names)

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/bundled_skills.py

@@ -32,6 +32,7 @@ overcode launch -n <name> [-d <path>] [-p "<prompt>"] [--follow] [--bypass-permi
 overcode launch -n <name> --follow --oversight-timeout 5m -p "... When done: overcode report --status success"
 overcode launch -n <name> --allowed-tools "Read,Glob,Grep" --skip-permissions
 overcode launch -n <name> --claude-arg "--model haiku" --claude-arg "--effort low"
+overcode launch -n <name> --budget 2.00 -p "..."  # Set cost budget (auto-deducted from parent)
 
 # Monitor
 overcode list [name] [--show-done]
@@ -127,8 +128,8 @@ overcode launch --name fix-auth-bug -d ~/project --follow --bypass-permissions \
 ## Parallel (Non-Blocking)
 
 ```bash
-overcode launch -n refactor-api -d ~/project -p "Refactor REST API. When done: overcode report --status success" --bypass-permissions
-overcode launch -n write-tests -d ~/project -p "Write auth tests. When done: overcode report --status success" --bypass-permissions
+overcode launch -n refactor-api -d ~/project --budget 3.00 -p "Refactor REST API. When done: overcode report --status success" --bypass-permissions
+overcode launch -n write-tests -d ~/project --budget 2.00 -p "Write auth tests. When done: overcode report --status success" --bypass-permissions
 
 overcode list                       # Monitor progress
 overcode show refactor-api -n 100   # Read output
@@ -163,6 +164,10 @@ Children must call `overcode report --status success|failure [--reason "..."]` w
 ## Budget Control
 
 ```bash
+# Preferred: set budget at launch (auto-deducted from parent if parent has budget)
+overcode launch -n child-agent -d ~/project --bypass-permissions --budget 2.00 -p "..."
+
+# Manual budget management
 overcode budget transfer my-agent child-agent 2.00   # Transfer from your budget
 overcode budget set child-agent 3.00                  # Set directly
 ```

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/cli/agent.py

@@ -59,6 +59,14 @@ def launch(
         Optional[List[str]],
         typer.Option("--claude-arg", help="Extra Claude CLI flag (repeatable, e.g. '--model haiku')"),
     ] = None,
+    budget: Annotated[
+        Optional[float],
+        typer.Option("--budget", "-b", help="Cost budget in USD (deducted from parent if parent has budget)"),
+    ] = None,
+    agent: Annotated[
+        Optional[str],
+        typer.Option("--agent", "-a", help="Claude agent to run as (from .claude/agents/)"),
+    ] = None,
     teams: Annotated[
         bool,
         typer.Option("--teams", help="Enable Claude Code agent teams (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS)"),
@@ -159,6 +167,8 @@ def launch(
         allowed_tools=allowed_tools,
         extra_claude_args=claude_args,
         agent_teams=teams,
+        budget_usd=budget,
+        claude_agent=agent,
     )
 
     if result:
@@ -171,8 +181,12 @@ def launch(
             rprint(f"  Allowed tools: {allowed_tools}")
         if claude_args:
             rprint(f"  Extra Claude args: {' '.join(claude_args)}")
+        if agent:
+            rprint(f"  Agent: {agent}")
         if teams:
             rprint("  Agent teams: enabled")
+        if budget is not None and budget > 0:
+            rprint(f"  Budget: ${budget:.2f}")
 
         # Store oversight policy on session
         if oversight_policy != "wait" or oversight_timeout_seconds > 0:
@@ -306,16 +320,26 @@ def list_agents(
     # Compute cross-session flags from daemon state
     any_has_oversight_timeout = False
     any_has_pr = False
+    subtree_costs = {}
     if use_daemon:
         any_has_oversight_timeout = any(
             ds.oversight_timeout_seconds > 0
             for ds in daemon_state.sessions
         )
-    else:
+        for ds in daemon_state.sessions:
+            if ds.subtree_cost_usd > 0:
+                subtree_costs[ds.session_id] = ds.subtree_cost_usd
+    # Also extract from remote sessions via forwarded daemon_state
+    for s in sessions:
+        rds = getattr(s, 'remote_daemon_state', None)
+        if rds and rds.get('subtree_cost_usd', 0) > 0:
+            subtree_costs[s.id] = rds['subtree_cost_usd']
+    if not use_daemon:
         any_has_oversight_timeout = any(
             getattr(s, 'oversight_timeout_seconds', 0) > 0
             for s in sessions
         )
+    any_has_subtree_cost = bool(subtree_costs)
     any_has_pr = any(
         getattr(s, 'pr_number', None) is not None
         for s in sessions
@@ -413,6 +437,8 @@ def list_agents(
             max_repo_width=max_repo_width,
             max_branch_width=max_branch_width,
             all_names_match_repos=all_names_match_repos,
+            subtree_cost_usd=subtree_costs.get(sess.id, 0.0),
+            any_has_subtree_cost=any_has_subtree_cost,
         )
         ctx.status_color = f"bold {status_color}"
         ctx.show_cost = cost
@@ -859,6 +885,8 @@ def show(
             print(f"{'Tools:':<{label_width + 1}} {sess.allowed_tools}")
         if sess.extra_claude_args:
             print(f"{'Claude args:':<{label_width + 1}} {' '.join(sess.extra_claude_args)}")
+        if sess.claude_agent:
+            print(f"{'Agent:':<{label_width + 1}} {sess.claude_agent}")
         if sess.agent_teams:
             print(f"{'Teams:':<{label_width + 1}} enabled")
 

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/cli/daemon.py

@@ -35,7 +35,7 @@ def monitor_daemon_start(
     - Status detection (running, waiting, etc.)
     - Time accumulation (green_time, non_green_time)
     - Claude Code stats (tokens, interactions)
-    - User presence state (macOS only)
+    - User presence state
     """
     from ..monitor_daemon import MonitorDaemon, is_monitor_daemon_running, get_monitor_daemon_pid
 

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/launcher.py

@@ -79,6 +79,8 @@ class ClaudeLauncher:
         allowed_tools: Optional[str] = None,
         extra_claude_args: Optional[List[str]] = None,
         agent_teams: bool = False,
+        budget_usd: Optional[float] = None,
+        claude_agent: Optional[str] = None,
     ) -> Optional[Session]:
         """
         Launch an interactive Claude Code session in a tmux window.
@@ -163,6 +165,10 @@ class ClaudeLauncher:
         elif skip_permissions:
             claude_cmd.extend(["--permission-mode", "dontAsk"])
 
+        # Claude agent persona
+        if claude_agent:
+            claude_cmd.extend(["--agent", claude_agent])
+
         # Claude CLI flag passthrough (#290)
         if allowed_tools:
             claude_cmd.extend(["--allowedTools", allowed_tools])
@@ -217,6 +223,7 @@ class ClaudeLauncher:
             allowed_tools=allowed_tools,
             extra_claude_args=extra_claude_args,
             agent_teams=agent_teams,
+            claude_agent=claude_agent,
         )
 
         # Set parent if launching as child agent (#244)
@@ -224,6 +231,19 @@ class ClaudeLauncher:
             self.sessions.update_session(session.id, parent_session_id=parent_session.id)
             session.parent_session_id = parent_session.id
 
+        # Apply budget at launch time
+        if budget_usd is not None and budget_usd > 0:
+            if parent_session:
+                # transfer_budget handles unlimited parent (budget=0) correctly
+                success = self.sessions.transfer_budget(parent_session.id, session.id, budget_usd)
+                if not success:
+                    print(f"Cannot launch: parent has insufficient budget for ${budget_usd:.2f}")
+                    self.tmux.kill_window(window_index)
+                    self.sessions.delete_session(session.id)
+                    return None
+            else:
+                self.sessions.set_cost_budget(session.id, budget_usd)
+
         print(f"✓ Launched '{name}' in tmux window {window_index}")
 
         # Send initial prompt if provided (after Claude starts)

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/monitor_daemon.py

@@ -6,7 +6,7 @@ This daemon handles all monitoring responsibilities:
 - Agent status detection (via StatusDetector)
 - Time tracking (green_time_seconds, non_green_time_seconds)
 - Claude Code stats sync (tokens, interactions)
-- Presence tracking (macOS only, graceful degradation)
+- Presence tracking (graceful degradation on non-macOS)
 - Status history logging (CSV)
 
 The Monitor Daemon publishes MonitorDaemonState to a JSON file that
@@ -149,18 +149,18 @@ def _create_monitor_logger(session: str = "agents", log_file: Optional[Path] = N
 
 
 class PresenceComponent:
-    """Presence tracking with graceful degradation for non-macOS."""
+    """Presence tracking (works on all platforms; richer on macOS with Quartz)."""
 
     # TUI heartbeat is considered fresh if within this many seconds
     TUI_HEARTBEAT_FRESHNESS = 60
 
     def __init__(self, tmux_session: str = "agents"):
-        self.available = MACOS_APIS_AVAILABLE
+        self.available = True
         self._logger: Optional[PresenceLogger] = None
         self._tmux_session = tmux_session
         self._last_publish_time: Optional[datetime] = None
 
-        if self.available and PresenceLogger is not None:
+        if PresenceLogger is not None:
             heartbeat_path = str(get_tui_heartbeat_path(tmux_session))
             config = PresenceLoggerConfig(
                 tui_heartbeat_path=heartbeat_path,
@@ -200,30 +200,39 @@ class PresenceComponent:
         """Get current presence state.
 
         Returns:
-            Tuple of (state, idle_seconds, locked) or (None, None, None) if unavailable
+            Tuple of (state, idle_seconds, locked) or (None, None, None) if unavailable.
+            On non-macOS, idle is always 0 and locked is always False, but sleep
+            detection and TUI heartbeat still produce meaningful state values.
         """
-        if not self.available or get_current_presence_state is None:
-            return None, None, None
-
         try:
+            from .presence_logger import classify_state, DEFAULT_IDLE_THRESHOLD
+
             tui_active = self._is_tui_active()
             slept = self._detect_sleep()
 
             if slept:
                 # Machine just woke — override to asleep state for this sample
-                idle = 0.0
-                locked = False
-                from .presence_logger import classify_state, DEFAULT_IDLE_THRESHOLD
                 state = classify_state(
-                    locked=locked,
-                    idle_seconds=idle,
+                    locked=False,
+                    idle_seconds=0.0,
                     slept=True,
                     idle_threshold=DEFAULT_IDLE_THRESHOLD,
                     tui_active=False,
                 )
-                return state, idle, locked
-
-            return get_current_presence_state(tui_active=tui_active)
+                return state, 0.0, False
+
+            if MACOS_APIS_AVAILABLE and get_current_presence_state is not None:
+                return get_current_presence_state(tui_active=tui_active)
+
+            # Non-macOS: idle=0, locked=False; TUI heartbeat still works
+            state = classify_state(
+                locked=False,
+                idle_seconds=0.0,
+                slept=False,
+                idle_threshold=DEFAULT_IDLE_THRESHOLD,
+                tui_active=tui_active,
+            )
+            return state, 0.0, False
         except Exception:
             return None, None, None
 
@@ -856,7 +865,7 @@ class MonitorDaemon:
                 if pane_content:
                     pr = extract_pr_number(pane_content)
                     if pr is not None and pr != session.pr_number:
-                        self.session_manager.update_session(session.id, pr_number=pr)
+                        self.session_manager.update_session(session.id, pr_number=pr, pr_branch=session.branch)
 
             # Clear heartbeat tracking when session stops running
             if status != STATUS_RUNNING and session.id in self._sessions_running_from_heartbeat:
@@ -864,7 +873,14 @@ class MonitorDaemon:
                 self._heartbeat_start_pending.discard(session.id)
 
             # Refresh git context (branch may have changed)
-            self.session_manager.refresh_git_context(session.id)
+            git_changed = self.session_manager.refresh_git_context(session.id)
+            if git_changed and session.pr_number is not None:
+                # Re-read session to get updated branch
+                refreshed = self.session_manager.get_session(session.id)
+                if refreshed and refreshed.branch is not None:
+                    # Clear if pr_branch not set (pre-migration) or branch mismatch
+                    if refreshed.pr_branch is None or refreshed.branch != refreshed.pr_branch:
+                        self.session_manager.update_session(session.id, pr_number=None, pr_branch=None)
 
             # Update current task in session
             self.session_manager.update_stats(
@@ -911,8 +927,29 @@ class MonitorDaemon:
             if status != "waiting_user":
                 all_waiting_user = False
 
+        # Compute subtree costs for parent agents
+        self._compute_subtree_costs(session_states)
+
         return session_states, all_waiting_user
 
+    def _compute_subtree_costs(self, session_states):
+        """Compute subtree cost (self + all descendants) for each parent agent."""
+        by_name = {s.name: s for s in session_states}
+        children_map = {}
+        for s in session_states:
+            if s.parent_name and s.parent_name in by_name:
+                children_map.setdefault(s.parent_name, []).append(s.name)
+
+        def _sum(name):
+            total = by_name[name].estimated_cost_usd
+            for child in children_map.get(name, []):
+                total += _sum(child)
+            return total
+
+        for s in session_states:
+            if children_map.get(s.name):
+                s.subtree_cost_usd = _sum(s.name)
+
     def _cleanup_stale(self, sessions: list) -> None:
         """Remove stale tracking entries for deleted sessions."""
         current_session_ids = {s.id for s in sessions}
@@ -971,7 +1008,7 @@ class MonitorDaemon:
         self.log.section("Monitor Daemon")
         self.log.info(f"PID: {os.getpid()}")
         self.log.info(f"tmux session: {self.tmux_session}")
-        self.log.info(f"Presence tracking: {'available' if self.presence.available else 'unavailable (non-macOS)'}")
+        self.log.info(f"Presence tracking: available (macOS Quartz: {'yes' if MACOS_APIS_AVAILABLE else 'no'})")
 
         # Setup signal handlers
         def handle_shutdown(signum, frame):

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/monitor_daemon_state.py

@@ -8,7 +8,7 @@ The Monitor Daemon is the single source of truth for:
 - Agent status detection
 - Time tracking (green_time_seconds, non_green_time_seconds)
 - Claude Code stats (tokens, interactions)
-- User presence state (macOS only)
+- User presence state
 """
 
 import json
@@ -97,6 +97,7 @@ class SessionDaemonState:
     # Cost budget (#173)
     cost_budget_usd: float = 0.0  # 0 = unlimited
     budget_exceeded: bool = False  # True when cost >= budget
+    subtree_cost_usd: float = 0.0  # self + all descendants (0 = leaf or not computed)
 
     # Agent hierarchy (#244)
     parent_name: Optional[str] = None  # Name of parent agent (None = root)
@@ -140,7 +141,7 @@ class MonitorDaemonState:
     # Session states (one per agent)
     sessions: List[SessionDaemonState] = field(default_factory=list)
 
-    # Presence state (optional, macOS only)
+    # Presence state
     presence_available: bool = False
     presence_state: Optional[int] = None  # 0=asleep, 1=locked, 2=idle, 3=active, 4=tui_active
     presence_idle_seconds: Optional[float] = None

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/presence_logger.py

@@ -1,7 +1,7 @@
 """
 presence_logger.py
 
-Mac-only presence logger that records user presence/absence stats.
+Presence logger that records user presence/absence stats.
 
 Records once per SAMPLE_INTERVAL:
 - timestamp (ISO8601 local time)
@@ -441,9 +441,9 @@ def main() -> int:
         overcode presence
     """
     if not MACOS_APIS_AVAILABLE:
-        print("Error: macOS APIs not available.")
-        print("Install dependencies: pip install pyobjc-framework-Quartz pyobjc-framework-ApplicationServices")
-        return 1
+        print("Note: macOS Quartz APIs not available; idle and screen-lock detection disabled.")
+        print("Sleep detection and TUI heartbeat still work.")
+        print()
 
     # Check if already running
     if is_presence_running():

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/session_manager.py

@@ -79,6 +79,7 @@ class Session:
     repo_name: Optional[str] = None
     branch: Optional[str] = None
     pr_number: Optional[int] = None
+    pr_branch: Optional[str] = None
 
     # Management
     status: str = "running"
@@ -129,6 +130,7 @@ class Session:
     allowed_tools: Optional[str] = None  # Comma-separated tool list for --allowedTools
     extra_claude_args: List[str] = field(default_factory=list)  # Extra CLI flags via --claude-arg
     agent_teams: bool = False  # Claude Code agent teams mode (#309)
+    claude_agent: Optional[str] = None  # Claude agent persona (from .claude/agents/)
 
     # Agent hierarchy (#244) - parent/child relationships
     parent_session_id: Optional[str] = None  # ID of parent agent (None = root)
@@ -150,6 +152,7 @@ class Session:
     remote_median_work_time: float = 0.0  # Median work time from remote API
     remote_activity_summary: str = ""  # AI summary from remote summarizer
     remote_activity_summary_context: str = ""  # AI context summary from remote summarizer
+    remote_daemon_state: Optional[dict] = None  # Raw daemon state dict from sister API (for generic forwarding)
 
     def to_dict(self) -> dict:
         data = asdict(self)
@@ -452,7 +455,8 @@ class SessionManager:
                       permissiveness_mode: str = "normal",
                       allowed_tools: Optional[str] = None,
                       extra_claude_args: Optional[List[str]] = None,
-                      agent_teams: bool = False) -> Session:
+                      agent_teams: bool = False,
+                      claude_agent: Optional[str] = None) -> Session:
         """Create and register a new session.
 
         Args:
@@ -486,6 +490,7 @@ class SessionManager:
             allowed_tools=allowed_tools,
             extra_claude_args=extra_claude_args or [],
             agent_teams=agent_teams,
+            claude_agent=claude_agent,
         )
 
         state = self._load_state()

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/settings.py

@@ -430,12 +430,11 @@ class TUIPreferences:
     notifications: str = "off"  # "off", "sound", "banner", "both" — macOS notifications (#235)
     # Session IDs of stalled agents that have been visited by the user
     visited_stalled_agents: Set[str] = field(default_factory=set)
-    # Column group visibility (group_id -> enabled) for summary line (#178)
-    summary_groups: dict = field(default_factory=lambda: {
-        "time": True, "llm_usage": True, "context": True, "git": True,
-        "supervision": True, "priority": True, "performance": True,
-        "subprocesses": True,
-    })
+    # Per-level column overrides: {"low": {"uptime": true, ...}, "med": {...}, "high": {...}}
+    # Only stores explicit user overrides. Missing = use default from detail_levels.
+    column_config: dict = field(default_factory=dict)
+    # Show abbreviated column headers above summary lines
+    show_column_headers: bool = False
 
     @classmethod
     def load(cls, session: str) -> "TUIPreferences":
@@ -452,14 +451,13 @@ class TUIPreferences:
                 if not isinstance(data, dict):
                     return cls()
 
-                # Default summary groups visibility
-                default_summary_groups = {
-                    "time": True, "llm_usage": True, "context": True, "git": True,
-                    "supervision": True, "priority": True, "performance": True,
-                    "subprocesses": True,
-                }
+                # Migration: map "custom" detail level to "full"
+                summary_detail = data.get("summary_detail", "low")
+                if summary_detail == "custom":
+                    summary_detail = "full"
+
                 return cls(
-                    summary_detail=data.get("summary_detail", "low"),
+                    summary_detail=summary_detail,
                     detail_lines=data.get("detail_lines", 5),
                     timeline_visible=data.get("timeline_visible", True),
                     daemon_panel_visible=data.get("daemon_panel_visible", False),
@@ -474,7 +472,8 @@ class TUIPreferences:
                     monochrome=data.get("monochrome", False),
                     show_cost=data.get("show_cost", False),
                     visited_stalled_agents=set(data.get("visited_stalled_agents", [])),
-                    summary_groups=data.get("summary_groups", default_summary_groups),
+                    column_config=data.get("column_config", {}),
+                    show_column_headers=data.get("show_column_headers", False),
                     timeline_hours=data.get("timeline_hours", 3.0),
                     notifications=data.get("notifications", "off"),
                 )
@@ -505,7 +504,8 @@ class TUIPreferences:
                     "monochrome": self.monochrome,
                     "show_cost": self.show_cost,
                     "visited_stalled_agents": list(self.visited_stalled_agents),
-                    "summary_groups": self.summary_groups,
+                    "column_config": self.column_config,
+                    "show_column_headers": self.show_column_headers,
                     "timeline_hours": self.timeline_hours,
                     "notifications": self.notifications,
                 }, f, indent=2)

{overcode-0.2.2 → overcode-0.2.3}/src/overcode/sister_poller.py

@@ -261,6 +261,9 @@ def _agent_to_session(agent: dict, host_name: str, source_url: str = "", source_
         # AI summaries from remote summarizer
         remote_activity_summary=agent.get("activity_summary", ""),
         remote_activity_summary_context=agent.get("activity_summary_context", ""),
+        # Raw daemon state for generic field forwarding — new SessionDaemonState
+        # fields automatically flow through without manual plumbing here.
+        remote_daemon_state=agent.get("daemon_state"),
     )