v0.3.0
Highlights
- Pi (
@mariozechner/pi-coding-agent) is now a fully supported fifth runtime. All 14 vibekit skills, the/vibeslash command, and theusing-vibekitauto-trigger priming are delivered to pi via a tiny pi extension that injects the canonical priming body into every agent turn's system prompt. Install withpi install git:github.com/rizukirr/vibekit. - OpenCode now exposes every vibekit skill as a slash command. All pipeline skills are reachable via
/<name>in the OpenCode editor without any extra glue. - Cross-runtime parity hardened. Three new
vibekit-doctorchecks (C11/C12/C13) enforce that the pi adapter stays in sync with the canonical sources; pre-existing version drift between Codex/marketplace and the rest of the manifests has been swept up to a single 0.3.0.
What changed
New: Pi runtime adapter
.pi-plugin/plugin.json— internal manifest for vibekit-doctor's parity checks (mirrors.opencode/plugin.json/gemini-extension.jsonshape)..pi-plugin/extensions/vibekit-prime.ts— async pi extension that registers abefore_agent_starthandler. Readsskills/using-vibekit/SKILL.mdonce at load and appends it (framed in<EXTREMELY_IMPORTANT>) toevent.systemPromptevery turn, so pi users get the same auto-trigger priming as Claude Code's SessionStart hook delivers..pi-plugin/prompts/vibe.md—/vibeslash command for pi (uses pi's native$ARGUMENTSsyntax, identical body tocommands/vibe.md).package.jsonpikey — registers vibekit as a pi package:pi.skills→./skills,pi.prompts→./.pi-plugin/prompts,pi.extensions→./.pi-plugin/extensions.keywordsincludespi-package.docs/INSTALL.pi.md— end-to-end install guide (Prerequisites / Install / Verify / Troubleshooting / Uninstall).
New: OpenCode slash commands
.opencode/commands/{vibe,brainstorm-lean,plan-write,brief-compiler,exec-dispatch,report-filter,verify-gate,review-pack,finish-branch,isolate,memory-dual,ralph-loop,vibekit-doctor}.md— every vibekit skill is now a first-class slash command in the OpenCode editor (no manual symlink, no extension toggle)..opencode/INSTALL.mdupdated with the new command-discovery guidance.
vibekit-doctor (C11–C13)
- C11 — pi-manifest-present. Asserts
.pi-plugin/plugin.jsonparses and thatpackage.jsoncarries thepikey withskills/prompts/extensionsarrays. - C12 — pi-extension-canonical-source. Greps
.pi-plugin/extensions/vibekit-prime.tsfor the literalskills/using-vibekit/SKILL.mdpath — drift guard against the extension being refactored away from the canonical source. - C13 — pi-prompt-stages-match. Extracts every
[N/7]token from bothcommands/vibe.mdand.pi-plugin/prompts/vibe.mdand demands set-equality on{[1/7]…[7/7]}. .pi-plugin/plugin.jsonadded to the C3 required-manifest list.- "Cross-runtime portability" list now includes Pi.
Cross-runtime documentation sweep
Eight runtime-enumerating prose locations were updated so every count, table, and bullet list now reflects five runtimes with Pi included:
CLAUDE.md— "five delivery paths";.pi-plugin/added to the cross-runtime trigger list; manifest-parity bullet now names all five plugin.json files.AGENTS.md— opening agent enumeration includes OpenCode and Pi; Repository layout has.pi-plugin/;using-vibekittable row lists pi'sbefore_agent_startadapter; "Non-Claude runtime specifics" acknowledges Codex/Gemini/OpenCode/Pi as shipped.README.md— supported-runtimes sentence bumped from four to five; auto-trigger-discipline paragraph lists pi's adapter; new### Piinstall subsection.skills/using-vibekit/SKILL.md— "How to access skills" gains a Pi entry.skills/ralph-loop/SKILL.md— capability-gate table and cross-runtime portability list both include Pi (degraded checkpoint mode — pi has no native autonomous loop).skills/exec-dispatch/SKILL.md— parallel-group capability-gate table gains a Pi row (sequential fallback; pi has no parallel subagent dispatch primitive).skills/memory-dual/SKILL.md— "all four CLIs" → "all five CLIs"; pi added (memory-dual is pure file I/O, universally portable).skills/_authoring/quad-adapter.md— body bumped to five runtimes (filename retained for backlink stability); pi rows added to the runtime table, capability matrix, and detection signals.
Manifest version-and-description normalization
All seven manifests are now on 0.3.0:
package.json,.claude-plugin/plugin.json,.opencode/plugin.json,gemini-extension.json(were on0.2.1).codex-plugin/plugin.json,.claude-plugin/marketplace.jsonplugin entry (were on0.2.0— pre-existing drift, swept up by this release).pi-plugin/plugin.json(new in this release)
The Codex "execute" / "and integrate" description wording remains pre-existing drift — flagged in the run's review document for a separate normalization pass.
Documentation artifacts
The full vibekit pipeline ran on this work and produced verifiable evidence:
- Spec —
docs/specs/2026-04-29-pi-runtime-adapter-design.md(status: approved) - Plan —
docs/plans/2026-04-29-pi-runtime-adapter.md(10 tasks, TDD-shaped, all checked) - Verification —
docs/verifications/2026-04-29-pi-runtime-adapter.md(vibekit-doctor strict: 11 ok, C11/C12/C13 all ok, no functional skills modified) - Review —
docs/reviews/2026-04-29-pi-runtime-adapter-review.md(0 block, 3 warn, 2 nit; user signed off after one fix iteration covering the consistency sweep + 3 follow-up rows)
Upgrade
For Pi users: pi install git:github.com/rizukirr/vibekit. See docs/INSTALL.pi.md.
For existing Claude Code / OpenCode / Codex / Gemini installs: git pull (manifest-only changes; nothing breaking, no migration needed).
Diff: ~+1,595 / -29 across 33 files in 41 commits. Changelog: v0.2.1...v0.3.0