Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

openconductor-tester

Estrellas3

Forks0

Actualizado21 de mayo de 2026 a las 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"

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Ejecutar en Manus

Fuente

wilfoa

wilfoa/openconductor

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ejecutar en Manus

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Analistas de garantía de calidad de software y probadoresOcupaciones informáticas y matemáticas·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