release: v0.8.4 — non-destructive plugin install + global scope

CHANGELOG.md

@@ -6,6 +6,25 @@ follow [SemVer](https://semver.org/spec/v2.0.0.html) with the
 caveat that pre-1.0 minor bumps may include breaking changes
 (documented in the release notes).
 
+## v0.8.4 — non-destructive plugin install + global scope
+
+ADDED
+  * **Global plugin install.** `kimetsu plugin install <target> --scope global`
+    installs the Kimetsu surface into the user's home for every session —
+    `~/.claude/` + `~/.claude.json` (`mcpServers`) for Claude Code, and
+    `~/.codex/` for Codex — instead of the workspace. `--scope` defaults to
+    `workspace` (the prior behavior). Also exposed as the `scope` argument on
+    the `kimetsu_plugin_install` MCP tool.
+
+FIXED
+  * **Hook install no longer clobbers existing hooks.** `kimetsu plugin install`
+    now *merges* its hooks into existing Claude `settings.json` / Codex
+    `hooks.json` instead of replacing them. Hooks you already have — even on the
+    same events Kimetsu uses (`UserPromptSubmit`, `PreToolUse`, …) — are
+    preserved, with Kimetsu's group added alongside. Re-running install is
+    idempotent (no duplicate groups) and the MCP config + generated docs refresh
+    without requiring `--force`.
+
 ## v0.8.3 — npm distribution
 
 ADDED

Cargo.toml

@@ -14,7 +14,7 @@ resolver = "3"
 # everything below except the per-crate `description`, `keywords`,
 # and `categories` which live in each `[package]` block since
 # crates.io enforces them per crate.
-version = "0.8.3"
+version = "0.8.4"
 edition = "2024"
 # Rust ecosystem dual-license (matches tokio, serde, fastembed-rs,
 # etc.). UNLICENSED would block crates.io entirely.

README.md

@@ -183,8 +183,17 @@ cover Claude Code and Codex:
 ```bash
 kimetsu plugin install claude --workspace .    # writes .mcp.json + .claude/settings.json
 kimetsu plugin install codex  --workspace .    # writes .codex/config.toml + .codex/hooks.json + skill
+
+# Install globally for every project (writes to ~/.claude, ~/.claude.json, ~/.codex):
+kimetsu plugin install claude --scope global
+kimetsu plugin install codex  --scope global
 ```
 
+`--scope` defaults to `workspace`. The installer **merges** into existing
+config: if you already have hooks — even on the same events Kimetsu uses
+(`UserPromptSubmit`, `PreToolUse`, …) — your hooks are kept and Kimetsu's are
+added alongside them. Re-running is idempotent and never needs `--force`.
+
 Now your host agent gets the `kimetsu_*` MCP tools (brain context, memory
 add/list, citations, repo ingest, the cross-harness skill bridge) and starts
 banking memories across every session.