Run any Skill in Manus with one click

openconductor-tester

Stars3

Forks0

UpdatedMay 21, 2026 at 18:42

Run and test OpenConductor interactively using tmux. Use when you need to: - Test a fix by running the app with real agents - Debug heuristic detection issues (spinner, permission, question dialogs) - Verify scrollback behavior - Check Telegram notification flow - Reproduce a user-reported bug Triggers on: "test this", "run the app", "try it", "verify the fix", "check if it works", "reproduce the bug", "manual test"

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

wilfoa

wilfoa/openconductor

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

SKILL.md

readonly

name

openconductor-tester

description

OpenConductor Interactive Testing

Run OpenConductor in tmux to test changes with real agents.

Quick Start

Build and Run

# Build the binary
go build -o /tmp/oc-test ./cmd/openconductor

# Create a tmux session with the app
tmux new-session -d -s oc-test -x 200 -y 50 "/tmp/oc-test --debug"

# To use isolated config/logs (won't affect the user's real setup):
OC_CONFIG_PATH=/tmp/oc-test-config.yaml \
OC_LOG_DIR=/tmp/oc-test-logs \
OC_STATE_PATH=/tmp/oc-test-state.json \
tmux new-session -d -s oc-test -x 200 -y 50 "/tmp/oc-test --debug"

Read Terminal State

# Get visible screen content as text
tmux capture-pane -t oc-test -p

# Get specific line range (0-indexed)
tmux capture-pane -t oc-test -p -S 0 -E 5   # first 6 lines
tmux capture-pane -t oc-test -p -S -5        # last 5 lines

Take Visual Screenshots

Render the terminal to a PNG image that looks like the user's screen:

# Prerequisites (one-time): brew install aha
# Also need: python3 -m http.server 8787 --directory /tmp &>/dev/null &

# 1. Capture with ANSI colors and render to styled HTML
BODY=$(tmux capture-pane -e -p -t oc-test | aha --no-header)
cat > /tmp/oc-screen.html << EOF
<!DOCTYPE html>
<html><head><meta charset="utf-8">
<style>
body {
  background: #1a1a2e; color: #c8c8c8;
  font-family: "Menlo", "Monaco", "Courier New", "DejaVu Sans Mono", monospace;
  font-size: 13px; line-height: 1.35;
  padding: 12px 16px; margin: 0; white-space: pre; overflow-x: auto;
}
</style></head><body>
$BODY
</body></html>
EOF

# 2. Screenshot with Playwright (use browser_navigate then browser_take_screenshot)
# Navigate to: http://localhost:8787/oc-screen.html
# Take screenshot to: /tmp/oc-screenshot.png
# View the PNG with the Read tool

This gives you a pixel-accurate rendering with dark background, monospace font, correct Unicode box-drawing characters, and ANSI colors — matching what the user sees in their native terminal.

Send Mouse Events

# Mouse wheel up (scroll up) — SGR format: ESC [ < button;col;row M
# Button 64 = wheel up, 65 = wheel down
# Position: col=60, row=20 (middle of terminal content area)
tmux send-keys -t oc-test -l $'\x1b[<64;60;20M'   # wheel up
tmux send-keys -t oc-test -l $'\x1b[<65;60;20M'   # wheel down

# Multiple scroll ticks (simulate trackpad gesture)
for i in $(seq 1 10); do
  tmux send-keys -t oc-test -l $'\x1b[<64;60;20M'
  sleep 0.05
done

Send Keystrokes

# Type text and press Enter (send a prompt to the agent)
tmux send-keys -t oc-test "fix the login bug" Enter

# Press special keys
tmux send-keys -t oc-test Enter          # Enter
tmux send-keys -t oc-test Escape         # Escape
tmux send-keys -t oc-test C-c            # Ctrl+C
tmux send-keys -t oc-test C-s            # Ctrl+S (toggle sidebar focus)
tmux send-keys -t oc-test C-j            # Ctrl+J (prev tab)
tmux send-keys -t oc-test C-k            # Ctrl+K (next tab)
tmux send-keys -t oc-test Tab            # Tab

# Send raw escape sequences (arrow keys)
tmux send-keys -t oc-test -l $'\x1b[A'   # Up arrow
tmux send-keys -t oc-test -l $'\x1b[B'   # Down arrow
tmux send-keys -t oc-test -l $'\x1b[C'   # Right arrow
tmux send-keys -t oc-test -l $'\x1b[D'   # Left arrow

Read Logs

# Tail the log file (structured JSON)
tail -f /tmp/oc-test-logs/openconductor.log

# Search for specific events
grep 'attention check' /tmp/oc-test-logs/openconductor.log | tail -5
grep 'heuristic.*claude' /tmp/oc-test-logs/openconductor.log | tail -5
grep 'auto-approve' /tmp/oc-test-logs/openconductor.log | tail -5
grep 'auto-confirm' /tmp/oc-test-logs/openconductor.log | tail -5
grep 'telegram' /tmp/oc-test-logs/openconductor.log | tail -5
grep 'no signal' /tmp/oc-test-logs/openconductor.log | tail -5

Cleanup

tmux kill-session -t oc-test
rm -f /tmp/oc-test

Testing Workflows

Test Spinner Detection (Claude Code)

Start the app with a Claude Code project
Send a prompt: tmux send-keys -t oc-test "What is 2+2?" Enter
Check logs: grep 'claude-code spinner detected' /tmp/oc-test-logs/openconductor.log | tail -3
Check screen: tmux capture-pane -t oc-test -p | grep -i 'working\|spinner'
Expected: log shows "isWorking: true", sidebar shows "working" badge

Test Permission Detection (OpenCode)

Start with an OpenCode project
Send a prompt that triggers file access outside the repo
Check logs: grep 'permission' /tmp/oc-test-logs/openconductor.log | tail -5
Check screen: tmux capture-pane -t oc-test -p | grep -i 'permission required\|allow once'
Expected: sidebar shows "permission" badge, log shows NeedsPermission

Test Auto-Approve

Verify auto-approve is configured (LLM section in config)
Trigger a permission dialog
Check logs: grep 'auto-approve' /tmp/oc-test-logs/openconductor.log | tail -5
Expected: log shows "auto-approve: sending keystroke" then "auto-confirm: confirmed always-allow dialog"

Test Scrollback (Claude Code)

Send a prompt that produces long output: tmux send-keys -t oc-test "Run go test ./..." Enter
Wait for completion
Scroll up: tmux send-keys -t oc-test -l $'\x1b[5~' (PageUp — only works if not alt-screen)
Check screen: tmux capture-pane -t oc-test -p
Expected: scrollback shows earlier output without gaps

Test Question Series (OpenCode)

Send a prompt designed to trigger AskUser: tmux send-keys -t oc-test "Ask me which framework to use before starting" Enter
Check logs: grep 'NeedsAnswer\|question' /tmp/oc-test-logs/openconductor.log | tail -5
Check screen: tmux capture-pane -t oc-test -p | grep -i 'select\|dismiss'
Expected: question dialog detected, state shows "asking"

Config File Format

For E2E testing, create a minimal config:

projects:
  - name: TestProject
    repo: /path/to/test/repo
    agent: claude-code          # or "opencode"

# Optional: enable auto-approve
llm:
  provider: anthropic
  model: claude-sonnet-4-20250514
  api_key: ANTHROPIC_API_KEY    # env var name, not the actual key

# Optional: Telegram (usually disabled for testing)
telegram:
  enabled: false

Key Log Messages

Log Message	Meaning
`"attention check"`	Periodic check with `hasEvent`, `isWorking` fields
`"attention state transition"`	State changed — `from` and `to` fields
`"heuristic: claude-code spinner detected"`	Spinner found
`"heuristic: claude-code no signal"`	Nothing detected — check `lines` field
`"heuristic: opencode scan result"`	OpenCode detection flags
`"auto-approve: sending keystroke"`	Auto-approve fired
`"auto-approve: stuck, falling through"`	Auto-approve failed too many times
`"auto-confirm: confirmed always-allow dialog"`	Second-stage confirm auto-dismissed
`"auto-confirm: submitted question series confirm tab"`	Question confirm auto-submitted
`"telegram: sending permission keystroke"`	Telegram button callback processed
`"session: PTY write failed"`	Write to PTY returned error

Architecture Reference

Session: internal/session/session.go — PTY + vt10x wrapper
Agent adapters: internal/agent/claude.go, internal/agent/opencode.go
Attention loop: internal/tui/app.go:checkAttention() — runs every 2s
Scrollback: internal/tui/app.go:checkScrollback() — runs every 100ms
Telegram handler: internal/telegram/handler.go:HandleCallback()
Auto-approve: internal/tui/app.go — runs before state transition for NeedsPermission
CSI filter: internal/agent/claude.go:csiFilter — strips kitty keyboard sequences