oh-my-customcode 0.67.0 → 0.68.1

package/README.md

@@ -294,6 +294,20 @@ your-project/
 
 ---
 
+## Optional External Tools
+
+oh-my-customcode works fully without any external tools. These optional integrations provide additional capabilities when installed:
+
+| Tool | Purpose | Install | Skill |
+|------|---------|---------|-------|
+| [RTK](https://github.com/rtk-ai/rtk) | 60-90% token savings on CLI output | `brew install rtk` | `/rtk-exec` |
+| [Codex CLI](https://github.com/openai/codex) | OpenAI Codex hybrid workflows | `npm i -g @openai/codex` | `/codex-exec` |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google Gemini hybrid workflows | `npm i -g @anthropic-ai/gemini-cli` | `/gemini-exec` |
+
+When installed, each tool is **auto-detected** at session start and its features become available. When not installed, all commands gracefully fall back to Claude-native alternatives.
+
+---
+
 ## Development
 
 ```bash

package/dist/cli/index.js

@@ -9325,7 +9325,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.67.0",
+    version: "0.68.1",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {
@@ -25513,6 +25513,19 @@ function compareSemver(a, b) {
   }
   return 0;
 }
+function isVersionPlausible(currentVersion, candidateVersion) {
+  const current = normalizeVersion(currentVersion).split(".").map((n) => parseInt(n, 10) || 0);
+  const candidate = normalizeVersion(candidateVersion).split(".").map((n) => parseInt(n, 10) || 0);
+  const majorDiff = (candidate[0] ?? 0) - (current[0] ?? 0);
+  const minorDiff = (candidate[1] ?? 0) - (current[1] ?? 0);
+  if (majorDiff >= 1) {
+    return false;
+  }
+  if (majorDiff === 0 && minorDiff >= 10) {
+    return false;
+  }
+  return true;
+}
 function isInteractiveSession(stdin = process.stdin, stdout = process.stdout) {
   return Boolean(stdin.isTTY && stdout.isTTY);
 }
@@ -25639,12 +25652,16 @@ function checkSelfUpdate(options) {
   let usedCache = false;
   const cache = readCache(cachePath);
   if (cache && isCacheFresh(cache, now, cacheTtlMs)) {
-    latestVersion = normalizeVersion(cache.latestVersion);
-    usedCache = true;
+    const cachedVersion = normalizeVersion(cache.latestVersion);
+    if (isVersionPlausible(currentVersion, cachedVersion)) {
+      latestVersion = cachedVersion;
+      usedCache = true;
+    }
   }
   if (!latestVersion) {
-    latestVersion = fetchLatestVersion(packageName);
-    if (latestVersion) {
+    const fetched = fetchLatestVersion(packageName);
+    if (fetched && isVersionPlausible(currentVersion, fetched)) {
+      latestVersion = fetched;
       writeCache(cachePath, latestVersion, now);
     }
   }

package/dist/index.js

@@ -1674,7 +1674,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.67.0",
+  version: "0.68.1",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.67.0",
+  "version": "0.68.1",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/hooks/hooks.json

@@ -82,6 +82,16 @@
         ],
         "description": "Schema-based tool input validation — Phase 1 advisory only"
       },
+      {
+        "matcher": "tool == \"Bash\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/rtk-intercept.sh"
+          }
+        ],
+        "description": "RTK auto-intercept — transparently rewrites CLI commands through RTK proxy when available (R015 advisory)"
+      },
       {
         "matcher": "tool == \"Task\" || tool == \"Agent\"",
         "hooks": [

package/templates/.claude/hooks/scripts/rtk-intercept.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# RTK Auto-Intercept Hook
+# Trigger: PreToolUse (Bash matcher)
+# Purpose: Transparently rewrite CLI commands through RTK proxy
+# Protocol: stdin JSON → stdout modified JSON, exit 0 always
+
+set -euo pipefail
+
+input=$(cat)
+
+# Only intercept Bash tool calls
+tool_name=$(echo "$input" | jq -r '.tool // empty' 2>/dev/null || echo "")
+if [ "$tool_name" != "Bash" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# Check RTK availability
+RTK_AVAILABLE=false
+STATUS_FILE="/tmp/.claude-env-status-${PPID}"
+if [ -f "$STATUS_FILE" ] && grep -q "rtk=available" "$STATUS_FILE" 2>/dev/null; then
+  RTK_AVAILABLE=true
+elif command -v rtk >/dev/null 2>&1; then
+  RTK_AVAILABLE=true
+fi
+
+if [ "$RTK_AVAILABLE" != "true" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# Extract command
+cmd=$(echo "$input" | jq -r '.tool_input.command // empty' 2>/dev/null || echo "")
+if [ -z "$cmd" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# Skip if already using rtk
+if echo "$cmd" | grep -qE '^rtk\b'; then
+  echo "$input"
+  exit 0
+fi
+
+# Skip complex commands (pipes, redirections, background, subshells, semicolons with multiple commands)
+if echo "$cmd" | grep -qE '[|><&]|;\s*\w'; then
+  echo "$input"
+  exit 0
+fi
+
+# RTK-supported command prefixes
+RTK_CMDS="ls find tree du cat head tail wc grep rg git cargo npm pnpm bun pip pytest vitest jest rspec eslint tsc ruff docker kubectl"
+
+# Extract first word of command (skip env var assignments like FOO=bar)
+first_word=$(echo "$cmd" | sed 's/^[A-Z_]*=[^ ]* //' | awk '{print $1}')
+
+# Check if command is RTK-supported
+SUPPORTED=false
+for rtk_cmd in $RTK_CMDS; do
+  if [ "$first_word" = "$rtk_cmd" ]; then
+    SUPPORTED=true
+    break
+  fi
+done
+
+if [ "$SUPPORTED" != "true" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# Rewrite command with rtk prefix
+new_cmd="rtk $cmd"
+echo "[RTK] Intercepted: $cmd → $new_cmd" >&2
+
+# Output modified JSON
+echo "$input" | jq --arg new_cmd "$new_cmd" '.tool_input.command = $new_cmd'
+exit 0

package/templates/.claude/hooks/scripts/session-env-check.sh

@@ -60,6 +60,15 @@ if [ "$CLAUDE_VERSION" != "unknown" ]; then
   fi
 fi
 
+# v2.1.88+ features notice
+if [ "$CLAUDE_VERSION" != "unknown" ]; then
+  if printf '%s\n' "2.1.88" "$CLAUDE_VERSION" | sort -V | head -1 | grep -q "^2\.1\.88$"; then
+    if [ -z "${CLAUDE_CODE_NO_FLICKER:-}" ]; then
+      echo "  [v2.1.88] Tip: CLAUDE_CODE_NO_FLICKER=1 for flicker-free rendering" >&2
+    fi
+  fi
+fi
+
 # Git workflow reminder
 CURRENT_BRANCH="unknown"
 if command -v git >/dev/null 2>&1 && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then

package/templates/.claude/rules/MUST-agent-design.md

@@ -85,6 +85,7 @@ All supported hook event types in Claude Code. Agents and skills can reference t
 | `Elicitation` | Agent requests user input | question | command, prompt | v2.1.76+ |
 | `ElicitationResult` | User responds to elicitation | answer | command, prompt | v2.1.76+ |
 | `PostMessage` | After message sent | message_type | command | v2.1.76+ |
+| `PermissionDenied` | Auto mode classifier denial | tool, tool_input, denial_reason | command, prompt | v2.1.88+ |
 | `TeammateIdle` | Agent Teams member idle | teammate_id | command | v2.1.83+ |
 | `TaskCreated` | Task created | task_id, description | command | v2.1.83+ |
 | `TaskCompleted` | Task completed | task_id, result | command | v2.1.83+ |
@@ -110,6 +111,8 @@ hooks:
       command: "echo hook"
 ```
 
+> **v2.1.85+**: `if` field supports permission rule syntax for conditional hook execution. **v2.1.88** extended `if` matching to support compound commands (`ls && git push`) and commands with env-var prefixes (`FOO=bar git push`).
+
 ## Permission Mode Guidance
 
 When spawning agents via the Agent tool, CC applies a default `mode` of `acceptEdits` if not explicitly specified. To maintain consistent permission behavior:

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.67.0",
+  "version": "0.68.1",
   "lastUpdated": "2026-03-24T00:00:00.000Z",
   "components": [
     {