overcode 0.3.2__tar.gz → 0.3.4__tar.gz

{overcode-0.3.2/src/overcode.egg-info → overcode-0.3.4}/PKG-INFO

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

{overcode-0.3.2 → overcode-0.3.4}/pyproject.toml

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

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/bundled_skills.py

@@ -248,6 +248,32 @@ Jobs are visible in the TUI jobs view (press `J`) and auto-clean after 24h (conf
 }
 
 
+def get_available_skills(project_dir: str | None = None) -> list[str]:
+    """Scan for installed skill directories (user-level + project-level).
+
+    Returns sorted list of skill names found in ~/.claude/skills/
+    and optionally .claude/skills/ relative to project_dir.
+    """
+    skills: set[str] = set()
+
+    # User-level skills
+    user_skills = Path.home() / ".claude" / "skills"
+    if user_skills.is_dir():
+        for d in user_skills.iterdir():
+            if d.is_dir() and (d / "SKILL.md").exists():
+                skills.add(d.name)
+
+    # Project-level skills
+    if project_dir:
+        proj_skills = Path(project_dir) / ".claude" / "skills"
+        if proj_skills.is_dir():
+            for d in proj_skills.iterdir():
+                if d.is_dir() and (d / "SKILL.md").exists():
+                    skills.add(d.name)
+
+    return sorted(skills)
+
+
 def any_skills_stale() -> bool:
     """Check if any installed skills are outdated vs bundled versions."""
     base = Path.home() / ".claude" / "skills"

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/claude_config.py

@@ -137,6 +137,23 @@ class ClaudeConfigEditor:
                         results.append((event, cmd))
         return results
 
+    # ----- Hook detection -----
+
+    @staticmethod
+    def are_overcode_hooks_installed() -> bool:
+        """Check if core overcode hooks are installed at user level.
+
+        Requires at least UserPromptSubmit, Stop, and PostToolUse hooks
+        to consider hooks mode viable.
+        """
+        editor = ClaudeConfigEditor.user_level()
+        try:
+            editor.load()
+        except (ValueError, FileNotFoundError):
+            return False
+        core_events = ("UserPromptSubmit", "Stop", "PostToolUse")
+        return all(editor.has_hook(event, "overcode hook-handler") for event in core_events)
+
     # ----- Permission management -----
 
     def add_permission(self, tool_pattern: str) -> bool:

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/cli/agent.py

@@ -970,9 +970,10 @@ def show(
     else:
         # Daemon not running — fall back to direct detection
         from ..status_detector_factory import create_status_detector
+        from ..settings import resolve_detection_mode
         detector = create_status_detector(
             session,
-            strategy="hooks" if sess.hook_status_detection else "polling",
+            strategy=resolve_detection_mode(session),
         )
         status, activity, pane_content_raw = detector.detect_status(sess)
 

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/cli/config.py

@@ -44,8 +44,8 @@ CONFIG_TEMPLATE = """\
 #       start: "09:00"
 #       end: "17:00"
 
-# Time context hook settings (for 'overcode time-context')
-# time_context:
+# Enhanced context hook settings (agent identity, clock, presence, uptime)
+# enhanced_context:
 #   office_start: 9
 #   office_end: 17
 #   heartbeat_interval_minutes: 15  # omit to disable

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/cli/monitoring.py

@@ -18,7 +18,7 @@ def hook_handler_cmd():
 
     Called by Claude Code hooks, not by users directly.
     Reads event JSON from stdin, writes state for status detection,
-    and outputs time-context for UserPromptSubmit events.
+    and outputs enhanced context for UserPromptSubmit events.
     """
     from ..hook_handler import handle_hook_event
 

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/cli/split.py

@@ -263,20 +263,51 @@ def _setup_keybindings(linked_session: str = "", toggle_key: str = "") -> None:
     # --- Scrollback for the nested tmux in the bottom pane ---
     # The bottom pane runs a nested tmux client. The outer tmux
     # intercepts the prefix key, so copy-mode can't be entered
-    # normally. These bindings use `copy-mode -t` to directly enter
-    # copy mode in the inner session via the tmux API.
+    # normally.
+    #
+    # For local agents: use `copy-mode -t` to directly enter copy mode
+    # in the inner session via the tmux API (the linked session shares
+    # the actual agent panes, so scrollback is real).
+    #
+    # For SSH proxy windows (name starts with "ssh:"): the linked
+    # session pane is an SSH+tmux-attach client whose local scrollback
+    # is just rendering frames. Instead, forward PageUp/scroll through
+    # to the remote tmux which has the actual agent scrollback.
     if linked_session:
         # PageUp: enter copy mode + scroll up, but only when in the
         # bottom pane (pane_index != base) of the split window.
         # Top pane (Textual TUI) and other windows get normal PageUp.
+        #
+        # For SSH proxy windows: forward PageUp through the SSH pane
+        # so the *remote* tmux enters copy mode (the local proxy pane
+        # has no real scrollback — just rendered inner-tmux frames).
+        # For local agents: enter copy mode directly on the linked
+        # session which shares the real agent pane.
+        #
+        # Detection uses the @is_ssh_proxy window option (set by
+        # create_ssh_proxy_window) via a shell-based if-shell — this
+        # avoids tmux format expansion issues in stored bindings.
+        _ssh_check = (
+            f"tmux show-window-option -t {linked_session} -v @is_ssh_proxy "
+            "2>/dev/null | grep -q on"
+        )
         _tmux(
             "bind-key", "-n", "PPage",
             "if-shell", "-F",
             f"#{{&&:#{{==:#{{window_name}},{SPLIT_WINDOW_NAME}}},#{{!=:#{{pane_index}},{_base}}}}}",
-            f"copy-mode -t {linked_session} -u",
+            # SSH proxy: send prefix + PPage so the REMOTE tmux enters
+            # copy mode (the remote's root-table PPage is overridden by
+            # overcode, but prefix PPage still maps to copy-mode -u).
+            # Local: enter copy mode directly on the linked session.
+            f'if-shell "{_ssh_check}" '
+            f'"send-keys -t {linked_session} C-b ; '
+            f'send-keys -t {linked_session} PPage" '
+            f'"copy-mode -t {linked_session} -u"',
             "send-keys PPage",
         )
         # PageDown in the inner session's copy mode
+        # (send-keys works for both local and SSH proxy — for local it
+        # controls copy mode, for SSH proxy it forwards to remote tmux)
         _tmux(
             "bind-key", "-n", "NPage",
             "if-shell", "-F",
@@ -288,8 +319,9 @@ def _setup_keybindings(linked_session: str = "", toggle_key: str = "") -> None:
         # Without this, scrolling enters copy mode in the outer pane
         # which has no scrollback (just rendered inner tmux frames).
         #
-        # Strategy: enter copy mode in the inner session (no-op if
-        # already active), then send scroll-up/down commands to it.
+        # For local agents: enter copy mode in the inner session then
+        # send scroll commands. For SSH proxies: forward mouse events
+        # to the remote tmux through the pane.
         _in_bottom = (
             f"#{{&&:#{{==:#{{window_name}},{SPLIT_WINDOW_NAME}}},"
             f"#{{!=:#{{pane_index}},{_base}}}}}"
@@ -297,8 +329,14 @@ def _setup_keybindings(linked_session: str = "", toggle_key: str = "") -> None:
         _tmux(
             "bind-key", "-n", "WheelUpPane",
             "if-shell", "-F", _in_bottom,
-            f"copy-mode -t {linked_session} -e ; "
-            f"send-keys -t {linked_session} -X -N 3 scroll-up",
+            # SSH proxy: send prefix+PPage to enter copy mode on remote
+            # (no-op if already in copy mode, then PPage scrolls up).
+            # Local: enter copy mode + scroll up directly.
+            f'if-shell "{_ssh_check}" '
+            f'"send-keys -t {linked_session} C-b ; '
+            f'send-keys -t {linked_session} PPage" '
+            f'"copy-mode -t {linked_session} -e ; '
+            f'send-keys -t {linked_session} -X -N 3 scroll-up"',
             # Default behaviour for other contexts
             "if-shell -F '#{||:#{pane_in_mode},#{mouse_any_flag}}' "
             "'send-keys -M' 'copy-mode -e'",
@@ -306,7 +344,11 @@ def _setup_keybindings(linked_session: str = "", toggle_key: str = "") -> None:
         _tmux(
             "bind-key", "-n", "WheelDownPane",
             "if-shell", "-F", _in_bottom,
-            f"send-keys -t {linked_session} -X -N 3 scroll-down",
+            # SSH proxy: send NPage to remote (works in copy mode).
+            # Local: send scroll-down in local copy mode.
+            f'if-shell "{_ssh_check}" '
+            f'"send-keys -t {linked_session} NPage" '
+            f'"send-keys -t {linked_session} -X -N 3 scroll-down"',
             "send-keys -M",
         )
 
@@ -491,11 +533,10 @@ def tmux_layout(
         rprint("  tmux set -g terminal-features ''")
         return
 
-    # Verify agents session exists
+    # Create agents session if it doesn't exist (#397)
     if not _tmux_check("has-session", "-t", session):
-        rprint(f"[red]No tmux session '{session}' found.[/red]")
-        rprint(f"[dim]Launch some agents first, or create it: tmux new-session -d -s {session}[/dim]")
-        raise typer.Exit(1)
+        rprint(f"[dim]Creating tmux session '{session}'...[/dim]")
+        _tmux("new-session", "-d", "-s", session)
 
     # --- Toggle key selection (runs if not yet configured) ---
     from ..config import get_tmux_toggle_key, set_tmux_toggle_key

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/config.py

@@ -197,23 +197,35 @@ def get_web_time_presets() -> list:
     ]
 
 
-def get_time_context_config() -> dict:
-    """Get time context configuration for the time-context hook.
+def get_enhanced_context_config() -> dict:
+    """Get enhanced context configuration for the enhanced-context hook.
 
     Config format in ~/.overcode/config.yaml:
-        time_context:
+        enhanced_context:
           office_start: 9
           office_end: 17
           heartbeat_interval_minutes: 15  # omit to disable
 
+    Falls back to legacy 'time_context' key for backwards compatibility.
+
     Returns:
         Dict with office_start (int), office_end (int),
         heartbeat_interval_minutes (Optional[int])
     """
+    # Try new key first, fall back to legacy key
+    office_start = _get_config_value("enhanced_context.office_start")
+    if office_start is None:
+        office_start = _get_config_value("time_context.office_start", 9)
+    office_end = _get_config_value("enhanced_context.office_end")
+    if office_end is None:
+        office_end = _get_config_value("time_context.office_end", 17)
+    hb_interval = _get_config_value("enhanced_context.heartbeat_interval_minutes")
+    if hb_interval is None:
+        hb_interval = _get_config_value("time_context.heartbeat_interval_minutes")
     return {
-        "office_start": _get_config_value("time_context.office_start", 9),
-        "office_end": _get_config_value("time_context.office_end", 17),
-        "heartbeat_interval_minutes": _get_config_value("time_context.heartbeat_interval_minutes"),
+        "office_start": office_start,
+        "office_end": office_end,
+        "heartbeat_interval_minutes": hb_interval,
     }
 
 
@@ -365,9 +377,11 @@ def get_sisters_config() -> List[dict]:
           - name: "desktop"
             url: "http://localhost:25337"
             api_key: "secret"
+            ssh: "user@desktop"        # optional: enables tmux attach + auto-provisioning
+            tmux_session: "agents"     # optional: remote tmux session name (default: "agents")
 
     Returns:
-        List of dicts with name, url, and optional api_key. Empty list if unconfigured.
+        List of dicts with name, url, and optional api_key/ssh/tmux_session. Empty list if unconfigured.
     """
     sisters = _get_config_value("sisters", [])
     if not isinstance(sisters, list):
@@ -385,6 +399,13 @@ def get_sisters_config() -> List[dict]:
         api_key = s.get("api_key")
         if api_key:
             entry["api_key"] = api_key
+        # SSH connectivity (optional)
+        ssh = s.get("ssh")
+        if ssh:
+            entry["ssh"] = ssh
+        tmux_session = s.get("tmux_session")
+        if tmux_session:
+            entry["tmux_session"] = tmux_session
         result.append(entry)
 
     return result

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/dependency_check.py

@@ -15,13 +15,45 @@ from .exceptions import TmuxNotFoundError, ClaudeNotFoundError
 def find_executable(name: str) -> Optional[str]:
     """Find the path to an executable.
 
+    Checks PATH first, then common install locations that may not be on PATH
+    in non-login shells (e.g., web server subprocesses, SSH non-interactive).
+
     Args:
         name: Name of the executable
 
     Returns:
         Full path to executable, or None if not found
     """
-    return shutil.which(name)
+    import os
+    from pathlib import Path
+
+    path = shutil.which(name)
+    if path:
+        return path
+
+    # Check common locations not always on PATH in non-login shells
+    return _find_in_fallback_dirs(name)
+
+
+def _find_in_fallback_dirs(name: str) -> Optional[str]:
+    """Check common install directories for an executable."""
+    import os
+    from pathlib import Path
+
+    home = Path.home()
+    fallback_dirs = [
+        home / ".local" / "bin",           # pip/pipx, claude CLI
+        home / ".npm-global" / "bin",      # npm global
+        home / ".nvm" / "current" / "bin", # nvm
+        Path("/usr/local/bin"),
+        Path("/opt/homebrew/bin"),          # macOS ARM homebrew
+    ]
+    for d in fallback_dirs:
+        candidate = d / name
+        if candidate.is_file() and os.access(candidate, os.X_OK):
+            return str(candidate)
+
+    return None
 
 
 def _check_executable(

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/history_reader.py

@@ -33,8 +33,12 @@ CLAUDE_PROJECTS_PATH = Path.home() / ".claude" / "projects"
 
 # Model name → context window size in tokens.
 # Default 200K for unknown models.  Update as new models ship.
+# Claude Code with 1M context reports the same model ID — we detect
+# the actual context size from token counts at runtime and update here
+# for the models known to support extended context.
 MODEL_CONTEXT_WINDOWS: Dict[str, int] = {
-    "claude-opus-4-6": 200_000,
+    "claude-opus-4-6": 1_000_000,
+    "claude-sonnet-4-6": 1_000_000,
     "claude-sonnet-4-5-20250929": 200_000,
     "claude-haiku-4-5-20251001": 200_000,
     "claude-3-5-sonnet-20241022": 200_000,
@@ -45,6 +49,32 @@ MODEL_CONTEXT_WINDOWS: Dict[str, int] = {
 }
 DEFAULT_CONTEXT_WINDOW = 200_000
 
+# Model ID → human-readable short name for display
+MODEL_SHORT_NAMES: Dict[str, str] = {
+    "claude-opus-4-6": "Op4.6",
+    "claude-sonnet-4-6": "Sn4.6",
+    "claude-sonnet-4-5-20250929": "Sn4.5",
+    "claude-haiku-4-5-20251001": "Hk4.5",
+    "claude-3-5-sonnet-20241022": "Sn3.5",
+    "claude-3-5-haiku-20241022": "Hk3.5",
+    "claude-3-opus-20240229": "Op3",
+    "claude-3-sonnet-20240229": "Sn3",
+    "claude-3-haiku-20240307": "Hk3",
+}
+
+
+def model_short_name(model: Optional[str]) -> str:
+    """Return a short display name for a model ID.
+
+    Examples:
+        "claude-opus-4-6" → "Op4.6"
+        "claude-haiku-4-5-20251001" → "Hk4.5"
+        "unknown-model" → "unknown-model"
+    """
+    if not model:
+        return ""
+    return MODEL_SHORT_NAMES.get(model, model)
+
 
 def model_context_window(model: Optional[str]) -> int:
     """Return the context window size for a given model name.

{overcode-0.3.2 → overcode-0.3.4}/src/overcode/hook_handler.py

@@ -2,7 +2,7 @@
 
 A single command (`overcode hook-handler`) handles all hook events.
 It reads stdin JSON from Claude Code, writes state files for hook-based
-status detection, and outputs time-context for UserPromptSubmit events.
+status detection, and outputs enhanced context for UserPromptSubmit events.
 
 Hook registrations (all use the same command):
     UserPromptSubmit  -> overcode hook-handler
@@ -25,8 +25,11 @@ logger = logging.getLogger(__name__)
 # All hooks that overcode installs
 OVERCODE_HOOKS: list[tuple[str, str]] = [
     ("UserPromptSubmit", "overcode hook-handler"),
+    ("PreToolUse", "overcode hook-handler"),
     ("PostToolUse", "overcode hook-handler"),
+    ("PostToolUseFailure", "overcode hook-handler"),
     ("Stop", "overcode hook-handler"),
+    ("StopFailure", "overcode hook-handler"),
     ("PermissionRequest", "overcode hook-handler"),
     ("SessionEnd", "overcode hook-handler"),
 ]
@@ -107,7 +110,7 @@ def handle_hook_event() -> None:
     # Write state file for status detection
     write_hook_state(event, tmux_session, session_name, tool_name=tool_name, tool_input=tool_input)
 
-    # For UserPromptSubmit, check budget and output time-context
+    # For UserPromptSubmit, check budget and output enhanced context
     if event == "UserPromptSubmit":
         from .time_context import _load_daemon_state, _find_session_in_state
 
@@ -124,8 +127,8 @@ def handle_hook_event() -> None:
                 )
                 sys.exit(2)
 
-        from .time_context import generate_time_context
+        from .time_context import generate_enhanced_context
 
-        line = generate_time_context(tmux_session, session_name)
+        line = generate_enhanced_context(tmux_session, session_name)
         if line:
             print(line)