diff --git a/.claude/plugins/onebrain/.claude-plugin/plugin.json b/.claude/plugins/onebrain/.claude-plugin/plugin.json
index 5241a9a2..06487008 100644
--- a/.claude/plugins/onebrain/.claude-plugin/plugin.json
+++ b/.claude/plugins/onebrain/.claude-plugin/plugin.json
@@ -1,8 +1,11 @@
 {
   "name": "onebrain",
-  "version": "2.4.13",
+  "version": "3.0.0-alpha.1",
   "description": "OneBrain — Where human and AI thinking become one. A powerful thinking partner powered by AI synergy.",
   "author": {
     "name": "OneBrain Contributors"
+  },
+  "requires": {
+    "cli": ">=3.0.0-alpha.1"
   }
 }
diff --git a/PLUGIN-CHANGELOG.md b/PLUGIN-CHANGELOG.md
index 6db69195..c907a72b 100644
--- a/PLUGIN-CHANGELOG.md
+++ b/PLUGIN-CHANGELOG.md
@@ -1,6 +1,6 @@
 ---
-latest_version: 2.4.13
-released: 2026-05-19
+latest_version: 3.0.0-alpha.1
+released: 2026-05-20
 ---
 
 # Plugin Changelog
@@ -11,6 +11,13 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 > **Versioning:** Plugin version is tracked in `plugin.json`. Bump when ANY harness config changes — skills, agents, hooks, INSTRUCTIONS, Gemini settings, slash commands, etc.
 > For CLI binary (`@onebrain-ai/cli`) changes, see [CHANGELOG.md](CHANGELOG.md).
 
+## v3.0.0-alpha.1 — 2026-05-20
+
+- chore(plugin.json): bump version 2.4.13 → 3.0.0-alpha.1 to mark prerelease compatibility with the Rust CLI rewrite
+- feat(plugin.json): add `requires.cli: ">=3.0.0-alpha.1"` — refuses to load against the Bun-era CLI (v2.x) where the new internal CLI shape would silently misbehave
+- audit(skills): all 13 CLI subcommands referenced by skills (`session-init`, `checkpoint stop`, `checkpoint reset`, `orphan-scan`, `vault-sync`, `register-hooks`, `register-schedule`, `qmd-reindex`, `run-skill`, `update`, plus `--version`) preserved on the Rust side per the v3.0.0-alpha.1 parity smoke test — no skill rewrites required for this bump
+- audit(skills): flagged `node -e "…"` usage in `skills/qmd/SKILL.md`, `skills/update/SKILL.md`, `skills/reorganize/SKILL.md`, `skills/import/**`, and `startup/scripts/open-in-obsidian.sh` as a follow-up — these assume Node is on PATH "because the OneBrain CLI requires it", which the Rust CLI no longer guarantees; deferred per minimal-changes rule, tracked separately
+
 ## v2.4.13 — 2026-05-19
 
 - docs(update): add Known Gotcha about WebFetch returning summarized markdown — recommend `curl -fsSL` for raw-content fetches (`plugin.json`/`settings.json` JSON parsing, `PLUGIN-CHANGELOG.md` verbatim display, `SKILL.md` self-update bootstrap). Symptoms section helps diagnose silent corruption from summarized fetches.