opencode-qalisted
Install: claude install-skill code-yeongyu/oh-my-openagent
# 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.15.13 (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):
```bash
cd <this-skill-dir> # .a