code-yeongyu/oh-my-openagent / .agents/skills/opencode-qa
opencode-qa
VerifiedQA opencode itself, per case: verify the CLI/terminal (opencode run, db, serve, export), prove a specific plugin hook/action/event fired via the SSE event stream, smoke-test the TUI under tmux, and investigate sessions in opencode's SQLite DB by id, title/name, or message text. Ships tested helper scripts (each with a --self-test) plus per-domain references. Use whenever someone wants to QA, smoke-test, verify, or debug opencode's CLI, HTTP server, plugin hooks/events, or TUI, or to find/inspect opencode sessions in the database. Triggers: opencode qa, qa opencode, test opencode, verify opencode hook, opencode session db, find opencode session by id/name/text, opencode tui test, opencode server health, opencode event stream.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.3 KB |
| references/cli-commands.md | markdown | 3.8 KB |
| references/db-investigation.md | markdown | 5.8 KB |
| references/docker-qa.md | markdown | 3.2 KB |
| references/events-hooks.md | markdown | 4.5 KB |
| references/sdk.md | markdown | 4.1 KB |
| references/server-api.md | markdown | 6.5 KB |
| references/testing-harness.md | markdown | 6.2 KB |
| references/tui-tmux.md | markdown | 4.0 KB |
| scripts/db-session-by-id.shexecutable | script | 1.7 KB |
| scripts/db-session-by-name.shexecutable | script | 1.9 KB |
| scripts/db-session-by-text.shexecutable | script | 6.6 KB |
| scripts/export-roundtrip.shexecutable | script | 2.8 KB |
| scripts/lib/common.shexecutable | script | 9.5 KB |
| scripts/lib/fake-openai-branches.mjs | script | 1.2 KB |
| scripts/lib/fake-openai-events.mjs | script | 2.3 KB |
| scripts/lib/fake-openai-server.mjsexecutable | script | 3.7 KB |
| scripts/lsp-e2e.shexecutable | script | 134.1 KB |
| scripts/serve-wake-split-probe.shexecutable | script | 38.2 KB |
| scripts/server-smoke.shexecutable | script | 2.1 KB |
| scripts/sse-hook-probe.shexecutable | script | 4.4 KB |
| scripts/tui-smoke.shexecutable | script | 3.6 KB |
scripts/sse-hook-probe.sh
View on GitHub#!/usr/bin/env bash
# sse-hook-probe.sh - QA opencode's event stream (the plumbing behind hooks).
#
# opencode publishes lifecycle events over Server-Sent Events at GET /event
# (per-instance) and GET /global/event. Plugins observe the same events via the
# `event` hook, so confirming an event on the wire is how you prove a hook
# would have fired.
#
# Two modes:
# (default / --self-test) Spawn an ISOLATED server and assert the stream
# opens with a `server.connected` event. No real DB
# is touched. This proves the SSE plumbing works.
# --attach <url> Watch an ALREADY-RUNNING server's /event stream for
# a specific event type (default: server.connected).
# Use this against your real server to verify a hook
# or action. Pair it with a prompt in another shell:
# curl -X POST -u opencode:$PASS \
# -H 'Content-Type: application/json' \
# -d '{"parts":[{"type":"text","text":"hi"}]}' \
# "<url>/session/<ses_id>/prompt_async?directory=<dir>"
# then watch for e.g. message.part.updated.
#
# --attach options:
# --password <p> server password (user defaults to "opencode")
# --user <u> server username (default: opencode)
# --directory <d> instance directory (default: $PWD)
# --event <type> event type to wait for (default: server.connected)
# --timeout <s> seconds to wait (default: 15)
#
# Usage:
# sse-hook-probe.sh --self-test
# sse-hook-probe.sh --attach http://127.0.0.1:4096 --password secret \
# --directory "$PWD" --event message.part.updated --timeout 30
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
. "$SCRIPT_DIR/lib/common.sh"
# Watch an SSE stream for an event type. Args: url auth directory event timeout
# Returns 0 if seen, 1 otherwise. Always kills its curl watcher.
oqa_sse_watch() {
local url="$1" auth="$2" dir="$3" want="$4" timeout="${5:-15}"
local out cpid found="" deadline
out="$(mktemp -t oqa-sse.XXXXXX)"; OQA_TMPDIRS+=("$out")
if [ -n "$auth" ]; then
curl -sN -u "$auth" "$url/event?directory=$dir" >"$out" 2>/dev/null &
else
curl -sN "$url/event?directory=$dir" >"$out" 2>/dev/null &
fi
cpid=$!; OQA_CURL_PIDS+=("$cpid")
disown "$cpid" 2>/dev/null || true
deadline=$(( $(date +%s) + timeout ))
while [ "$(date +%s)" -lt "$deadline" ]; do
if grep -q "\"$want\"" "$out" 2>/dev/null; then found=1; break; fi
kill -0 "$cpid" 2>/dev/null || break
sleep 0.2
done
kill "$cpid" 2>/dev/null || true
sleep 0.1
kill -0 "$cpid" 2>/dev/null && kill -9 "$cpid" 2>/dev/null || true
if [ -n "$found" ]; then
printf 'first matching event: '
grep -m1 "\"$want\"" "$out" | sed 's/^data: //' | jq -c '{type: .type}' 2>/dev/null || true
return 0
fi
oqa_log "stream head (no '$want' within ${timeout}s):"; head -5 "$out" >&2
return 1
}
oqa_self_test() {
oqa_require opencode curl jq || return 1
if ! oqa_start_server; then oqa_log "FAIL: server did not start"; return 1; fi
if oqa_sse_watch "$OQA_SERVER_URL" "opencode:$OQA_SERVER_PASS" "$OQA_PROJ" "server.connected" 15; then
oqa_pass "SSE /event opened and delivered server.connected"
return 0
fi
oqa_log "FAIL: did not observe server.connected"; return 1
}
oqa_attach_mode() {
local url="" user="opencode" pass="" dir="$PWD" event="server.connected" timeout=15
shift # drop --attach
url="$1"; shift || true
while [ $# -gt 0 ]; do
case "$1" in
--password) pass="$2"; shift 2 ;;
--user) user="$2"; shift 2 ;;
--directory) dir="$2"; shift 2 ;;
--event) event="$2"; shift 2 ;;
--timeout) timeout="$2"; shift 2 ;;
*) oqa_log "unknown option: $1"; shift ;;
esac
done
[ -n "$url" ] || { oqa_log "error: --attach requires a URL"; return 2; }
local auth=""; [ -n "$pass" ] && auth="$user:$pass"
oqa_log "watching $url/event?directory=$dir for '$event' (<=${timeout}s)"
if oqa_sse_watch "$url" "$auth" "$dir" "$event" "$timeout"; then
oqa_pass "observed '$event' on $url"
return 0
fi
oqa_log "FAIL: '$event' not observed"; return 1
}
case "${1:-}" in
--attach) oqa_attach_mode "$@"; exit $? ;;
-h|--help)
sed -n '2,34p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
exit 0 ;;
*) oqa_self_test; exit $? ;;
esac
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |