opencode-qa

code-yeongyu71kstars

Developer ToolsDatabases

1---2name: opencode-qa3description: QA opencode itself, per case: verify the CLI/terminal (opencode run, db, serve, export), prove a specific…4---56# .agents/skills/opencode-qa/SKILL.md

SKILL.mdAgent skill

Transport: File
Status: Listed

SKILL.md

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add code-yeongyu/oh-my-openagent --skill opencode-qa -a cursor -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add code-yeongyu/oh-my-openagent --skill opencode-qa -a claude-code -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add code-yeongyu/oh-my-openagent --skill opencode-qa -a codex -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add code-yeongyu/oh-my-openagent --skill opencode-qa -a grok -y

Send the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.

txtGrok Bot chat

1Install this skill: https://github.com/code-yeongyu/oh-my-openagent/tree/HEAD/.agents/skills/opencode-qa

Download skill .agents/skills/opencode-qa/SKILL.md on GitHub

.agents/skills/opencode-qa/SKILL.mdMarkdown · UTF-8

Skill facts

Agent skill

File: .agents/skills/opencode-qa/SKILL.md
Publisher: code-yeongyu
Hosting

Overview

About opencode-qa

QA 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.

FAQ

Questions

opencode QA

QA the opencode coding agent itself. This skill maps each QA need to a tested helper script and a deep reference. Every script ships a --self-test that asserts its scenario against the live machine, so the scripts are both the QA tools and their own regression checks.

Verified against opencode v1.17.7 (bun 1.3.12, macOS). Confirm the installed version with opencode --version; the surface is stable but always sanity check a flag with opencode <cmd> --help.

Golden rules (read before running anything)

READS of the live DB are safe and intended. Investigating sessions (Case D) only reads ~/.local/share/opencode/opencode.db.

Anything that SPAWNS opencode (serve, run, the TUI) must use an isolated XDG sandbox so QA never writes junk sessions into the real DB. The bundled scripts already do this; if you run opencode by hand for QA, set XDG_DATA_HOME / XDG_CONFIG_HOME / XDG_STATE_HOME / XDG_CACHE_HOME to temp dirs first.

Global text search over the part table is a multi-GB scan. Always scope it (--session, --recent, or --since). The text script refuses an unbounded scan on purpose.

The opencode source repo (packages/opencode) tests itself with bun test and CANNOT run tests from the repo root. See references/testing-harness.md.

Setup

Scripts live next to this file under scripts/. Invoke them from this skill directory (or with their absolute path):

cd <this-skill-dir> # .agents/skills/opencode-qa bash scripts/lib/common.sh --self-check # confirm the harness + deps

Docker is the default QA surface. Run QA inside a disposable container that has the latest opencode and a copy of your config, with the host untouched: script/agent/qa-docker.sh (see references/docker-qa.md). The local scripts below are the fallback for when Docker is unavailable or on Windows.

common.sh provides the shared harness (DB path, SQL escaping, isolated XDG sandbox, free port, server start/stop, and an EXIT-trap cleanup). It requires opencode, , , , and on PATH.

You want to...	Case	Script	Reference
Run opencode non-interactively / check a CLI command	A	`opencode run --format json` (inline)	`references/cli-commands.md`
Find a session by its id	D	`scripts/db-session-by-id.sh <ses_id>`	`references/db-investigation.md`
Find sessions by title/name	D	`scripts/db-session-by-name.sh "<text>"`	`references/db-investigation.md`
Find sessions by message text	D	`scripts/db-session-by-text.sh --recent N "<text>"`	`references/db-investigation.md`
Export a whole session as JSON	D	`scripts/export-roundtrip.sh <ses_id>`	`references/db-investigation.md`
Check the HTTP server / an endpoint	B	`scripts/server-smoke.sh`	`references/server-api.md`
Prove a hook / action / event fired	B	`scripts/sse-hook-probe.sh`	`references/events-hooks.md`
Prove serve-topology wake runner-split (reproduced/fixed)	B	`scripts/serve-wake-split-probe.sh --expect reproduced\|fixed --evidence-dir DIR` (self-test: `--self-test`; fake LLM: `scripts/lib/fake-openai-server.mjs`)	`references/events-hooks.md`
Smoke-test the TUI	C	`scripts/tui-smoke.sh`	`references/tui-tmux.md`
Write/run a test in the opencode source	-	(bun test)	`references/testing-harness.md`
Drive opencode from a Bun/TS script	-	(SDK)	`references/sdk.md`

Script	Case	Self-test asserts
`scripts/lib/common.sh --self-check`	-	deps present, DB path resolves, SQL escaping, free port, sandbox auto-removed
`scripts/db-session-by-id.sh`	D	id round-trips for a real session
`scripts/db-session-by-name.sh`	D	a derived title needle returns >=1 row
`scripts/db-session-by-text.sh`	D	scoped search hits; unbounded scan refused; bounded search <30s
`scripts/export-roundtrip.sh`	D	export stdout is valid JSON and `.info.id` round-trips
`scripts/server-smoke.sh`	B	`/global/health` healthy, `/doc` >=100 paths, no-auth -> 401
`scripts/sse-hook-probe.sh`	B	`/event` opens and delivers `server.connected`
`scripts/tui-smoke.sh`	C	TUI renders under tmux, tears down, real DB untouched

opencode-qa

Install

Skill facts

About opencode-qa

Questions

How do I install opencode-qa?

Where does opencode-qa live?

Which agents can use opencode-qa?

SKILL.md

opencode QA

Golden rules (read before running anything)

Setup

Router: pick your case

Case A: CLI / terminal works

Case B: a specific hook, action, or event

Case C: the TUI

Case D: investigate sessions in the DB

Scripts index

Risks and caveats

References