@trolleroof/tui 0.2.3

package/overlay-release.json

@@ -0,0 +1,4 @@
+{
+  "tag": "overlay-v0.2.3",
+  "version": "0.2.3"
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@trolleroof/tui",
+  "version": "0.2.3",
+  "description": "Play familiar single-player games in a lightweight HTML overlay while your agents work.",
+  "type": "module",
+  "bin": {
+    "gamepigeon": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "overlay-release.json"
+  ],
+  "packageManager": "bun@1.3.11",
+  "scripts": {
+    "start": "bun src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target bun",
+    "build:overlay:web": "bun scripts/build-overlay-web.ts",
+    "build:overlay": "bun run build:overlay:web && cargo build --release --manifest-path tauri/Cargo.toml",
+    "claude:dev": "bash scripts/dev-harness.sh claude",
+    "codex:dev": "bash scripts/dev-harness.sh codex",
+    "antigravity:dev": "bash scripts/dev-harness.sh antigravity",
+    "dev:overlay": "bun run build:overlay:web && cargo build --manifest-path tauri/Cargo.toml && GAMEPIGEON_OVERLAY_BIN=\"$PWD/tauri/target/debug/gamepigeon-overlay\" bun scripts/overlay.ts --show",
+    "preview:overlay": "bun scripts/preview-overlay.ts",
+    "install:adapters": "bash scripts/install-adapters.sh",
+    "test": "bun test ./src/",
+    "test:adapters": "bun run build && bash scripts/install-adapters.test.sh && bash scripts/dev-harness.test.sh",
+    "test:overlay": "bun test scripts/overlay.test.ts scripts/plugin-update.test.ts scripts/version-bump.test.ts overlay/session.test.ts overlay/persistence.test.ts overlay/recording.test.ts overlay/renderers.test.ts overlay/motion.test.ts overlay/connect4-layout.test.ts overlay/analytics.test.ts overlay/tauri-bridge.test.ts",
+    "test:plugin-update": "bun test scripts/plugin-update.test.ts scripts/run-plugin-update.test.ts",
+    "test:launcher": "bun run test:overlay",
+    "typecheck": "tsc --noEmit && tsc -p overlay/tsconfig.json",
+    "export:bc": "bun scripts/export-bc.ts",
+    "version:bump": "bun scripts/version-bump.ts",
+    "prepack": "bun run build"
+  },
+  "engines": {
+    "bun": ">=1.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.5",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.10"
+  },
+  "dependencies": {
+    "@tauri-apps/api": "^2.11.1",
+    "posthog-node": "^5.44.0"
+  }
+}

package/scripts/build-overlay-web.ts

@@ -0,0 +1,34 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const root = join(import.meta.dir, "..");
+
+/** Worktrees and fresh clones often have no node_modules; overlay bundle needs @tauri-apps/api. */
+function ensureNodeModules(): void {
+  const tauriApi = join(root, "node_modules/@tauri-apps/api/package.json");
+  if (existsSync(tauriApi)) return;
+  console.error("node_modules missing — running bun install…");
+  const install = spawnSync("bun", ["install"], { cwd: root, stdio: "inherit" });
+  if (install.status !== 0) process.exit(install.status ?? 1);
+}
+
+ensureNodeModules();
+
+const pkg = JSON.parse(await Bun.file("package.json").text()) as { version?: string };
+
+const result = await Bun.build({
+  entrypoints: ["overlay/app.ts"],
+  outdir: "overlay/dist",
+  target: "browser",
+  minify: true,
+  define: {
+    __POSTHOG_CAPTURE_KEY__: JSON.stringify(process.env.POSTHOG_CAPTURE_KEY ?? ""),
+    __APP_VERSION__: JSON.stringify(pkg.version ?? "0.0.0"),
+  },
+});
+
+if (!result.success) {
+  for (const log of result.logs) console.error(log);
+  process.exit(1);
+}

package/scripts/dev-harness.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+HARNESS="${1:-}"
+
+usage() {
+  cat <<'EOF' >&2
+Usage: scripts/dev-harness.sh {claude|codex|antigravity|prepare}
+
+Shared local overlay development launcher:
+  prepare      Build overlay web bundle + debug Tauri shell and export dev env
+  claude       prepare + claude --plugin-dir .
+  codex        prepare + workspace plugin + Codex adapter + codex
+  antigravity  prepare + workspace plugin + agy
+EOF
+  exit 2
+}
+
+require_command() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "Missing required command: $1" >&2
+    exit 1
+  fi
+}
+
+prepare_overlay() {
+  require_command bun
+  require_command cargo
+  if [[ ! -f "$ROOT_DIR/node_modules/@tauri-apps/api/package.json" ]]; then
+    (cd "$ROOT_DIR" && bun install)
+  fi
+  (cd "$ROOT_DIR" && bun run build:overlay:web)
+  cargo build --manifest-path "$ROOT_DIR/tauri/Cargo.toml"
+  export GAMEPIGEON_OVERLAY_BIN="$ROOT_DIR/tauri/target/debug/gamepigeon-overlay"
+  export GAMEPIGEON_SKIP_UPDATE_CHECK=1
+  bun "$ROOT_DIR/scripts/overlay.ts" --quit
+}
+
+ensure_codex_plugin() {
+  bash "$ROOT_DIR/scripts/materialize-agents-plugin.sh"
+  bash "$ROOT_DIR/scripts/install-adapters.sh" --codex
+  require_command codex
+
+  if ! codex plugin marketplace list 2>/dev/null | grep -Fq "$ROOT_DIR"; then
+    codex plugin marketplace add "$ROOT_DIR" >/dev/null
+  fi
+
+  if ! codex plugin list 2>/dev/null | grep -Fq 'tui-gamepigeon@tui-gamepigeon-dev'; then
+    codex plugin add tui-gamepigeon@tui-gamepigeon-dev >/dev/null
+  fi
+}
+
+ensure_antigravity_plugin() {
+  bash "$ROOT_DIR/scripts/materialize-agents-plugin.sh"
+}
+
+case "$HARNESS" in
+  prepare)
+    prepare_overlay
+    ;;
+  claude)
+    prepare_overlay
+    require_command claude
+    exec claude --plugin-dir "$ROOT_DIR"
+    ;;
+  codex)
+    prepare_overlay
+    ensure_codex_plugin
+    exec codex
+    ;;
+  antigravity)
+    prepare_overlay
+    ensure_antigravity_plugin
+    require_command agy
+    exec agy
+    ;;
+  *)
+    usage
+    ;;
+esac

package/scripts/dev-harness.test.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TEMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TEMP_DIR"' EXIT
+
+WORKTREE="$TEMP_DIR/worktree"
+mkdir -p "$WORKTREE/.codex-plugin" "$WORKTREE/scripts"
+cp "$ROOT_DIR/.codex-plugin/plugin.json" "$WORKTREE/.codex-plugin/plugin.json"
+cp "$ROOT_DIR/scripts/materialize-agents-plugin.sh" "$WORKTREE/scripts/materialize-agents-plugin.sh"
+chmod +x "$WORKTREE/scripts/materialize-agents-plugin.sh"
+
+(
+  cd "$WORKTREE"
+  bash scripts/materialize-agents-plugin.sh
+)
+
+test -f "$WORKTREE/.agents/plugins/marketplace.json"
+test -f "$WORKTREE/.agents/plugins/tui-gamepigeon/plugin.json"
+test -f "$WORKTREE/.agents/plugins/tui-gamepigeon/hooks.json"
+test -f "$WORKTREE/.agents/plugins/tui-gamepigeon/skills/arcade/SKILL.md"
+
+grep -Fq "bun $WORKTREE/scripts/overlay.ts --enable" \
+  "$WORKTREE/.agents/plugins/tui-gamepigeon/skills/arcade/SKILL.md"
+grep -Fq "bun $WORKTREE/scripts/overlay.ts --reset" \
+  "$WORKTREE/.agents/plugins/tui-gamepigeon/hooks.json"
+grep -Fq '"name": "tui-gamepigeon-dev"' \
+  "$WORKTREE/.agents/plugins/marketplace.json"
+
+bash "$ROOT_DIR/scripts/dev-harness.sh" 2>/dev/null && exit 1 || true
+
+echo "dev-harness tests passed"

package/scripts/export-bc.ts

@@ -0,0 +1,124 @@
+import {
+  chmodSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import {
+  extractBehaviorCloningSamples,
+  splitForGame,
+  type BehaviorCloningSample,
+  type DatasetSplit,
+} from "../src/data/bc-export.js";
+import type { TraceEventChunk } from "../src/recording/types.js";
+
+interface CliOptions {
+  inputs: string[];
+  output: string;
+  includeNoops: boolean;
+}
+
+function usage(): never {
+  console.error(
+    "Usage: bun run export:bc -- [--input <file-or-directory>]... [--output <directory>] [--include-noops]",
+  );
+  process.exit(2);
+}
+
+function parseArgs(args: string[]): CliOptions {
+  const inputs: string[] = [];
+  let output = resolve("bc-dataset");
+  let includeNoops = false;
+  for (let index = 0; index < args.length; index++) {
+    const argument = args[index]!;
+    if (argument === "--input") {
+      const value = args[++index];
+      if (!value) usage();
+      inputs.push(resolve(value));
+    } else if (argument === "--output") {
+      const value = args[++index];
+      if (!value) usage();
+      output = resolve(value);
+    } else if (argument === "--include-noops") {
+      includeNoops = true;
+    } else {
+      usage();
+    }
+  }
+  if (inputs.length === 0) {
+    const recordings = resolve(homedir(), ".tui-gamepigeon", "recordings");
+    inputs.push(resolve(recordings, "completed", "chunks"));
+    inputs.push(resolve(recordings, "overlay-completed"));
+  }
+  return { inputs, output, includeNoops };
+}
+
+function jsonFiles(input: string): string[] {
+  let stats;
+  try {
+    stats = statSync(input);
+  } catch {
+    return [];
+  }
+  if (stats.isFile()) return input.endsWith(".json") ? [input] : [];
+  if (!stats.isDirectory()) return [];
+  return readdirSync(input, { withFileTypes: true })
+    .flatMap((entry) => jsonFiles(resolve(input, entry.name)))
+    .sort();
+}
+
+function loadChunks(inputs: readonly string[]): TraceEventChunk[] {
+  return inputs.flatMap(jsonFiles).flatMap((path) => {
+    try {
+      const value = JSON.parse(readFileSync(path, "utf8")) as TraceEventChunk;
+      return value.schema_version === 2 && Array.isArray(value.events) ? [value] : [];
+    } catch (error) {
+      throw new Error(`Could not parse ${path}: ${String(error)}`);
+    }
+  });
+}
+
+function writeDataset(
+  output: string,
+  samples: readonly BehaviorCloningSample[],
+  includeNoops: boolean,
+): void {
+  mkdirSync(output, { recursive: true, mode: 0o700 });
+  chmodSync(output, 0o700);
+  const splits: Record<DatasetSplit, BehaviorCloningSample[]> = {
+    train: [],
+    validation: [],
+    test: [],
+  };
+  for (const sample of samples) splits[splitForGame(sample.game_id)].push(sample);
+  for (const [name, rows] of Object.entries(splits)) {
+    const body = rows.map((row) => JSON.stringify(row)).join("\n");
+    writeFileSync(resolve(output, `${name}.jsonl`), body ? `${body}\n` : "", { mode: 0o600 });
+  }
+  const manifest = {
+    schema_version: 1,
+    format: "behavior_cloning_jsonl",
+    split_unit: "game_id",
+    noops_included: includeNoops,
+    samples: {
+      total: samples.length,
+      train: splits.train.length,
+      validation: splits.validation.length,
+      test: splits.test.length,
+    },
+    games: [...new Set(samples.map((sample) => sample.game_type))].sort(),
+  };
+  writeFileSync(resolve(output, "manifest.json"), `${JSON.stringify(manifest, null, 2)}\n`, {
+    mode: 0o600,
+  });
+}
+
+const options = parseArgs(process.argv.slice(2));
+const chunks = loadChunks(options.inputs);
+const samples = extractBehaviorCloningSamples(chunks, { includeNoops: options.includeNoops });
+writeDataset(options.output, samples, options.includeNoops);
+console.log(`Exported ${samples.length} BC samples from ${chunks.length} chunks to ${options.output}`);

package/scripts/install-adapters.sh

@@ -0,0 +1,192 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+CLAUDE_CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
+OPENCODE_CONFIG_DIR="${OPENCODE_CONFIG_DIR:-$HOME/.config/opencode}"
+HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
+OPENCLAW_HOME="${OPENCLAW_HOME:-$HOME/.openclaw}"
+MARKER="Generated by tui-gamepigeon scripts/install-adapters.sh"
+
+usage() {
+  cat <<'EOF'
+Usage: scripts/install-adapters.sh [--codex|--claude|--opencode|--hermes|--openclaw|--all]
+
+Install the Arcade command for Codex, Claude Code, OpenCode, Hermes, OpenClaw, or all of them (the default).
+EOF
+}
+
+install_codex=false
+install_claude=false
+install_opencode=false
+install_hermes=false
+install_openclaw=false
+
+case "${1:---all}" in
+  --all)
+    install_codex=true
+    install_claude=true
+    install_opencode=true
+    install_hermes=true
+    install_openclaw=true
+    ;;
+  --codex)
+    install_codex=true
+    ;;
+  --claude)
+    install_claude=true
+    ;;
+  --opencode)
+    install_opencode=true
+    ;;
+  --hermes)
+    install_hermes=true
+    ;;
+  --openclaw)
+    install_openclaw=true
+    ;;
+  -h|--help)
+    usage
+    exit 0
+    ;;
+  *)
+    usage >&2
+    exit 2
+    ;;
+esac
+
+if [[ $# -gt 1 ]]; then
+  usage >&2
+  exit 2
+fi
+
+skill_targets=()
+if [[ "$install_codex" == true ]]; then
+  skill_targets+=("$CODEX_HOME/skills/arcade")
+fi
+if [[ "$install_claude" == true ]]; then
+  skill_targets+=("$CLAUDE_CONFIG_DIR/skills/arcade")
+fi
+if [[ "$install_hermes" == true ]]; then
+  skill_targets+=("$HERMES_HOME/skills/arcade")
+fi
+if [[ "$install_openclaw" == true ]]; then
+  skill_targets+=("$OPENCLAW_HOME/skills/arcade")
+fi
+
+opencode_command="$OPENCODE_CONFIG_DIR/commands/arcade.md"
+files_to_check=()
+if [[ "$install_codex" == true || "$install_claude" == true ]]; then
+  for target in "${skill_targets[@]}"; do
+    files_to_check+=("$target/SKILL.md")
+  done
+fi
+if [[ "$install_opencode" == true ]]; then
+  files_to_check+=("$opencode_command")
+fi
+
+for generated_file in "${files_to_check[@]}"; do
+  if [[ -f "$generated_file" ]] && ! grep -Fq "$MARKER" "$generated_file"; then
+    echo "Refusing to replace an existing adapter: $generated_file" >&2
+    exit 1
+  fi
+done
+
+printf -v launcher_command 'bun %q --enable' "$ROOT_DIR/scripts/overlay.ts"
+
+if [[ "$install_codex" == true || "$install_claude" == true ]]; then
+  for target in "${skill_targets[@]}"; do
+    mkdir -p "$target"
+    cat > "$target/SKILL.md" <<EOF
+---
+name: arcade
+description: Open or restore the native GamePigeon HTML overlay while the coding harness works.
+---
+
+# Arcade
+
+<!-- $MARKER -->
+
+Execute this command exactly once:
+
+\`$launcher_command\`
+
+Do not inspect the user's repository. Do not spawn another agent or task. Do not run any other command.
+
+GamePigeon opens as a borderless HTML overlay without a Dock or taskbar entry. Running Arcade again focuses the existing overlay.
+
+On success, respond only with \`Arcade opened.\`. On failure, relay the launcher's error without attempting another launch method.
+EOF
+    echo "Installed Arcade skill at $target"
+  done
+fi
+
+if [[ "$install_opencode" == true ]]; then
+  mkdir -p "$(dirname "$opencode_command")"
+  cat > "$opencode_command" <<EOF
+---
+description: Open or restore the GamePigeon Arcade overlay
+---
+
+<!-- $MARKER -->
+
+!\`$launcher_command\`
+
+The command opens GamePigeon as a borderless HTML overlay without a Dock or taskbar entry. Running \`/arcade\` again focuses the existing overlay.
+
+Respond only with \`Arcade opened.\` when the launcher succeeds. If its output reports an error, relay that error without attempting another launch method.
+EOF
+  echo "Installed Arcade command at $opencode_command"
+fi
+
+if [[ "$install_hermes" == true ]]; then
+  if [[ -f "$HERMES_HOME/config.yaml" ]]; then
+    if [[ -f "$HERMES_HOME/hermes-agent/venv/bin/python" ]]; then
+      "$HERMES_HOME/hermes-agent/venv/bin/python" "$ROOT_DIR/scripts/manage-hermes-hooks.py" "$ROOT_DIR"
+    else
+      python3 "$ROOT_DIR/scripts/manage-hermes-hooks.py" "$ROOT_DIR" || python "$ROOT_DIR/scripts/manage-hermes-hooks.py" "$ROOT_DIR"
+    fi
+  fi
+fi
+
+if [[ "$install_openclaw" == true ]]; then
+  mkdir -p "$OPENCLAW_HOME/hooks/arcade"
+  cat > "$OPENCLAW_HOME/hooks/arcade/HOOK.md" <<EOF
+---
+name: arcade
+description: "Open or restore the GamePigeon Arcade overlay"
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎮",
+        "events": ["command:new", "command:reset"],
+        "install": [{ "id": "arcade", "kind": "local", "label": "Local Arcade" }],
+      },
+  }
+---
+# Arcade Hook
+This hook manages the GamePigeon Arcade overlay lifecycle.
+EOF
+
+  cat > "$OPENCLAW_HOME/hooks/arcade/handler.js" <<EOF
+import { exec } from "node:child_process";
+
+export default async function handle(event) {
+  const root = "$ROOT_DIR";
+  let action = "";
+  if (event.action === "new" || event.action === "reset") {
+    action = "--reset && bun " + root + "/scripts/overlay.ts --show";
+  }
+  if (action) {
+    exec("bun " + root + "/scripts/overlay.ts " + action);
+  }
+}
+EOF
+
+  if command -v openclaw &> /dev/null; then
+    openclaw hooks enable arcade || true
+  fi
+  echo "Installed and enabled OpenClaw hook at $OPENCLAW_HOME/hooks/arcade"
+fi

package/scripts/install-adapters.test.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TEMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TEMP_DIR"' EXIT
+
+CODEX_HOME="$TEMP_DIR/codex" \
+CLAUDE_CONFIG_DIR="$TEMP_DIR/claude" \
+OPENCODE_CONFIG_DIR="$TEMP_DIR/opencode" \
+HERMES_HOME="$TEMP_DIR/hermes" \
+OPENCLAW_HOME="$TEMP_DIR/openclaw" \
+  bash "$ROOT_DIR/scripts/install-adapters.sh"
+
+for skill_file in \
+  "$TEMP_DIR/codex/skills/arcade/SKILL.md" \
+  "$TEMP_DIR/claude/skills/arcade/SKILL.md" \
+  "$TEMP_DIR/hermes/skills/arcade/SKILL.md" \
+  "$TEMP_DIR/openclaw/skills/arcade/SKILL.md"; do
+  test -f "$skill_file"
+  grep -q '^name: arcade$' "$skill_file"
+  grep -Fq "bun $ROOT_DIR/scripts/overlay.ts --enable" "$skill_file"
+  grep -Fq 'Do not spawn another agent or task.' "$skill_file"
+  grep -Fq 'GamePigeon opens as a borderless HTML overlay' "$skill_file"
+done
+
+test -f "$TEMP_DIR/openclaw/hooks/arcade/HOOK.md"
+test -f "$TEMP_DIR/openclaw/hooks/arcade/handler.js"
+
+opencode_command="$TEMP_DIR/opencode/commands/arcade.md"
+test -f "$opencode_command"
+grep -q '^description: Open or restore the GamePigeon Arcade overlay$' "$opencode_command"
+grep -Fq "!\`bun $ROOT_DIR/scripts/overlay.ts --enable\`" "$opencode_command"
+grep -Fq 'Running `/arcade` again focuses the existing overlay.' "$opencode_command"
+
+CODEX_ONLY="$TEMP_DIR/codex-only"
+CLAUDE_UNUSED="$TEMP_DIR/claude-unused"
+OPENCODE_UNUSED="$TEMP_DIR/opencode-unused"
+CODEX_HOME="$CODEX_ONLY" \
+CLAUDE_CONFIG_DIR="$CLAUDE_UNUSED" \
+OPENCODE_CONFIG_DIR="$OPENCODE_UNUSED" \
+  bash "$ROOT_DIR/scripts/install-adapters.sh" --codex
+
+test -f "$CODEX_ONLY/skills/arcade/SKILL.md"
+test ! -e "$CLAUDE_UNUSED"
+test ! -e "$OPENCODE_UNUSED"
+
+CLI_CODEX_HOME="$TEMP_DIR/cli-codex"
+CODEX_HOME="$CLI_CODEX_HOME" \
+CLAUDE_CONFIG_DIR="$TEMP_DIR/cli-claude" \
+OPENCODE_CONFIG_DIR="$TEMP_DIR/cli-opencode" \
+HERMES_HOME="$TEMP_DIR/cli-hermes" \
+OPENCLAW_HOME="$TEMP_DIR/cli-openclaw" \
+  bun "$ROOT_DIR/dist/index.js" install --codex
+test -f "$CLI_CODEX_HOME/skills/arcade/SKILL.md"
+
+OPENCODE_ONLY="$TEMP_DIR/opencode-only"
+CODEX_UNUSED="$TEMP_DIR/codex-unused"
+CLAUDE_UNUSED_2="$TEMP_DIR/claude-unused-2"
+CODEX_HOME="$CODEX_UNUSED" \
+CLAUDE_CONFIG_DIR="$CLAUDE_UNUSED_2" \
+OPENCODE_CONFIG_DIR="$OPENCODE_ONLY" \
+  bash "$ROOT_DIR/scripts/install-adapters.sh" --opencode
+
+test -f "$OPENCODE_ONLY/commands/arcade.md"
+test ! -e "$CODEX_UNUSED"
+test ! -e "$CLAUDE_UNUSED_2"
+
+echo "adapter installer tests passed"

package/scripts/manage-hermes-hooks.py

@@ -0,0 +1,39 @@
+import yaml
+import sys
+import os
+
+config_path = os.path.expanduser('~/.hermes/config.yaml')
+if not os.path.exists(config_path):
+    print("Hermes config.yaml not found.")
+    sys.exit(0)
+
+with open(config_path, 'r') as f:
+    config = yaml.safe_load(f) or {}
+
+# Define our hooks under the proper event-name keys mapping to arrays of command objects
+root_dir = sys.argv[1]
+root_dir = sys.argv[1]
+new_hooks = {
+    'on_session_start': [
+        {'command': f"bun {root_dir}/scripts/overlay.ts --reset"},
+        {'command': f"bun {root_dir}/scripts/overlay.ts --show"}
+    ],
+    'post_tool_call': [
+        {'command': f"bun {root_dir}/scripts/overlay.ts --pause"}
+    ],
+    'on_session_end': [
+        {'command': f"bun {root_dir}/scripts/overlay.ts --quit"}
+    ]
+}
+existing_hooks = config.get('hooks', {})
+for event, cmds in new_hooks.items():
+    existing = existing_hooks.get(event, [])
+    existing_cmds = {c['command'] for c in existing}
+    existing_hooks[event] = existing + [c for c in cmds if c['command'] not in existing_cmds]
+config['hooks'] = existing_hooks
+config['hooks_auto_accept'] = True
+
+with open(config_path, 'w') as f:
+    yaml.safe_dump(config, f, default_flow_style=False)
+
+print("Hermes hooks updated successfully.")