@vibescore/tracker 0.2.2 → 0.2.4

package/README.md

@@ -64,6 +64,7 @@ npx --yes @vibescore/tracker init
 ```
 
 Note: If `~/.code/config.toml` exists (or `CODE_HOME`), `init` also configures Every Code `notify` automatically. No further user intervention is required for data sync.
+Note: If Gemini CLI home exists, `init` installs a `SessionEnd` hook in `~/.gemini/settings.json` and sets `tools.enableHooks = true` so hooks execute. This enables all Gemini hooks; disable by setting `tools.enableHooks = false` (or disabling the `vibescore-tracker` hook).
 
 ### Sync & Status
 

package/README.zh-CN.md

@@ -64,6 +64,7 @@ npx --yes @vibescore/tracker init
 ```
 
 说明：若存在 `~/.code/config.toml`（或 `CODE_HOME`），`init` 会自动配置 Every Code 的 `notify`。配置完成后，数据同步完全自动化，无需后续人工干预。
+说明：若检测到 Gemini CLI home，`init` 会在 `~/.gemini/settings.json` 安装 `SessionEnd` hook，并将 `tools.enableHooks = true` 以确保 hook 生效。这会启用所有 Gemini hooks；如需关闭，可将 `tools.enableHooks = false`（或禁用 `vibescore-tracker` hook）。
 
 ### 同步与状态查看
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescore/tracker",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
   "publishConfig": {

package/src/commands/init.js

@@ -14,6 +14,12 @@ const {
   loadEveryCodeNotifyOriginal
 } = require('../lib/codex-config');
 const { upsertClaudeHook, buildClaudeHookCommand } = require('../lib/claude-config');
+const {
+  resolveGeminiConfigDir,
+  resolveGeminiSettingsPath,
+  buildGeminiHookCommand,
+  upsertGeminiHook
+} = require('../lib/gemini-config');
 const { resolveOpencodeConfigDir, upsertOpencodePlugin } = require('../lib/opencode-config');
 const { beginBrowserAuth } = require('../lib/browser-auth');
 const {
@@ -126,19 +132,26 @@ async function cmdInit(argv) {
   await fs.chmod(notifyPath, 0o755).catch(() => {});
 
   // Configure Codex notify hook.
-  const codexConfigPath = path.join(home, '.codex', 'config.toml');
+  const codexHome = process.env.CODEX_HOME || path.join(home, '.codex');
+  const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const notifyCmd = ['/usr/bin/env', 'node', notifyPath];
-  const result = await upsertCodexNotify({
-    codexConfigPath,
-    notifyCmd,
-    notifyOriginalPath
-  });
-
-  const chained = await loadCodexNotifyOriginal(notifyOriginalPath);
+  const codexProbe = await probeFile(codexConfigPath);
+  const codexConfigExists = codexProbe.exists;
+  let result = null;
+  let chained = null;
+  if (codexConfigExists) {
+    result = await upsertCodexNotify({
+      codexConfigPath,
+      notifyCmd,
+      notifyOriginalPath
+    });
+    chained = await loadCodexNotifyOriginal(notifyOriginalPath);
+  }
   const codeNotifyOriginalPath = path.join(trackerDir, 'code_notify_original.json');
-  const codeConfigExists = await isFile(codeConfigPath);
+  const codeProbe = await probeFile(codeConfigPath);
+  const codeConfigExists = codeProbe.exists;
   let codeResult = null;
   let codeChained = null;
   if (codeConfigExists) {
@@ -163,6 +176,18 @@ async function cmdInit(argv) {
     });
   }
 
+  const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
+  const geminiConfigExists = await isDir(geminiConfigDir);
+  const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
+  let geminiResult = null;
+  if (geminiConfigExists) {
+    const geminiHookCommand = buildGeminiHookCommand(notifyPath);
+    geminiResult = await upsertGeminiHook({
+      settingsPath: geminiSettingsPath,
+      hookCommand: geminiHookCommand
+    });
+  }
+
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
   const opencodeResult = await upsertOpencodePlugin({
     configDir: opencodeConfigDir,
@@ -174,10 +199,18 @@ async function cmdInit(argv) {
       'Installed:',
       `- Tracker config: ${configPath}`,
       `- Notify handler: ${notifyPath}`,
-      `- Codex config: ${codexConfigPath}`,
-      result.changed ? '- Codex notify: updated' : '- Codex notify: already set',
-      chained ? '- Codex notify: chained (original preserved)' : '- Codex notify: no original',
-      codeConfigExists ? `- Every Code config: ${codeConfigPath}` : '- Every Code notify: skipped (config.toml not found)',
+      codexConfigExists
+        ? `- Codex config: ${codexConfigPath}`
+        : `- Codex notify: skipped (${renderProbeSkip(codexConfigPath, codexProbe)})`,
+      codexConfigExists
+        ? result?.changed
+          ? '- Codex notify: updated'
+          : '- Codex notify: already set'
+        : null,
+      codexConfigExists ? (chained ? '- Codex notify: chained (original preserved)' : '- Codex notify: no original') : null,
+      codeConfigExists
+        ? `- Every Code config: ${codeConfigPath}`
+        : `- Every Code notify: skipped (${renderProbeSkip(codeConfigPath, codeProbe)})`,
       codeConfigExists && codeResult
         ? codeResult.changed
           ? '- Every Code notify: updated'
@@ -193,6 +226,11 @@ async function cmdInit(argv) {
           ? `- Claude hooks: updated (${claudeSettingsPath})`
           : `- Claude hooks: already set (${claudeSettingsPath})`
         : '- Claude hooks: skipped (~/.claude not found)',
+      geminiConfigExists
+        ? geminiResult?.changed
+          ? `- Gemini hooks: updated (${geminiSettingsPath})`
+          : `- Gemini hooks: already set (${geminiSettingsPath})`
+        : `- Gemini hooks: skipped (${geminiConfigDir} not found)`,
       opencodeResult?.skippedReason === 'config-missing'
         ? '- Opencode plugin: skipped (config dir missing)'
         : opencodeResult?.changed
@@ -321,7 +359,7 @@ try {
   const originalPath =
     source === 'every-code'
       ? codeOriginalPath
-      : source === 'claude' || source === 'opencode'
+      : source === 'claude' || source === 'opencode' || source === 'gemini'
         ? null
         : codexOriginalPath;
   if (originalPath) {
@@ -406,6 +444,26 @@ async function isFile(p) {
   }
 }
 
+async function probeFile(p) {
+  try {
+    const st = await fs.stat(p);
+    if (st.isFile()) return { exists: true, reason: null };
+    return { exists: false, reason: 'not-file' };
+  } catch (e) {
+    if (e?.code === 'ENOENT' || e?.code === 'ENOTDIR') return { exists: false, reason: 'missing' };
+    if (e?.code === 'EACCES' || e?.code === 'EPERM') return { exists: false, reason: 'permission-denied' };
+    return { exists: false, reason: 'error', code: e?.code || 'unknown' };
+  }
+}
+
+function renderProbeSkip(pathname, probe) {
+  if (!probe || probe.reason === 'missing') return `${pathname} not found`;
+  if (probe.reason === 'not-file') return `${pathname} is not a file`;
+  if (probe.reason === 'permission-denied') return `permission denied: ${pathname}`;
+  const code = probe.code ? ` (${probe.code})` : '';
+  return `unavailable: ${pathname}${code}`;
+}
+
 async function isDir(p) {
   try {
     const st = await fs.stat(p);

package/src/commands/status.js

@@ -5,6 +5,12 @@ const fs = require('node:fs/promises');
 const { readJson } = require('../lib/fs');
 const { readCodexNotify, readEveryCodeNotify } = require('../lib/codex-config');
 const { isClaudeHookConfigured, buildClaudeHookCommand } = require('../lib/claude-config');
+const {
+  resolveGeminiConfigDir,
+  resolveGeminiSettingsPath,
+  isGeminiHookConfigured,
+  buildGeminiHookCommand
+} = require('../lib/gemini-config');
 const { resolveOpencodeConfigDir, isOpencodePluginInstalled } = require('../lib/opencode-config');
 const { normalizeState: normalizeUploadState } = require('../lib/upload-throttle');
 const { collectTrackerDiagnostics } = require('../lib/diagnostics');
@@ -32,8 +38,11 @@ async function cmdStatus(argv = []) {
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
+  const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
   const claudeHookCommand = buildClaudeHookCommand(path.join(home, '.vibescore', 'bin', 'notify.cjs'));
+  const geminiHookCommand = buildGeminiHookCommand(path.join(home, '.vibescore', 'bin', 'notify.cjs'));
 
   const config = await readJson(configPath);
   const cursors = await readJson(cursorsPath);
@@ -55,6 +64,10 @@ async function cmdStatus(argv = []) {
     settingsPath: claudeSettingsPath,
     hookCommand: claudeHookCommand
   });
+  const geminiHookConfigured = await isGeminiHookConfigured({
+    settingsPath: geminiSettingsPath,
+    hookCommand: geminiHookCommand
+  });
   const opencodePluginConfigured = await isOpencodePluginInstalled({ configDir: opencodeConfigDir });
 
   const lastUpload = uploadThrottle.lastSuccessMs
@@ -91,6 +104,7 @@ async function cmdStatus(argv = []) {
       `- Codex notify: ${notifyConfigured ? JSON.stringify(codexNotify) : 'unset'}`,
       `- Every Code notify: ${everyCodeConfigured ? JSON.stringify(everyCodeNotify) : 'unset'}`,
       `- Claude hooks: ${claudeHookConfigured ? 'set' : 'unset'}`,
+      `- Gemini hooks: ${geminiHookConfigured ? 'set' : 'unset'}`,
       `- Opencode plugin: ${opencodePluginConfigured ? 'set' : 'unset'}`,
       ''
     ]

package/src/commands/uninstall.js

@@ -4,6 +4,12 @@ const fs = require('node:fs/promises');
 
 const { restoreCodexNotify, restoreEveryCodeNotify } = require('../lib/codex-config');
 const { removeClaudeHook, buildClaudeHookCommand } = require('../lib/claude-config');
+const {
+  resolveGeminiConfigDir,
+  resolveGeminiSettingsPath,
+  buildGeminiHookCommand,
+  removeGeminiHook
+} = require('../lib/gemini-config');
 const { resolveOpencodeConfigDir, removeOpencodePlugin } = require('../lib/opencode-config');
 
 async function cmdUninstall(argv) {
@@ -11,10 +17,13 @@ async function cmdUninstall(argv) {
   const home = os.homedir();
   const trackerDir = path.join(home, '.vibescore', 'tracker');
   const binDir = path.join(home, '.vibescore', 'bin');
-  const codexConfigPath = path.join(home, '.codex', 'config.toml');
+  const codexHome = process.env.CODEX_HOME || path.join(home, '.codex');
+  const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeHome = process.env.CODE_HOME || path.join(home, '.code');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeSettingsPath = path.join(home, '.claude', 'settings.json');
+  const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
+  const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
   const notifyPath = path.join(binDir, 'notify.cjs');
   const notifyOriginalPath = path.join(trackerDir, 'codex_notify_original.json');
@@ -22,10 +31,12 @@ async function cmdUninstall(argv) {
   const codexNotifyCmd = ['/usr/bin/env', 'node', notifyPath];
   const codeNotifyCmd = ['/usr/bin/env', 'node', notifyPath, '--source=every-code'];
   const claudeHookCommand = buildClaudeHookCommand(notifyPath);
+  const geminiHookCommand = buildGeminiHookCommand(notifyPath);
 
   const codexConfigExists = await isFile(codexConfigPath);
   const codeConfigExists = await isFile(codeConfigPath);
   const claudeConfigExists = await isFile(claudeSettingsPath);
+  const geminiConfigExists = await isDir(geminiConfigDir);
   const opencodeConfigExists = await isDir(opencodeConfigDir);
   const codexRestore = codexConfigExists
     ? await restoreCodexNotify({
@@ -44,6 +55,9 @@ async function cmdUninstall(argv) {
   const claudeRemove = claudeConfigExists
     ? await removeClaudeHook({ settingsPath: claudeSettingsPath, hookCommand: claudeHookCommand })
     : { removed: false, skippedReason: 'config-missing' };
+  const geminiRemove = geminiConfigExists
+    ? await removeGeminiHook({ settingsPath: geminiSettingsPath, hookCommand: geminiHookCommand })
+    : { removed: false, skippedReason: 'config-missing' };
   const opencodeRemove = opencodeConfigExists
     ? await removeOpencodePlugin({ configDir: opencodeConfigDir })
     : { removed: false, skippedReason: 'config-missing' };
@@ -82,6 +96,13 @@ async function cmdUninstall(argv) {
             ? '- Claude hooks: no change'
             : '- Claude hooks: skipped'
         : '- Claude hooks: skipped (settings.json not found)',
+      geminiConfigExists
+        ? geminiRemove?.removed
+          ? `- Gemini hooks removed: ${geminiSettingsPath}`
+          : geminiRemove?.skippedReason === 'hook-missing'
+            ? '- Gemini hooks: no change'
+            : '- Gemini hooks: skipped'
+        : `- Gemini hooks: skipped (${geminiConfigDir} not found)`,
       opencodeConfigExists
         ? opencodeRemove?.removed
           ? `- Opencode plugin removed: ${opencodeConfigDir}`

package/src/lib/browser-auth.js

@@ -7,10 +7,13 @@ const DEFAULT_BASE_URL = 'https://5tmappuk.us-east.insforge.app';
 async function beginBrowserAuth({ baseUrl, dashboardUrl, timeoutMs, open }) {
   const nonce = crypto.randomBytes(16).toString('hex');
   const callbackPath = `/vibescore/callback/${nonce}`;
-
-  const { callbackUrl, waitForCallback } = await startLocalCallbackServer({ callbackPath, timeoutMs });
-
   const authUrl = dashboardUrl ? new URL('/', dashboardUrl) : new URL('/auth/sign-up', baseUrl);
+  const postAuthRedirect = resolvePostAuthRedirect({ dashboardUrl, authUrl });
+  const { callbackUrl, waitForCallback } = await startLocalCallbackServer({
+    callbackPath,
+    timeoutMs,
+    redirectUrl: postAuthRedirect
+  });
   authUrl.searchParams.set('redirect', callbackUrl);
   if (dashboardUrl && baseUrl && baseUrl !== DEFAULT_BASE_URL) authUrl.searchParams.set('base_url', baseUrl);
 
@@ -19,7 +22,7 @@ async function beginBrowserAuth({ baseUrl, dashboardUrl, timeoutMs, open }) {
   return { authUrl: authUrl.toString(), waitForCallback };
 }
 
-async function startLocalCallbackServer({ callbackPath, timeoutMs }) {
+async function startLocalCallbackServer({ callbackPath, timeoutMs, redirectUrl }) {
   let resolved = false;
   let resolveResult;
   let rejectResult;
@@ -58,17 +61,34 @@ async function startLocalCallbackServer({ callbackPath, timeoutMs }) {
     }
 
     resolved = true;
-    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-    res.end(
-      [
-        '<!doctype html>',
-        '<html><head><meta charset="utf-8"><title>VibeScore</title></head>',
-        '<body>',
-        '<h2>Login succeeded</h2>',
-        '<p>You can close this tab and return to the CLI.</p>',
-        '</body></html>'
-      ].join('')
-    );
+    if (redirectUrl) {
+      res.writeHead(302, {
+        Location: redirectUrl,
+        'Content-Type': 'text/html; charset=utf-8'
+      });
+      res.end(
+        [
+          '<!doctype html>',
+          '<html><head><meta charset="utf-8"><title>VibeScore</title></head>',
+          '<body>',
+          '<h2>Login succeeded</h2>',
+          `<p>Redirecting to <a href="${redirectUrl}">dashboard</a>...</p>`,
+          '</body></html>'
+        ].join('')
+      );
+    } else {
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+      res.end(
+        [
+          '<!doctype html>',
+          '<html><head><meta charset="utf-8"><title>VibeScore</title></head>',
+          '<body>',
+          '<h2>Login succeeded</h2>',
+          '<p>You can close this tab and return to the CLI.</p>',
+          '</body></html>'
+        ].join('')
+      );
+    }
 
     resolveResult({
       accessToken,
@@ -134,6 +154,21 @@ function openInBrowser(url) {
   } catch (_e) {}
 }
 
+function resolvePostAuthRedirect({ dashboardUrl, authUrl }) {
+  try {
+    if (dashboardUrl) {
+      const target = new URL('/', dashboardUrl);
+      if (target.protocol === 'http:' || target.protocol === 'https:') {
+        return target.toString();
+      }
+      return null;
+    }
+  } catch (_e) {
+    return null;
+  }
+  return null;
+}
+
 module.exports = {
   beginBrowserAuth
 };

package/src/lib/diagnostics.js

@@ -5,6 +5,12 @@ const fs = require('node:fs/promises');
 const { readJson } = require('./fs');
 const { readCodexNotify, readEveryCodeNotify } = require('./codex-config');
 const { isClaudeHookConfigured, buildClaudeHookCommand } = require('./claude-config');
+const {
+  resolveGeminiConfigDir,
+  resolveGeminiSettingsPath,
+  buildGeminiHookCommand,
+  isGeminiHookConfigured
+} = require('./gemini-config');
 const { resolveOpencodeConfigDir, isOpencodePluginInstalled } = require('./opencode-config');
 const { normalizeState: normalizeUploadState } = require('./upload-throttle');
 
@@ -25,6 +31,8 @@ async function collectTrackerDiagnostics({
   const codexConfigPath = path.join(codexHome, 'config.toml');
   const codeConfigPath = path.join(codeHome, 'config.toml');
   const claudeConfigPath = path.join(home, '.claude', 'settings.json');
+  const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
+  const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
   const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
 
   const config = await readJson(configPath);
@@ -51,6 +59,11 @@ async function collectTrackerDiagnostics({
     settingsPath: claudeConfigPath,
     hookCommand: claudeHookCommand
   });
+  const geminiHookCommand = buildGeminiHookCommand(path.join(home, '.vibescore', 'bin', 'notify.cjs'));
+  const geminiHookConfigured = await isGeminiHookConfigured({
+    settingsPath: geminiSettingsPath,
+    hookCommand: geminiHookCommand
+  });
   const opencodePluginConfigured = await isOpencodePluginInstalled({ configDir: opencodeConfigDir });
 
   const lastSuccessAt = uploadThrottle.lastSuccessMs ? new Date(uploadThrottle.lastSuccessMs).toISOString() : null;
@@ -72,6 +85,7 @@ async function collectTrackerDiagnostics({
       code_home: redactValue(codeHome, home),
       code_config: redactValue(codeConfigPath, home),
       claude_config: redactValue(claudeConfigPath, home),
+      gemini_config: redactValue(geminiSettingsPath, home),
       opencode_config: redactValue(opencodeConfigDir, home)
     },
     config: {
@@ -98,6 +112,7 @@ async function collectTrackerDiagnostics({
       every_code_notify_configured: everyCodeConfigured,
       every_code_notify: everyCodeNotify,
       claude_hook_configured: claudeHookConfigured,
+      gemini_hook_configured: geminiHookConfigured,
       opencode_plugin_configured: opencodePluginConfigured
     },
     upload: {

package/src/lib/gemini-config.js

@@ -0,0 +1,284 @@
+const os = require('node:os');
+const path = require('node:path');
+const fs = require('node:fs/promises');
+
+const { ensureDir, readJson, writeJson } = require('./fs');
+
+const DEFAULT_EVENT = 'SessionEnd';
+const DEFAULT_HOOK_NAME = 'vibescore-tracker';
+const DEFAULT_MATCHER = 'exit|clear|logout|prompt_input_exit|other';
+
+function resolveGeminiConfigDir({ home = os.homedir(), env = process.env } = {}) {
+  const explicit = typeof env.GEMINI_HOME === 'string' ? env.GEMINI_HOME.trim() : '';
+  if (explicit) return path.resolve(explicit);
+  return path.join(home, '.gemini');
+}
+
+function resolveGeminiSettingsPath({ configDir }) {
+  return path.join(configDir, 'settings.json');
+}
+
+async function upsertGeminiHook({
+  settingsPath,
+  hookCommand,
+  hookName = DEFAULT_HOOK_NAME,
+  matcher = DEFAULT_MATCHER,
+  event = DEFAULT_EVENT
+}) {
+  const existing = await readJson(settingsPath);
+  const settings = normalizeSettings(existing);
+  const enableResult = ensureHooksEnabled(settings);
+  const baseSettings = enableResult.settings;
+  const hooks = normalizeHooks(settings.hooks);
+  const entries = normalizeEntries(hooks[event]);
+
+  const normalized = normalizeEntriesForHook(entries, { hookCommand, hookName });
+  let nextEntries = normalized.entries;
+  let changed = normalized.changed || enableResult.changed;
+
+  if (!hasHook(nextEntries, { hookCommand, hookName })) {
+    nextEntries = nextEntries.concat([buildHookEntry({ hookCommand, hookName, matcher })]);
+    changed = true;
+  }
+
+  if (!changed) return { changed: false, backupPath: null };
+
+  const nextHooks = { ...hooks, [event]: nextEntries };
+  const nextSettings = { ...baseSettings, hooks: nextHooks };
+  const backupPath = await writeGeminiSettings({ settingsPath, settings: nextSettings });
+  return { changed: true, backupPath };
+}
+
+async function removeGeminiHook({
+  settingsPath,
+  hookCommand,
+  hookName = DEFAULT_HOOK_NAME,
+  event = DEFAULT_EVENT
+}) {
+  const existing = await readJson(settingsPath);
+  if (!existing) return { removed: false, skippedReason: 'settings-missing' };
+
+  const settings = normalizeSettings(existing);
+  const hooks = normalizeHooks(settings.hooks);
+  const entries = normalizeEntries(hooks[event]);
+  if (entries.length === 0) return { removed: false, skippedReason: 'hook-missing' };
+
+  let removed = false;
+  const nextEntries = [];
+  for (const entry of entries) {
+    const res = stripHookFromEntry(entry, { hookCommand, hookName });
+    if (res.removed) removed = true;
+    if (res.entry) nextEntries.push(res.entry);
+  }
+
+  if (!removed) return { removed: false, skippedReason: 'hook-missing' };
+
+  const nextHooks = { ...hooks };
+  if (nextEntries.length > 0) nextHooks[event] = nextEntries;
+  else delete nextHooks[event];
+
+  const nextSettings = { ...settings };
+  if (Object.keys(nextHooks).length > 0) nextSettings.hooks = nextHooks;
+  else delete nextSettings.hooks;
+
+  const backupPath = await writeGeminiSettings({ settingsPath, settings: nextSettings });
+  return { removed: true, skippedReason: null, backupPath };
+}
+
+async function isGeminiHookConfigured({
+  settingsPath,
+  hookCommand,
+  hookName = DEFAULT_HOOK_NAME,
+  event = DEFAULT_EVENT
+}) {
+  const settings = await readJson(settingsPath);
+  if (!settings || typeof settings !== 'object') return false;
+  const hooks = settings.hooks;
+  if (!hooks || typeof hooks !== 'object') return false;
+  const entries = normalizeEntries(hooks[event]);
+  return hasHook(entries, { hookCommand, hookName });
+}
+
+function buildGeminiHookCommand(notifyPath) {
+  const cmd = typeof notifyPath === 'string' ? notifyPath : '';
+  return `/usr/bin/env node ${quoteArg(cmd)} --source=gemini`;
+}
+
+function buildHookEntry({ hookCommand, hookName, matcher }) {
+  const hook = {
+    name: hookName,
+    type: 'command',
+    command: hookCommand
+  };
+  const entry = { hooks: [hook] };
+  if (typeof matcher === 'string' && matcher.length > 0) entry.matcher = matcher;
+  return entry;
+}
+
+function normalizeSettings(raw) {
+  return raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+}
+
+function normalizeHooks(raw) {
+  return raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+}
+
+function normalizeTools(raw) {
+  return raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+}
+
+function normalizeEntries(raw) {
+  return Array.isArray(raw) ? raw.slice() : [];
+}
+
+function normalizeCommand(cmd) {
+  if (Array.isArray(cmd)) return cmd.map((v) => String(v)).join('\u0000');
+  if (typeof cmd === 'string') return cmd.trim();
+  return null;
+}
+
+function normalizeName(name) {
+  if (typeof name !== 'string') return null;
+  const trimmed = name.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+function ensureHooksEnabled(settings) {
+  const tools = normalizeTools(settings.tools);
+  if (tools.enableHooks === true) return { settings, changed: false };
+  const nextTools = { ...tools, enableHooks: true };
+  return { settings: { ...settings, tools: nextTools }, changed: true };
+}
+
+function hookMatches(hook, { hookCommand, hookName, requireCommand = false }) {
+  if (!hook || typeof hook !== 'object') return false;
+  const name = normalizeName(hook.name);
+  const targetName = normalizeName(hookName);
+  const cmd = normalizeCommand(hook.command);
+  const targetCmd = normalizeCommand(hookCommand);
+  const commandMatches = Boolean(cmd && targetCmd && cmd === targetCmd);
+  if (requireCommand) return commandMatches;
+  const nameMatches = Boolean(name && targetName && name === targetName);
+  return Boolean(commandMatches || nameMatches);
+}
+
+function entryMatches(entry, { hookCommand, hookName, requireCommand = false }) {
+  if (!entry || typeof entry !== 'object') return false;
+  if (entry.command || entry.name) return hookMatches(entry, { hookCommand, hookName, requireCommand });
+  if (!Array.isArray(entry.hooks)) return false;
+  return entry.hooks.some((hook) => hookMatches(hook, { hookCommand, hookName, requireCommand }));
+}
+
+function hasHook(entries, { hookCommand, hookName }) {
+  return entries.some((entry) => entryMatches(entry, { hookCommand, hookName }));
+}
+
+function normalizeEntriesForHook(entries, { hookCommand, hookName }) {
+  let changed = false;
+  const nextEntries = entries.map((entry) => {
+    if (!entry || typeof entry !== 'object') return entry;
+
+    if (entry.command || entry.name) {
+      if (hookMatches(entry, { hookCommand, hookName })) {
+        const next = normalizeHookObject(entry, { hookCommand, hookName });
+        if (next !== entry) changed = true;
+        return next;
+      }
+      return entry;
+    }
+
+    const hooks = Array.isArray(entry.hooks) ? entry.hooks : null;
+    if (!hooks) return entry;
+
+    let hooksChanged = false;
+    const nextHooks = hooks.map((hook) => {
+      if (hookMatches(hook, { hookCommand, hookName })) {
+        const next = normalizeHookObject(hook, { hookCommand, hookName });
+        if (next !== hook) hooksChanged = true;
+        return next;
+      }
+      return hook;
+    });
+
+    if (!hooksChanged) return entry;
+    changed = true;
+    return { ...entry, hooks: nextHooks };
+  });
+
+  return { entries: nextEntries, changed };
+}
+
+function normalizeHookObject(hook, { hookCommand, hookName }) {
+  const next = { ...hook };
+  let changed = false;
+
+  if (next.type !== 'command') {
+    next.type = 'command';
+    changed = true;
+  }
+
+  if (hookCommand && next.command !== hookCommand) {
+    next.command = hookCommand;
+    changed = true;
+  }
+
+  if (hookName && next.name !== hookName) {
+    next.name = hookName;
+    changed = true;
+  }
+
+  return changed ? next : hook;
+}
+
+function stripHookFromEntry(entry, { hookCommand, hookName }) {
+  if (!entry || typeof entry !== 'object') return { entry, removed: false };
+
+  if (entry.command || entry.name) {
+    if (hookMatches(entry, { hookCommand, hookName, requireCommand: true })) return { entry: null, removed: true };
+    return { entry, removed: false };
+  }
+
+  const hooks = Array.isArray(entry.hooks) ? entry.hooks : null;
+  if (!hooks) return { entry, removed: false };
+
+  const nextHooks = hooks.filter((hook) => !hookMatches(hook, { hookCommand, hookName, requireCommand: true }));
+  if (nextHooks.length === hooks.length) return { entry, removed: false };
+  if (nextHooks.length === 0) return { entry: null, removed: true };
+
+  return { entry: { ...entry, hooks: nextHooks }, removed: true };
+}
+
+function quoteArg(value) {
+  const v = typeof value === 'string' ? value : '';
+  if (!v) return '""';
+  if (/^[A-Za-z0-9_\-./:@]+$/.test(v)) return v;
+  return `"${v.replace(/"/g, '\\"')}"`;
+}
+
+async function writeGeminiSettings({ settingsPath, settings }) {
+  await ensureDir(path.dirname(settingsPath));
+  let backupPath = null;
+  try {
+    const st = await fs.stat(settingsPath);
+    if (st && st.isFile()) {
+      backupPath = `${settingsPath}.bak.${new Date().toISOString().replace(/[:.]/g, '-')}`;
+      await fs.copyFile(settingsPath, backupPath);
+    }
+  } catch (_e) {
+    // Ignore missing file.
+  }
+  await writeJson(settingsPath, settings);
+  return backupPath;
+}
+
+module.exports = {
+  DEFAULT_EVENT,
+  DEFAULT_HOOK_NAME,
+  DEFAULT_MATCHER,
+  resolveGeminiConfigDir,
+  resolveGeminiSettingsPath,
+  buildGeminiHookCommand,
+  upsertGeminiHook,
+  removeGeminiHook,
+  isGeminiHookConfigured
+};

package/src/lib/opencode-config.js

@@ -30,7 +30,7 @@ function buildOpencodePlugin({ notifyPath }) {
     `      if (!event || event.type !== ${JSON.stringify(DEFAULT_EVENT)}) return;\n` +
     `      try {\n` +
     `        if (!notifyPath) return;\n` +
-    `        const proc = $\\\`/usr/bin/env node ${'${notifyPath}'} --source=opencode\\\`;\n` +
+    `        const proc = $\`/usr/bin/env node ${'${notifyPath}'} --source=opencode\`;\n` +
     `        if (proc && typeof proc.catch === 'function') proc.catch(() => {});\n` +
     `      } catch (_) {}\n` +
     `    }\n` +