Debugging tmux-opencode-integrated Status Detection

When to Use

• Status icons showing wrong state (e.g., showing ERROR when agent is IDLE)

• Adding new patterns for agent detection

• Testing pattern matching against real pane content

Quick Commands

List all agent panes

tmux list-panes -a -F "#{session_name}:#{window_name}.#{pane_index} #{pane_current_command}" | grep -E "opencode|claude|amp"

Capture pane content (raw)

tmux capture-pane -t "main:1" -p -S -30 | tail -40

Capture with control chars visible

tmux capture-pane -t "main:1" -p -S -30 | cat -v | tail -40

Check if pattern exists in pane

tmux capture-pane -t "main:1" -p -S -20 | grep -o "pattern"

Debug Script

Create /tmp/debug_status.py and run with the Nix Python that has libtmux:

import sys sys.path.insert(0, "/Users/emiller/.config/dotfiles/packages/tmux-opencode-integrated/scripts") import smart_name import re

import libtmux server = libtmux.Server() for session in server.sessions: for window in session.windows: for pane in window.panes: program = smart_name.get_pane_program(pane) if program in smart_name.AGENT_PROGRAMS: print(f"\n=== {program} in {session.name}:{window.name} ===") try: cmd_output = pane.cmd("capture-pane", "-p", "-S", "-20").stdout if isinstance(cmd_output, list): content = "\n".join(cmd_output) else: content = str(cmd_output)

                cleaned = smart_name.strip_ansi_and_control(content)
                print(f"Last 300 chars (cleaned):\n{cleaned[-300:]}")
                print(f"\n--- Status: {smart_name.get_opencode_status(pane)} ---")
            except Exception as e:
                print(f"Error: {e}")

Find the Nix Python with libtmux

Build the package and get the store path

nix build .#tmux-opencode-integrated --no-link --print-out-paths

Check wrapper to find Python path

head -10 /nix/store/<hash>-tmux-opencode-integrated-*/share/tmux-plugins/tmux-opencode-integrated/scripts/smart-name.sh

Run debug script with that Python

/nix/store/<python-hash>-python3-*-env/bin/python3 /tmp/debug_status.py

Pattern Testing

Test patterns against sample content:

import re

content = """ctrl+t variants tab agents ctrl+p commands • OpenCode 1.1.30"""

patterns = [ (r"OpenCode \d+.\d+.\d+", "IDLE - version"), (r"ctrl+p commands", "IDLE - status bar"), (r"esc interrupt", "BUSY - can interrupt"), (r"Esc to cancel", "BUSY - can cancel"), (r"■■■", "BUSY - progress bar"), ]

for pattern, desc in patterns: if re.search(pattern, content, re.IGNORECASE): print(f"✓ {desc}: {pattern}")

Status Priority

Order matters - first match wins:

• ERROR - Traceback, panic, FATAL ERROR, API errors

• WAITING - Allow once?, Permission required, yes/no/skip prompts

• BUSY - Thinking..., spinners, Running tools, esc interrupt

• IDLE - Input prompt, context display, OpenCode version, ctrl+p commands

• UNKNOWN - No patterns matched (fallback)

Adding New Patterns

• Capture real pane content with the debug script above

• Identify unique text that indicates the state

• Add pattern to appropriate list in smart_name.py

• Add test case in tests/test_smart_name.py

• Run tests: uvx pytest tests/test_smart_name.py -v

• Rebuild: nix build .#tmux-opencode-integrated

Common Issues

"No module named 'libtmux'"

Using wrong Python. Must use the Nix-wrapped Python from the package.

Patterns not matching

Terminal control characters may be interfering. The strip_ansi_and_control() function should handle this, but check with cat -v to see raw content.

Status showing ERROR when it shouldn't

Check if content contains error-like strings from previous output. The detection looks at last 20 lines of pane content.