Gemini CLI support, rm→trash / git→stash data safety rtk.*.md rules, chained command rewriting, Rust-based hooks

Cargo.toml

@@ -27,6 +27,9 @@ toml = "0.8"
 chrono = "0.4"
 thiserror = "1.0"
 tempfile = "3"
+trash = "5"      # Built-in trash (cross-platform)
+which = "7"      # Find binaries in PATH (for exec module)
+serde_yaml = "0.9"  # YAML frontmatter in rule MD files
 
 [dev-dependencies]
 

INSTALL.md

@@ -75,7 +75,7 @@ rtk gain  # MUST show token savings, not "command not found"
 
 ```bash
 rtk init -g
-# → Installs hook to ~/.claude/hooks/rtk-rewrite.sh
+# → Registers "rtk hook claude" in ~/.claude/settings.json
 # → Creates ~/.claude/RTK.md (10 lines, meta commands only)
 # → Adds @RTK.md reference to ~/.claude/CLAUDE.md
 # → Prompts: "Patch settings.json? [y/N]"
@@ -111,6 +111,37 @@ rtk init  # Creates ./CLAUDE.md with full RTK instructions (137 lines)
 
 **Token savings**: Instructions loaded only for this project
 
+### Gemini CLI Setup
+
+**Best for: Gemini CLI users wanting the same token optimization**
+
+```bash
+rtk init --gemini
+# → Registers "rtk hook gemini" in ~/.gemini/settings.json
+# → Prompts: "Patch settings.json? [y/N]"
+# → If yes: patches + creates backup (~/.gemini/settings.json.bak)
+
+# Automated alternatives:
+rtk init --gemini --auto-patch    # Patch without prompting
+rtk init --gemini --no-patch      # Print manual instructions instead
+
+# Verify installation
+rtk init --show  # Shows both Claude and Gemini hook status
+```
+
+**Manual setup** (if `rtk init --gemini` isn't available):
+```json
+// Add to ~/.gemini/settings.json
+{
+  "hooks": {
+    "BeforeTool": [{
+      "matcher": "run_shell_command",
+      "hooks": [{ "type": "command", "command": "rtk hook gemini" }]
+    }]
+  }
+}
+```
+
 ### Upgrading from Previous Version
 
 If you previously used `rtk init -g` with the old system (137-line injection):
@@ -195,7 +226,7 @@ rtk vitest run
 rtk init -g --uninstall
 
 # What gets removed:
-#   - Hook: ~/.claude/hooks/rtk-rewrite.sh
+#   - Hook: RTK entry from ~/.claude/settings.json
 #   - Context: ~/.claude/RTK.md
 #   - Reference: @RTK.md line from ~/.claude/CLAUDE.md
 #   - Registration: RTK hook entry from settings.json