Skip to content

v0.3.0

Choose a tag to compare

@rizukirr rizukirr released this 30 Apr 04:31
· 43 commits to main since this release

Highlights

  • Pi (@mariozechner/pi-coding-agent) is now a fully supported fifth runtime. All 14 vibekit skills, the /vibe slash command, and the using-vibekit auto-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 with pi 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-doctor checks (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.json shape).
  • .pi-plugin/extensions/vibekit-prime.ts — async pi extension that registers a before_agent_start handler. Reads skills/using-vibekit/SKILL.md once at load and appends it (framed in <EXTREMELY_IMPORTANT>) to event.systemPrompt every turn, so pi users get the same auto-trigger priming as Claude Code's SessionStart hook delivers.
  • .pi-plugin/prompts/vibe.md/vibe slash command for pi (uses pi's native $ARGUMENTS syntax, identical body to commands/vibe.md).
  • package.json pi key — registers vibekit as a pi package: pi.skills./skills, pi.prompts./.pi-plugin/prompts, pi.extensions./.pi-plugin/extensions. keywords includes pi-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.md updated with the new command-discovery guidance.

vibekit-doctor (C11–C13)

  • C11 — pi-manifest-present. Asserts .pi-plugin/plugin.json parses and that package.json carries the pi key with skills/prompts/extensions arrays.
  • C12 — pi-extension-canonical-source. Greps .pi-plugin/extensions/vibekit-prime.ts for the literal skills/using-vibekit/SKILL.md path — drift guard against the extension being refactored away from the canonical source.
  • C13 — pi-prompt-stages-match. Extracts every [N/7] token from both commands/vibe.md and .pi-plugin/prompts/vibe.md and demands set-equality on {[1/7]…[7/7]}.
  • .pi-plugin/plugin.json added 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-vibekit table row lists pi's before_agent_start adapter; "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 ### Pi install 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 on 0.2.1)
  • .codex-plugin/plugin.json, .claude-plugin/marketplace.json plugin entry (were on 0.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