using-spx-cli
Installation
SKILL.md
Using spx CLI
Overview
spx is a thin Gitea wrapper shipped with superpowers-vscode for agent (cc/codex) use. It reads host + token from ~/.config/tea/config.yml, with GITEA_TOKEN env var as a fallback. After opencli external register spx, both spx ... and opencli spx ... work; prefer opencli spx ....
When to Use
You need to do exactly one of these against a Gitea repo:
- Create a new issue with optional
spec/planmarkers and/or initial state JSON - Incrementally update an existing issue's
<!-- spx:spec=... -->or<!-- spx:plan=... -->marker line - Read or merge an issue's persisted state JSON (column, sessionId, pr, branch, ...)
- Post a PR review comment (CLI auto-prepends
<!-- spx:review=1 -->)
Not for: merging PRs, pushing to main, or rewriting issue bodies beyond the spx:* markers and the state JSON comment. Those are out of scope.