integration-test - SKILL.md Agent Skill

name: integration-test description: Integration test for repowire peer-to-peer messaging. Supports claude-code, opencode, or mixed-agent-type testing with circle boundaries and cross-agent-type communication. Can run all modes in parallel via agent teams.

Repowire Integration Test

Unified integration test for peer-to-peer communication across agent types.

Execution Modes

Argument	Behavior
`claude-code`	Test Claude Code agent type only
`opencode`	Test OpenCode agent type only
`mixed`	Test cross-agent-type communication
`all` or no argument	Run all three modes in parallel using agent teams

Team-Based Parallel Execution

When all is specified (or no argument), the lead agent should:

Run Phase 1 (environment discovery) and Phase 3 (pre-test teardown) itself
Ask user for project directories and opencode model (Phase 2)
Ensure daemon is running
Create tasks for each mode and spawn background agents in parallel:
- Agent test-claude-code → runs claude-code tests
- Agent test-opencode → runs opencode tests
- Agent test-mixed → runs mixed tests (depends on both agent types being available)
Collect results and produce unified report

Spawning agents

Use the Task tool with run_in_background: true to run modes in parallel:

Task(subagent_type="general-purpose", run_in_background=true, prompt="Run the claude-code integration test. [paste mode section]")
Task(subagent_type="general-purpose", run_in_background=true, prompt="Run the opencode integration test. [paste mode section]")

Each agent gets the full context for its mode and runs independently.

Phase 1: Environment Discovery

Run these commands to understand current state.

# System checks
tmux list-sessions 2>/dev/null || echo "No tmux sessions"
which opencode 2>/dev/null || echo "opencode not in PATH"
which claude 2>/dev/null || echo "claude not in PATH"

# Daemon and peer status
curl -s http://127.0.0.1:8377/health 2>/dev/null | jq . || echo "Daemon not running"
curl -s http://127.0.0.1:8377/peers 2>/dev/null | jq '.peers[] | {name, status, circle}' || echo "No peers"

# Installation status
uv tool list 2>/dev/null | grep repowire || echo "No uv tool installation"
python3 -c "import json; d=json.load(open('$HOME/.claude/settings.json')); print('Hooks:', list(d.get('hooks',{}).keys()))" 2>/dev/null || echo "No Claude hooks"
ls ~/.opencode/plugin/repowire.ts 2>/dev/null && echo "OpenCode plugin installed" || echo "No OpenCode plugin"

Phase 2: Ask User for Configuration

Ask user for:

Project directories (2-3 depending on mode, or ask for all if running all)
OpenCode model (e.g., anthropic/claude-sonnet-4-5-20250929) — needed for opencode/mixed modes
Fresh install? — removes existing hooks/plugins and reinstalls

Phase 3: Pre-Test Teardown (Always Run)

tmux kill-session -t circle-a 2>/dev/null || true
tmux kill-session -t circle-b 2>/dev/null || true
tmux kill-session -t opencode-test 2>/dev/null || true
tmux kill-session -t mixed-test 2>/dev/null || true
pkill -f websocket_hook 2>/dev/null || true

curl -s http://127.0.0.1:8377/health >/dev/null 2>&1 && {
  repowire peer prune --force 2>/dev/null || true
}

rm -f ~/.repowire/pending/*.json 2>/dev/null || true
rm -f ~/.repowire/sessions.json 2>/dev/null || true

Phase 4: Fresh Install (if requested)

IMPORTANT: repowire setup calls claude mcp add which fails inside a Claude Code session. Run these commands in a tmux pane, not from within Claude Code.

# Run in a tmux pane (e.g. tmux send-keys to a spare window):

# Uninstall
repowire uninstall 2>/dev/null || true
uv tool uninstall repowire 2>/dev/null || true

# Install as tool from local source
uv tool install --force /path/to/repowire

# Setup hooks and MCP server
repowire setup --no-service

# Verify
repowire --version
python3 -c "import json; d=json.load(open('$HOME/.claude/settings.json')); print('Hooks:', list(d.get('hooks',{}).keys()))"
ls ~/.opencode/plugin/repowire.ts 2>/dev/null && echo "OpenCode plugin: OK"

Phase 5: Ensure Daemon Running

curl -s http://127.0.0.1:8377/health || {
  nohup repowire serve > /tmp/repowire-daemon.log 2>&1 &
  sleep 3
}
curl -s http://127.0.0.1:8377/health | jq .

Mode: claude-code

Requires: tmux, claude CLI, Claude hooks installed Tmux sessions used: circle-a, circle-b Project directories needed: 3 (2 for circle-a, 1 for circle-b)

Setup

tmux new-session -d -s circle-a -n peer-a1
tmux new-window -t circle-a -n peer-a2
tmux new-session -d -s circle-b -n peer-b1

tmux send-keys -t circle-a:peer-a1 "cd $PROJECT_A1 && claude --dangerously-skip-permissions" Enter
sleep 3
tmux send-keys -t circle-a:peer-a2 "cd $PROJECT_A2 && claude --dangerously-skip-permissions" Enter
sleep 3
tmux send-keys -t circle-b:peer-b1 "cd $PROJECT_B1 && claude --dangerously-skip-permissions" Enter
sleep 30  # Wait for sessions to initialize and hooks to register

Verify Registration

# All 3 peers should be online with correct circles and peer_id format
curl -s http://127.0.0.1:8377/peers | python3 -c "
import sys, json, re
peers = json.load(sys.stdin)['peers']
expected = {'$PEER_A1': 'circle-a', '$PEER_A2': 'circle-a', '$PEER_B1': 'circle-b'}
for name, circle in expected.items():
    match = [p for p in peers if p['name'] == name and p['status'] == 'online']
    ok = match and match[0].get('circle') == circle and re.match(r'^repow-[\w-]+-[a-f0-9]{8}$', match[0].get('peer_id',''))
    print(f'  {name}: {\"PASS\" if ok else \"FAIL\"} ({match[0] if match else \"not found\"})')
"

If a peer doesn't register, check .claude/settings.local.json for disableAllHooks: true.

Tests

Direct query to peer-a1

repowire peer ask $PEER_A1 "What is this project about in one sentence?" -t 120

Expected: Direct response describing the project.

Peer-to-peer proxy (peer-a1 → peer-a2 via MCP ask_peer)

repowire peer ask $PEER_A1 \
  "Use the ask_peer tool to ask $PEER_A2: What is this project about in one sentence? Return their exact response." \
  -t 180

Expected: peer-a1 responds with peer-a2's answer.

Circle verification

curl -s http://127.0.0.1:8377/peers | jq '.peers[] | select(.circle == "circle-a") | {name, peer_id}'

Event chain

curl -s http://127.0.0.1:8377/events | jq '.[-10:]'

Cleanup

tmux kill-session -t circle-a 2>/dev/null || true
tmux kill-session -t circle-b 2>/dev/null || true
pkill -f websocket_hook 2>/dev/null || true
repowire peer prune --force 2>/dev/null || true

Success Criteria

All 3 peers registered with peer_id format repow-{circle}-{uuid8}
Peers in correct circles (circle = tmux session name)
Direct query via CLI: PASS
Peer-to-peer proxy query via MCP: PASS

Mode: opencode

Requires: opencode CLI, OpenCode plugin installed at ~/.opencode/plugin/repowire.ts Tmux sessions used: opencode-test Project directories needed: 2 Model flag needed: e.g., --model anthropic/claude-sonnet-4-5-20250929

Important Notes

OpenCode does NOT accept tmux send-keys for prompt submission (alternate screen mode). All query injection goes through the SDK plugin via session.prompt().
OpenCode sessions need a warmup prompt (via tmux send-keys) to create an active session before repowire queries work.
The --model flag must specify a working model. LiteLLM proxy models may return 404.

Setup

tmux new-session -d -s opencode-test -n peer-1
tmux new-window -t opencode-test -n peer-2

tmux send-keys -t opencode-test:peer-1 "cd $PROJECT_1 && opencode --model $OPENCODE_MODEL" Enter
sleep 3
tmux send-keys -t opencode-test:peer-2 "cd $PROJECT_2 && opencode --model $OPENCODE_MODEL" Enter
sleep 10

# Warm up: send initial prompt to create sessions
tmux send-keys -t opencode-test:peer-1 -l "hi"
tmux send-keys -t opencode-test:peer-1 Enter
sleep 2
tmux send-keys -t opencode-test:peer-2 -l "hi"
tmux send-keys -t opencode-test:peer-2 Enter
sleep 30  # Wait for warmup to complete

Verify Registration

curl -s http://127.0.0.1:8377/peers | python3 -c "
import sys, json
peers = json.load(sys.stdin)['peers']
oc = [p for p in peers if p.get('backend') == 'opencode' and p['status'] == 'online']
for p in oc:
    print(f'  {p[\"name\"]}: peer_id={p.get(\"peer_id\")}, backend={p.get(\"backend\")}')
print(f'  opencode peers: {len(oc)}')
"

Tests

WebSocket connection & peer discovery

curl -s http://127.0.0.1:8377/peers | jq '.peers[] | select(.backend == "opencode") | {name, status, peer_id}'

Expected: Both peers online with repow-{circle}-{uuid8} format.

Direct query to peer-1
```
repowire peer ask $PEER_1 "What is this project about in one sentence?" -t 120
```
Expected: Response from the model (not "empty response" or "Not Found").

Peer-to-peer proxy (peer-1 → peer-2)

repowire peer ask $PEER_1 \
  "Use the ask_peer tool to ask $PEER_2: What is this project about in one sentence? Return their exact response." \
  -t 180

Reverse proxy (peer-2 → peer-1)

repowire peer ask $PEER_2 \
  "Use the ask_peer tool to ask $PEER_1: What is this project about in one sentence? Return their exact response." \
  -t 180

Troubleshooting

Symptom	Cause	Fix
"No active session"	Warmup prompt didn't create session	Press Enter manually in opencode pane, or wait longer
"(empty response)"	Model returned 0 parts	Check model config — switch to `anthropic/claude-sonnet-4-5-20250929`
"Not Found" in TUI	LiteLLM model ID not recognized	Use `--model anthropic/<model-id>` directly
Plugin not connecting	Wrong WS URL or old plugin	Reinstall: `uv run python3 -c "from repowire.installers.opencode import install_plugin; install_plugin()"`

Cleanup

tmux kill-session -t opencode-test 2>/dev/null || true
repowire peer prune --force 2>/dev/null || true

Success Criteria

Both peers registered via WebSocket with repow-{circle}-{uuid8} peer_id
Direct query returns real model response (not empty/error)
Bidirectional peer-to-peer proxy queries: PASS

Mode: mixed (Cross-Agent-Type)

Requires: Both claude-code AND opencode setups working Tmux sessions used: mixed-test Project directories needed: 2 (1 for claude, 1 for opencode) Depends on: claude-code and opencode modes passing individually first

Setup

tmux new-session -d -s mixed-test -n claude-peer
tmux new-window -t mixed-test -n opencode-peer

tmux send-keys -t mixed-test:claude-peer "cd $PROJECT_CLAUDE && claude --dangerously-skip-permissions" Enter
sleep 3
tmux send-keys -t mixed-test:opencode-peer "cd $PROJECT_OPENCODE && opencode --model $OPENCODE_MODEL" Enter
sleep 10

# Warm up opencode peer
tmux send-keys -t mixed-test:opencode-peer -l "hi"
tmux send-keys -t mixed-test:opencode-peer Enter
sleep 30

Tests

Cross-agent-type registration

curl -s http://127.0.0.1:8377/peers | jq '.peers[] | select(.status == "online") | {name, backend, peer_id}'

Claude → OpenCode proxy

repowire peer ask $CLAUDE_PEER \
  "Use ask_peer to ask $OPENCODE_PEER: What is this project about in one sentence? Return their response." \
  -t 180

OpenCode → Claude proxy

repowire peer ask $OPENCODE_PEER \
  "Use ask_peer to ask $CLAUDE_PEER: What is this project about in one sentence? Return their response." \
  -t 180

Event chain

curl -s http://127.0.0.1:8377/events | jq '.[-10:]'

Cleanup

tmux kill-session -t mixed-test 2>/dev/null || true
repowire peer prune --force 2>/dev/null || true

Success Criteria

Both agent types register with repow-{circle}-{uuid8} peer_id
Claude → OpenCode proxy: PASS
OpenCode → Claude proxy: PASS

Phase 6: Unified Report

Aggregate results from all modes into a single report:

==========================================
  REPOWIRE INTEGRATION TEST RESULTS
==========================================

  MODE: CLAUDE-CODE
  ├ Registration:    PASS/FAIL (X/Y peers)
  ├ Direct query:    PASS/FAIL
  ├ Proxy query:     PASS/FAIL
  └ Status:          PASS/FAIL

  MODE: OPENCODE
  ├ Registration:    PASS/FAIL (X/Y peers)
  ├ Direct query:    PASS/FAIL
  ├ Proxy query:     PASS/FAIL
  └ Status:          PASS/FAIL

  MODE: MIXED
  ├ Registration:    PASS/FAIL
  ├ Claude→OC:       PASS/FAIL
  ├ OC→Claude:       PASS/FAIL
  └ Status:          PASS/FAIL

  Overall: PASS/FAIL
==========================================

Phase 7: Final Teardown

tmux kill-session -t circle-a 2>/dev/null || true
tmux kill-session -t circle-b 2>/dev/null || true
tmux kill-session -t opencode-test 2>/dev/null || true
tmux kill-session -t mixed-test 2>/dev/null || true
pkill -f websocket_hook 2>/dev/null || true
repowire peer prune --force 2>/dev/null || true

Quick Reference

repowire serve                    # Start daemon
repowire peer ask NAME "q" -t 120 # Query a peer
curl -s localhost:8377/peers | jq  # List peers
curl -s localhost:8377/events | jq '.[-5:]'  # Recent events
repowire peer prune --force       # Remove offline peers