overcode 0.1.1__tar.gz → 0.1.2__tar.gz

{overcode-0.1.1/src/overcode.egg-info → overcode-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.1.1
+Version: 0.1.2
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode
@@ -43,6 +43,18 @@ A TUI supervisor for managing multiple Claude Code agents in tmux.
 
 Monitor status, costs, and activity across all your agents from a single dashboard.
 
+## Screenshots
+
+**Split-screen with tmux sync** - Monitor agents in the top pane while viewing live agent output below. Press `p` to enable pane sync, then navigate with `j/k` to switch the bottom pane to the selected agent's window.
+
+![Overcode split-screen with tmux sync](docs/images/overcode-split-screen.png)
+
+> **iTerm2 setup**: Use `Cmd+Shift+D` to split horizontally. Run `overcode monitor` in the top pane and `tmux attach -t agents` in the bottom pane.
+
+**Preview mode** - Press `m` to toggle List+Preview mode. Shows collapsed agent list with detailed terminal output preview for the selected agent.
+
+![Overcode preview mode](docs/images/overcode-preview-mode.png)
+
 ## Installation
 
 ```bash

{overcode-0.1.1 → overcode-0.1.2}/README.md

@@ -4,6 +4,18 @@ A TUI supervisor for managing multiple Claude Code agents in tmux.
 
 Monitor status, costs, and activity across all your agents from a single dashboard.
 
+## Screenshots
+
+**Split-screen with tmux sync** - Monitor agents in the top pane while viewing live agent output below. Press `p` to enable pane sync, then navigate with `j/k` to switch the bottom pane to the selected agent's window.
+
+![Overcode split-screen with tmux sync](docs/images/overcode-split-screen.png)
+
+> **iTerm2 setup**: Use `Cmd+Shift+D` to split horizontally. Run `overcode monitor` in the top pane and `tmux attach -t agents` in the bottom pane.
+
+**Preview mode** - Press `m` to toggle List+Preview mode. Shows collapsed agent list with detailed terminal output preview for the selected agent.
+
+![Overcode preview mode](docs/images/overcode-preview-mode.png)
+
 ## Installation
 
 ```bash

{overcode-0.1.1 → overcode-0.1.2}/pyproject.toml

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

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/__init__.py

@@ -2,4 +2,4 @@
 Overcode - A supervisor for managing multiple Claude Code instances.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/monitor_daemon.py

@@ -614,8 +614,8 @@ class MonitorDaemon:
                     session_state.current_activity = activity
                     session_states.append(session_state)
 
-                    # Log status history
-                    log_agent_status(session.name, status, activity)
+                    # Log status history to session-specific file
+                    log_agent_status(session.name, status, activity, history_file=self.history_path)
 
                     # Track if any session is not waiting for user
                     if status != "waiting_user":

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/session_manager.py

@@ -88,6 +88,9 @@ class Session:
     # Statistics
     stats: SessionStats = field(default_factory=SessionStats)
 
+    # Sleep mode - agent is paused and excluded from stats
+    is_asleep: bool = False
+
     def to_dict(self) -> dict:
         data = asdict(self)
         # Convert stats to dict

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/status_constants.py

@@ -17,6 +17,7 @@ STATUS_NO_INSTRUCTIONS = "no_instructions"
 STATUS_WAITING_SUPERVISOR = "waiting_supervisor"
 STATUS_WAITING_USER = "waiting_user"
 STATUS_TERMINATED = "terminated"  # Claude Code exited, shell prompt showing
+STATUS_ASLEEP = "asleep"  # Human marked agent as paused/snoozed (excluded from stats)
 
 # All valid agent status values
 ALL_STATUSES = [
@@ -25,6 +26,7 @@ ALL_STATUSES = [
     STATUS_WAITING_SUPERVISOR,
     STATUS_WAITING_USER,
     STATUS_TERMINATED,
+    STATUS_ASLEEP,
 ]
 
 
@@ -60,6 +62,7 @@ STATUS_EMOJIS = {
     STATUS_WAITING_SUPERVISOR: "🟠",
     STATUS_WAITING_USER: "🔴",
     STATUS_TERMINATED: "⚫",  # Black circle - Claude exited
+    STATUS_ASLEEP: "💤",  # Sleeping/snoozed - human marked as paused
 }
 
 
@@ -78,6 +81,7 @@ STATUS_COLORS = {
     STATUS_WAITING_SUPERVISOR: "orange1",
     STATUS_WAITING_USER: "red",
     STATUS_TERMINATED: "dim",  # Grey for terminated
+    STATUS_ASLEEP: "dim",  # Grey for sleeping
 }
 
 
@@ -96,6 +100,7 @@ STATUS_SYMBOLS = {
     STATUS_WAITING_SUPERVISOR: ("🟠", "orange1"),
     STATUS_WAITING_USER: ("🔴", "red"),
     STATUS_TERMINATED: ("⚫", "dim"),
+    STATUS_ASLEEP: ("💤", "dim"),  # Sleeping/snoozed
 }
 
 
@@ -114,6 +119,7 @@ AGENT_TIMELINE_CHARS = {
     STATUS_WAITING_SUPERVISOR: "▒",
     STATUS_WAITING_USER: "░",
     STATUS_TERMINATED: "×",  # Small X - terminated
+    STATUS_ASLEEP: "z",  # Lowercase z for sleeping
 }
 
 
@@ -188,3 +194,8 @@ def is_waiting_status(status: str) -> bool:
 def is_user_blocked(status: str) -> bool:
     """Check if status indicates user intervention is required."""
     return status == STATUS_WAITING_USER
+
+
+def is_asleep(status: str) -> bool:
+    """Check if status indicates agent is asleep (paused by human)."""
+    return status == STATUS_ASLEEP

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/status_detector.py

@@ -116,6 +116,13 @@ class StatusDetector:
 
         last_line = last_lines[-1]
 
+        # Check for spawn failure FIRST (command not found, etc.)
+        # This should be detected before shell prompt check because the error
+        # message appears before the shell prompt returns
+        spawn_error = self._detect_spawn_failure(lines)
+        if spawn_error:
+            return self.STATUS_WAITING_USER, spawn_error, content
+
         # Check for shell prompt (Claude Code has terminated)
         # Shell prompts typically end with $ or % and have username@hostname pattern
         # Also check for absence of Claude Code UI elements
@@ -297,6 +304,37 @@ class StatusDetector:
         ]
         return '\n'.join(filtered)
 
+    def _detect_spawn_failure(self, lines: list) -> str | None:
+        """Detect if the claude command failed to spawn.
+
+        Checks for common error messages like "command not found" that indicate
+        the claude CLI is not installed or not in PATH.
+
+        Args:
+            lines: All lines from the pane content
+
+        Returns:
+            Error message string if spawn failure detected, None otherwise
+        """
+        # Check recent lines for spawn failure patterns
+        # We check the last 20 lines to catch the error message
+        recent_lines = lines[-20:] if len(lines) > 20 else lines
+        recent_text = ' '.join(recent_lines).lower()
+
+        if matches_any(recent_text, self.patterns.spawn_failure_patterns):
+            # Find the specific error line for a better message
+            for line in reversed(recent_lines):
+                line_lower = line.lower()
+                if any(p.lower() in line_lower for p in self.patterns.spawn_failure_patterns):
+                    # Extract just the error part, clean it up
+                    error_msg = line.strip()
+                    if len(error_msg) > 80:
+                        error_msg = error_msg[:77] + "..."
+                    return f"Spawn failed: {error_msg}"
+            return "Spawn failed: claude command not found - is Claude CLI installed?"
+
+        return None
+
     def _is_shell_prompt(self, lines: list) -> bool:
         """Detect if we're at a shell prompt (Claude Code has exited).
 

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/status_patterns.py

@@ -115,6 +115,18 @@ class StatusPatterns:
     # Format: "  /command-name     Description text"
     command_menu_pattern: str = r"^\s*/[\w-]+\s{2,}\S"
 
+    # Spawn failure patterns - when the claude command fails to start
+    # These indicate the command was not found or failed to execute
+    # Checked against pane content to detect failed spawns
+    spawn_failure_patterns: List[str] = field(default_factory=lambda: [
+        "command not found",
+        "not found:",  # zsh style: "zsh: command not found: claude"
+        "no such file or directory",
+        "permission denied",
+        "cannot execute",
+        "is not recognized",  # Windows-style (for future compatibility)
+    ])
+
 
 # Default patterns instance
 DEFAULT_PATTERNS = StatusPatterns()

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/tui.py

@@ -30,7 +30,7 @@ from .launcher import ClaudeLauncher
 from .status_detector import StatusDetector
 from .status_constants import STATUS_WAITING_USER
 from .history_reader import get_session_stats, ClaudeSessionStats
-from .settings import signal_activity, get_session_dir, TUIPreferences, DAEMON_VERSION  # Activity signaling to daemon
+from .settings import signal_activity, get_session_dir, get_agent_history_path, TUIPreferences, DAEMON_VERSION  # Activity signaling to daemon
 from .monitor_daemon_state import MonitorDaemonState, get_monitor_daemon_state
 from .monitor_daemon import (
     is_monitor_daemon_running,
@@ -99,14 +99,21 @@ class DaemonStatusBar(Static):
     Presence is shown only when available (macOS with monitor daemon running).
     """
 
-    def __init__(self, tmux_session: str = "agents", *args, **kwargs):
+    def __init__(self, tmux_session: str = "agents", session_manager: Optional["SessionManager"] = None, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self.tmux_session = tmux_session
         self.monitor_state: Optional[MonitorDaemonState] = None
+        self._session_manager = session_manager
+        self._asleep_session_ids: set = set()  # Cache of asleep session IDs
 
     def update_status(self) -> None:
         """Refresh daemon state from file"""
         self.monitor_state = get_monitor_daemon_state(self.tmux_session)
+        # Update cache of asleep session IDs from session manager
+        if self._session_manager:
+            self._asleep_session_ids = {
+                s.id for s in self._session_manager.list_sessions() if s.is_asleep
+            }
         self.refresh()
 
     def render(self) -> Text:
@@ -171,13 +178,18 @@ class DaemonStatusBar(Static):
         # Spin rate stats (only when monitor running with sessions)
         if monitor_running and self.monitor_state.sessions:
             content.append(" │ ", style="dim")
-            sessions = self.monitor_state.sessions
-            total_agents = len(sessions)
-            green_now = self.monitor_state.green_sessions
+            # Filter out sleeping agents from stats
+            all_sessions = self.monitor_state.sessions
+            active_sessions = [s for s in all_sessions if s.session_id not in self._asleep_session_ids]
+            sleeping_count = len(all_sessions) - len(active_sessions)
+
+            total_agents = len(active_sessions)
+            # Recalculate green_now excluding sleeping agents
+            green_now = sum(1 for s in active_sessions if s.current_status == "running")
 
-            # Calculate mean spin rate from green_time percentages
+            # Calculate mean spin rate from green_time percentages (exclude sleeping)
             mean_spin = 0.0
-            for s in sessions:
+            for s in active_sessions:
                 total_time = s.green_time_seconds + s.non_green_time_seconds
                 if total_time > 0:
                     mean_spin += s.green_time_seconds / total_time
@@ -185,11 +197,13 @@ class DaemonStatusBar(Static):
             content.append("Spin: ", style="bold")
             content.append(f"{green_now}", style="bold green" if green_now > 0 else "dim")
             content.append(f"/{total_agents}", style="dim")
+            if sleeping_count > 0:
+                content.append(f" 💤{sleeping_count}", style="dim")  # Show sleeping count
             if mean_spin > 0:
                 content.append(f" μ{mean_spin:.1f}x", style="cyan")
 
-            # Safe break duration (time until 50%+ agents need attention)
-            safe_break = calculate_safe_break_duration(sessions)
+            # Safe break duration (time until 50%+ agents need attention) - exclude sleeping
+            safe_break = calculate_safe_break_duration(active_sessions)
             if safe_break is not None:
                 content.append(" │ ", style="dim")
                 content.append("☕", style="bold")
@@ -252,9 +266,10 @@ class StatusTimeline(Static):
     MIN_TIMELINE = 20     # Minimum timeline width
     DEFAULT_TIMELINE = 60 # Fallback if can't detect width
 
-    def __init__(self, sessions: list, *args, **kwargs):
+    def __init__(self, sessions: list, tmux_session: str = "agents", *args, **kwargs):
         super().__init__(*args, **kwargs)
         self.sessions = sessions
+        self.tmux_session = tmux_session
         self._presence_history = []
         self._agent_histories = {}
 
@@ -281,8 +296,9 @@ class StatusTimeline(Static):
         # Get agent names from sessions
         agent_names = [s.name for s in sessions]
 
-        # Read all agent history and group by agent
-        all_history = read_agent_status_history(hours=self.TIMELINE_HOURS)
+        # Read agent history from session-specific file and group by agent
+        history_path = get_agent_history_path(self.tmux_session)
+        all_history = read_agent_status_history(hours=self.TIMELINE_HOURS, history_file=history_path)
         for ts, agent, status, activity in all_history:
             if agent not in self._agent_histories:
                 self._agent_histories[agent] = []
@@ -355,8 +371,8 @@ class StatusTimeline(Static):
                 else:
                     content.append("─", style="dim")
         elif not MACOS_APIS_AVAILABLE:
-            # Show install instructions when presence deps not installed
-            msg = "not installed - pip install overcode[presence]"
+            # Show install instructions when presence deps not installed (macOS only)
+            msg = "macOS only - pip install overcode[presence]"
             content.append(msg[:width], style="dim italic")
         else:
             content.append("─" * width, style="dim")
@@ -661,9 +677,17 @@ class SessionSummary(Static, can_focus=True):
             self.post_message(self.StalledAgentVisited(self.session.id))
 
     def on_focus(self) -> None:
-        """Handle focus event - mark stalled agent as visited"""
+        """Handle focus event - mark stalled agent as visited and update selection"""
         if self.is_unvisited_stalled:
             self.post_message(self.StalledAgentVisited(self.session.id))
+        # Notify app to update selection highlighting
+        self.post_message(self.SessionSelected(self.session.id))
+
+    class SessionSelected(events.Message):
+        """Message sent when a session is selected/focused"""
+        def __init__(self, session_id: str):
+            super().__init__()
+            self.session_id = session_id
 
     class ExpandedChanged(events.Message):
         """Message sent when expanded state changes"""
@@ -738,7 +762,11 @@ class SessionSummary(Static, can_focus=True):
         # Update detected status for display
         # NOTE: Time tracking removed - Monitor Daemon is the single source of truth
         # The session.stats values are read from what Monitor Daemon has persisted
-        self.detected_status = status
+        # If session is asleep, keep the asleep status instead of the detected status
+        if self.session.is_asleep:
+            self.detected_status = "asleep"
+        else:
+            self.detected_status = status
 
         # Use pre-fetched claude stats (no file I/O on main thread)
         if claude_stats is not None:
@@ -844,15 +872,18 @@ class SessionSummary(Static, can_focus=True):
                 content.append(f" {pct:>3.0f}%", style=f"bold green{bg}" if pct >= 50 else f"bold red{bg}")
 
         # Always show: token usage (from Claude Code)
+        # ALIGNMENT: context indicator is always 7 chars " c@NNN%" (or placeholder)
         if self.claude_stats is not None:
             content.append(f" Σ{format_tokens(self.claude_stats.total_tokens):>6}", style=f"bold orange1{bg}")
             # Show current context window usage as percentage (assuming 200K max)
             if self.claude_stats.current_context_tokens > 0:
                 max_context = 200_000  # Claude models have 200K context window
                 ctx_pct = min(100, self.claude_stats.current_context_tokens / max_context * 100)
-                content.append(f" c@{ctx_pct:.0f}%", style=f"bold orange1{bg}")
+                content.append(f" c@{ctx_pct:>3.0f}%", style=f"bold orange1{bg}")
+            else:
+                content.append(" c@  -%", style=f"dim orange1{bg}")
         else:
-            content.append("      -", style=f"dim orange1{bg}")
+            content.append("      - c@  -%", style=f"dim orange1{bg}")
 
         # Git diff stats (outstanding changes since last commit)
         # ALIGNMENT: Use fixed widths - low/med: 4 chars "Δnn ", full: 16 chars "Δnn +nnnn -nnnn"
@@ -995,10 +1026,13 @@ class PreviewPane(Static):
 
     def render(self) -> Text:
         content = Text()
-        # Header with session name
+        # Use widget width for layout, with sensible fallback
+        pane_width = self.size.width if self.size.width > 0 else 80
+
+        # Header with session name - pad to full pane width
         header = f"─── {self.session_name} " if self.session_name else "─── Preview "
         content.append(header, style="bold cyan")
-        content.append("─" * max(0, 60 - len(header)), style="dim")
+        content.append("─" * max(0, pane_width - len(header)), style="dim")
         content.append("\n")
 
         if not self.content_lines:
@@ -1008,9 +1042,11 @@ class PreviewPane(Static):
             # Reserve 2 lines for header and some padding
             available_lines = max(10, self.size.height - 2) if self.size.height > 0 else 30
             # Show last N lines of output - plain text, no decoration
+            # Truncate lines to pane width to match tmux display
+            max_line_len = max(pane_width - 1, 40)  # Leave room for newline, minimum 40
             for line in self.content_lines[-available_lines:]:
-                # Truncate long lines
-                display_line = line[:200] if len(line) > 200 else line
+                # Truncate long lines to pane width
+                display_line = line[:max_line_len] if len(line) > max_line_len else line
                 content.append(display_line + "\n")
 
         return content
@@ -1394,6 +1430,12 @@ class SupervisorTUI(App):
         text-style: bold;
     }
 
+    /* .selected class preserves highlight when app loses focus */
+    SessionSummary.selected {
+        background: #2d4a5a;
+        text-style: bold;
+    }
+
     #help-text {
         dock: bottom;
         height: 1;
@@ -1555,6 +1597,8 @@ class SupervisorTUI(App):
         ("p", "toggle_tmux_sync", "Pane sync"),
         # Web server toggle
         ("w", "toggle_web_server", "Web dashboard"),
+        # Sleep mode toggle - mark agent as paused (excluded from stats)
+        ("z", "toggle_sleep", "Sleep mode"),
     ]
 
     # Detail level cycles through 5, 10, 20, 50 lines
@@ -1617,8 +1661,8 @@ class SupervisorTUI(App):
     def compose(self) -> ComposeResult:
         """Create child widgets"""
         yield Header(show_clock=True)
-        yield DaemonStatusBar(tmux_session=self.tmux_session, id="daemon-status")
-        yield StatusTimeline([], id="timeline")
+        yield DaemonStatusBar(tmux_session=self.tmux_session, session_manager=self.session_manager, id="daemon-status")
+        yield StatusTimeline([], tmux_session=self.tmux_session, id="timeline")
         yield DaemonPanel(tmux_session=self.tmux_session, id="daemon-panel")
         yield ScrollableContainer(id="sessions-container")
         yield PreviewPane(id="preview-pane")
@@ -2054,6 +2098,15 @@ class SupervisorTUI(App):
                 widget.refresh()
                 break
 
+    def on_session_summary_session_selected(self, message: SessionSummary.SessionSelected) -> None:
+        """Handle session selection - update .selected class to preserve highlight when unfocused"""
+        session_id = message.session_id
+        for widget in self.query(SessionSummary):
+            if widget.session.id == session_id:
+                widget.add_class("selected")
+            else:
+                widget.remove_class("selected")
+
     def action_toggle_focused(self) -> None:
         """Toggle expansion of focused session (only in tree mode)"""
         if self.view_mode == "list_preview":
@@ -2221,9 +2274,9 @@ class SupervisorTUI(App):
         """Update preview pane with focused session's content."""
         try:
             preview = self.query_one("#preview-pane", PreviewPane)
-            focused = self.focused
-            if isinstance(focused, SessionSummary):
-                preview.update_from_widget(focused)
+            widgets = self._get_widgets_in_session_order()
+            if widgets and 0 <= self.focused_session_index < len(widgets):
+                preview.update_from_widget(widgets[self.focused_session_index])
         except NoMatches:
             pass
 
@@ -2534,6 +2587,38 @@ class SupervisorTUI(App):
 
         self.update_daemon_status()
 
+    def action_toggle_sleep(self) -> None:
+        """Toggle sleep mode for the focused agent.
+
+        Sleep mode marks an agent as 'asleep' (human doesn't want it to do anything).
+        Sleeping agents are excluded from stats calculations.
+        Press z again to wake the agent.
+        """
+        focused = self.focused
+        if not isinstance(focused, SessionSummary):
+            self.notify("No agent focused", severity="warning")
+            return
+
+        session = focused.session
+        new_asleep_state = not session.is_asleep
+
+        # Update the session in the session manager
+        self.session_manager.update_session(session.id, is_asleep=new_asleep_state)
+
+        # Update the local session object
+        session.is_asleep = new_asleep_state
+
+        # Update the widget's display status if sleeping
+        if new_asleep_state:
+            focused.detected_status = "asleep"
+            self.notify(f"Agent '{session.name}' is now asleep (excluded from stats)", severity="information")
+        else:
+            # Wake up - status will be refreshed on next update cycle
+            self.notify(f"Agent '{session.name}' is now awake", severity="information")
+
+        # Force a refresh
+        focused.refresh()
+
     def action_kill_focused(self) -> None:
         """Kill the currently focused agent (requires confirmation)."""
         focused = self.focused

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/web_api.py

@@ -12,6 +12,7 @@ from .monitor_daemon_state import (
     MonitorDaemonState,
     SessionDaemonState,
 )
+from .settings import get_agent_history_path
 from .status_history import read_agent_status_history
 from .tui_helpers import (
     format_duration,
@@ -232,8 +233,9 @@ def get_timeline_data(tmux_session: str, hours: float = 3.0, slots: int = 60) ->
         "status_colors": {k: get_web_color(get_status_color(k)) for k in AGENT_TIMELINE_CHARS},
     }
 
-    # Get agent history
-    all_history = read_agent_status_history(hours=hours)
+    # Get agent history from session-specific file
+    history_path = get_agent_history_path(tmux_session)
+    all_history = read_agent_status_history(hours=hours, history_file=history_path)
 
     # Group by agent
     agent_histories: Dict[str, List] = {}
@@ -391,12 +393,14 @@ def _session_to_analytics_record(session, is_archived: bool) -> Dict[str, Any]:
 
 
 def get_analytics_timeline(
+    tmux_session: str,
     start: Optional[datetime] = None,
     end: Optional[datetime] = None,
 ) -> Dict[str, Any]:
     """Get agent status timeline within a time range.
 
     Args:
+        tmux_session: tmux session name
         start: Start of time range
         end: End of time range
 
@@ -413,8 +417,9 @@ def get_analytics_timeline(
 
     hours = (end - start).total_seconds() / 3600.0
 
-    # Get agent status history
-    all_history = read_agent_status_history(hours=hours)
+    # Get agent status history from session-specific file
+    history_path = get_agent_history_path(tmux_session)
+    all_history = read_agent_status_history(hours=hours, history_file=history_path)
 
     # Filter to time range and group by agent
     agent_events: Dict[str, List[Dict[str, Any]]] = {}
@@ -458,12 +463,14 @@ def get_analytics_timeline(
 
 
 def get_analytics_stats(
+    tmux_session: str,
     start: Optional[datetime] = None,
     end: Optional[datetime] = None,
 ) -> Dict[str, Any]:
     """Get aggregate statistics for a time range.
 
     Args:
+        tmux_session: tmux session name
         start: Start of time range
         end: End of time range
 
@@ -498,7 +505,7 @@ def get_analytics_stats(
     work_time_stats = _calculate_percentiles(all_work_times)
 
     # Calculate presence-based efficiency metrics
-    presence_efficiency = _calculate_presence_efficiency(start, end)
+    presence_efficiency = _calculate_presence_efficiency(tmux_session, start, end)
 
     return {
         "time_range": {
@@ -552,6 +559,7 @@ def _calculate_percentiles(values: List[float]) -> Dict[str, float]:
 
 
 def _calculate_presence_efficiency(
+    tmux_session: str,
     start: Optional[datetime] = None,
     end: Optional[datetime] = None,
     sample_interval_seconds: int = 60,
@@ -564,6 +572,7 @@ def _calculate_presence_efficiency(
     - AFK periods: user presence state = 1 (locked) or 2 (inactive)
 
     Args:
+        tmux_session: tmux session name
         start: Start of time range
         end: End of time range
         sample_interval_seconds: How often to sample (default 60s)
@@ -581,8 +590,9 @@ def _calculate_presence_efficiency(
 
     hours = (end - start).total_seconds() / 3600.0
 
-    # Get agent status history: list of (timestamp, agent_name, status, activity)
-    agent_history = read_agent_status_history(hours=hours)
+    # Get agent status history from session-specific file
+    history_path = get_agent_history_path(tmux_session)
+    agent_history = read_agent_status_history(hours=hours, history_file=history_path)
 
     # Get presence history: list of (timestamp, state)
     presence_history = read_presence_history(hours=hours)

{overcode-0.1.1 → overcode-0.1.2}/src/overcode/web_server.py

@@ -338,6 +338,9 @@ def toggle_web_server(session: str, port: int = 8080) -> Tuple[bool, str]:
 class AnalyticsHandler(BaseHTTPRequestHandler):
     """HTTP request handler for analytics dashboard."""
 
+    # Set by run_analytics_server before starting
+    tmux_session: str = "agents"
+
     def do_GET(self) -> None:
         """Handle GET requests."""
         parsed = urlparse(self.path)
@@ -355,9 +358,9 @@ class AnalyticsHandler(BaseHTTPRequestHandler):
         elif path == "/api/analytics/sessions":
             self._serve_json(get_analytics_sessions(start, end))
         elif path == "/api/analytics/timeline":
-            self._serve_json(get_analytics_timeline(start, end))
+            self._serve_json(get_analytics_timeline(self.tmux_session, start, end))
         elif path == "/api/analytics/stats":
-            self._serve_json(get_analytics_stats(start, end))
+            self._serve_json(get_analytics_stats(self.tmux_session, start, end))
         elif path == "/api/analytics/daily":
             self._serve_json(get_analytics_daily(start, end))
         elif path == "/api/analytics/presets":
@@ -434,13 +437,18 @@ class AnalyticsHandler(BaseHTTPRequestHandler):
 def run_analytics_server(
     host: str = "127.0.0.1",
     port: int = 8080,
+    tmux_session: str = "agents",
 ) -> None:
     """Run the analytics web dashboard server.
 
     Args:
         host: Host to bind to (default: 127.0.0.1 for local only)
         port: Port to listen on (default: 8080)
+        tmux_session: tmux session name for session-specific data
     """
+    # Set the tmux session on the handler class
+    AnalyticsHandler.tmux_session = tmux_session
+
     server_address = (host, port)
 
     try:

{overcode-0.1.1 → overcode-0.1.2/src/overcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.1.1
+Version: 0.1.2
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode
@@ -43,6 +43,18 @@ A TUI supervisor for managing multiple Claude Code agents in tmux.
 
 Monitor status, costs, and activity across all your agents from a single dashboard.
 
+## Screenshots
+
+**Split-screen with tmux sync** - Monitor agents in the top pane while viewing live agent output below. Press `p` to enable pane sync, then navigate with `j/k` to switch the bottom pane to the selected agent's window.
+
+![Overcode split-screen with tmux sync](docs/images/overcode-split-screen.png)
+
+> **iTerm2 setup**: Use `Cmd+Shift+D` to split horizontally. Run `overcode monitor` in the top pane and `tmux attach -t agents` in the bottom pane.
+
+**Preview mode** - Press `m` to toggle List+Preview mode. Shows collapsed agent list with detailed terminal output preview for the selected agent.
+
+![Overcode preview mode](docs/images/overcode-preview-mode.png)
+
 ## Installation
 
 ```bash