diff --git a/adapters/gemini-cli/adapter.sh b/adapters/gemini-cli/adapter.sh
new file mode 100755
index 0000000..fa1a98e
--- /dev/null
+++ b/adapters/gemini-cli/adapter.sh
@@ -0,0 +1,313 @@
+#!/usr/bin/env bash
+# =============================================================================
+# adapters/gemini-cli/adapter.sh — Gemini CLI framework adapter
+# =============================================================================
+# Sourced by scripts/build.sh AFTER adapters/lib.sh.
+# Translates source files into a dist/gemini-cli/ tree that mirrors what
+# Gemini CLI expects in the user's project.
+# =============================================================================
+
+GEMINI_PLATFORM="gemini-cli"
+GEMINI_FW_DIR=".gemini"
+GEMINI_DISPATCHER="GEMINI.md"
+
+# Capability → Gemini CLI tool names. Returns space-separated tool names.
+gemini_capability_to_tools() {
+  local cap="$1"
+  case "$cap" in
+    read)      echo "read_file list_directory grep_search" ;;
+    write)     echo "write_file" ;;
+    edit)      echo "replace" ;;
+    bash)      echo "run_shell_command" ;;
+    webfetch)  echo "web_fetch" ;;
+    websearch) echo "web_search" ;;
+    notebook)  echo "" ;;
+    task)      echo "activate_skill" ;;
+    todo)      echo "" ;;
+    *)         echo "" ;;
+  esac
+}
+
+# Event vocabulary → Gemini CLI native event name.
+gemini_event_to_native() {
+  local event="$1"
+  case "$event" in
+    before-tool-use)  echo "BeforeTool" ;;
+    after-tool-use)   echo "AfterTool" ;;
+    on-notification)  echo "Notification" ;;
+    on-session-start) echo "SessionStart" ;;
+    on-prompt-submit) echo "BeforeAgent" ;;
+    *)                echo "" ;;
+  esac
+}
+
+# Neutral model tier → Gemini model name.
+gemini_model_to_native() {
+  local model="$1"
+  case "$model" in
+    */*)   echo "$model" ;;
+    low)   echo "gemini-2.5-flash" ;;
+    mid)   echo "gemini-2.5-flash" ;;
+    high)  echo "gemini-2.5-pro" ;;
+    *)     echo "$model" ;;
+  esac
+}
+
+# Match-tool token → Gemini tool name for hook matchers.
+gemini_match_tool_to_native() {
+  local token="$1"
+  case "$token" in
+    read)   echo "read_file" ;;
+    write)  echo "write_file" ;;
+    edit)   echo "replace" ;;
+    bash)   echo "run_shell_command" ;;
+    *)      echo "$token" ;;
+  esac
+}
+
+# adapter_translate_dispatcher <source_dispatcher_md> <dest_dir>
+# Copies the source DISPATCHER.md to dest_dir/GEMINI.md (no content change).
+adapter_translate_dispatcher() {
+  local src="$1" dst="$2"
+  [[ -f "$src" ]] || return 0
+  mkdir -p "$dst"
+  cp "$src" "$dst/$GEMINI_DISPATCHER"
+}
+
+# adapter_translate_references <source_refs_dir> <dest_root>
+adapter_translate_references() {
+  local src="$1" dst="$2"
+  [[ -d "$src" ]] || return 0
+  local out="$dst/$GEMINI_FW_DIR/references"
+  mkdir -p "$out"
+  for f in "$src"/*.md; do
+    [[ -f "$f" ]] || continue
+    should_include "$f" "$GEMINI_PLATFORM" || continue
+    cp "$f" "$out/"
+  done
+}
+
+# adapter_translate_skills <source_skills_dir> <dest_root>
+adapter_translate_skills() {
+  local src="$1" dst="$2"
+  [[ -d "$src" ]] || return 0
+  for skill_dir in "$src"/*/; do
+    [[ -f "${skill_dir}SKILL.md" ]] || continue
+    should_include "${skill_dir}SKILL.md" "$GEMINI_PLATFORM" || continue
+    local name; name="$(basename "$skill_dir")"
+    local out="$dst/$GEMINI_FW_DIR/skills/$name"
+    mkdir -p "$out"
+    cp "${skill_dir}SKILL.md" "$out/SKILL.md"
+  done
+}
+
+# adapter_translate_agents <source_agents_dir> <dest_root>
+adapter_translate_agents() {
+  local src="$1" dst="$2"
+  [[ -d "$src" ]] || return 0
+  local out_dir="$dst/$GEMINI_FW_DIR/agents"
+  mkdir -p "$out_dir"
+
+  while IFS= read -r agent; do
+    [[ -f "$agent" ]] || continue
+    should_include "$agent" "$GEMINI_PLATFORM" || continue
+
+    local name; name="$(parse_frontmatter "$agent" name)"
+    local model_raw; model_raw="$(parse_frontmatter "$agent" model)"
+    local caps; caps="$(parse_capabilities "$agent")"
+
+    local model_out; model_out="$(gemini_model_to_native "$model_raw")"
+
+    # Build deduplicated tools list
+    local tools_seen="" tools_yaml=""
+    for cap in $caps; do
+      local expansion; expansion="$(gemini_capability_to_tools "$cap")"
+      for tool in $expansion; do
+        [[ -z "$tool" ]] && continue
+        case " $tools_seen " in
+          *" $tool "*) ;;
+          *)
+            tools_seen="$tools_seen $tool"
+            tools_yaml="${tools_yaml}  - ${tool}
+"
+            ;;
+        esac
+      done
+    done
+
+    local out_file="$out_dir/$(basename "$agent")"
+    {
+      echo "---"
+      echo "name: $name"
+      # Copy description block (may be folded YAML)
+      awk '/^---$/{n++; next} n==1 && /^description:/{print; in_desc=1; next} n==1 && in_desc && /^[[:space:]]/{print; next} n==1 && in_desc && !/^[[:space:]]/{in_desc=0} n>=2{exit}' "$agent"
+      echo "tools:"
+      printf '%s' "$tools_yaml"
+      echo "model: $model_out"
+      echo "---"
+      agent_body "$agent"
+    } > "$out_file"
+  done < <(enumerate_agents "$src")
+}
+
+# adapter_translate_hooks <source_hooks_dir> <dest_root>
+adapter_translate_hooks() {
+  local src="$1" dst="$2"
+  [[ -d "$src" ]] || return 0
+
+  local hooks_out="$dst/$GEMINI_FW_DIR/hooks"
+  mkdir -p "$hooks_out"
+
+  local tpl_dir; tpl_dir="$(dirname "${BASH_SOURCE[0]}")/templates"
+  local hooks_json='{}'
+  local have_any=0
+
+  while IFS= read -r yaml; do
+    [[ -f "$yaml" ]] || continue
+    should_include "$yaml" "$GEMINI_PLATFORM" || continue
+
+    local meta; meta="$(parse_hook_yaml "$yaml")"
+    local hook_name; hook_name="$(echo "$meta" | grep '^name=' | head -1 | cut -d= -f2-)"
+    local script; script="$(echo "$meta" | grep '^script=' | head -1 | cut -d= -f2-)"
+    local event; event="$(echo "$meta" | grep '^event=' | head -1 | cut -d= -f2-)"
+    local match_tool; match_tool="$(echo "$meta" | grep '^match-tool=' | head -1 | cut -d= -f2- || true)"
+
+    [[ -f "$src/$script" ]] || continue
+
+    # Copy the hook script
+    cp "$src/$script" "$hooks_out/$script"
+    chmod +x "$hooks_out/$script"
+
+    # Generate wrapper script from template
+    local wrapper_name="${hook_name}-wrapper.sh"
+    sed -e "s/__HOOK_NAME__/$hook_name/g" -e "s/__EVENT_NAME__/$event/g" \
+      "$tpl_dir/gemini-hook-wrapper.sh.tmpl" > "$hooks_out/$wrapper_name"
+    chmod +x "$hooks_out/$wrapper_name"
+
+    # Build matcher: map each match-tool token to Gemini tool name
+    local gemini_event; gemini_event="$(gemini_event_to_native "$event")"
+    local matcher=""
+    if [[ -n "$match_tool" ]]; then
+      for t in $match_tool; do
+        local native; native="$(gemini_match_tool_to_native "$t")"
+        if [[ -z "$matcher" ]]; then
+          matcher="$native"
+        else
+          matcher="$matcher|$native"
+        fi
+      done
+    fi
+
+    # Add to hooks JSON
+    local hook_cmd="bash $GEMINI_FW_DIR/hooks/$wrapper_name"
+    if [[ -n "$matcher" ]]; then
+      hooks_json="$(echo "$hooks_json" | jq \
+        --arg ev "$gemini_event" \
+        --arg matcher "$matcher" \
+        --arg cmd "$hook_cmd" \
+        '.hooks[$ev] += [{ matcher: $matcher, hooks: [{ type: "command", command: $cmd, timeout: 5000 }] }]')"
+    else
+      hooks_json="$(echo "$hooks_json" | jq \
+        --arg ev "$gemini_event" \
+        --arg cmd "$hook_cmd" \
+        '.hooks[$ev] += [{ hooks: [{ type: "command", command: $cmd, timeout: 5000 }] }]')"
+    fi
+    have_any=1
+  done < <(enumerate_hooks "$src")
+
+  if [[ $have_any -eq 0 ]]; then
+    rmdir "$hooks_out" 2>/dev/null || true
+    return 0
+  fi
+
+  echo "$hooks_json" | jq '.' > "$dst/$GEMINI_FW_DIR/_hooks.json"
+}
+
+# adapter_translate_mcp <source_mcp_dir> <dest_root>
+adapter_translate_mcp() {
+  local src="$1" dst="$2"
+  local yaml="$src/servers.yaml"
+  [[ -f "$yaml" ]] || return 0
+
+  mkdir -p "$dst/$GEMINI_FW_DIR"
+
+  local json='{}'
+  local current_name="" current_cmd="" current_url="" current_type=""
+
+  _gemini_flush_mcp() {
+    [[ -z "$current_name" ]] && return 0
+    if [[ "$current_type" == "local" || -n "$current_cmd" ]]; then
+      local cmd_first; cmd_first="$(echo "$current_cmd" | awk '{print $1}')"
+      local cmd_rest; cmd_rest="$(echo "$current_cmd" | awk '{$1=""; print}' | sed 's/^ *//')"
+      local args_json; args_json="$(echo "$cmd_rest" | jq -R 'split(" ") | map(select(length > 0))')"
+      json="$(echo "$json" | jq --arg n "$current_name" --arg c "$cmd_first" --argjson a "$args_json" \
+        '.mcpServers[$n] = {command: $c, args: $a}')"
+    else
+      json="$(echo "$json" | jq --arg n "$current_name" --arg u "$current_url" \
+        '.mcpServers[$n] = {url: $u}')"
+    fi
+  }
+
+  while IFS= read -r line; do
+    case "$line" in
+      *"- name:"*)
+        _gemini_flush_mcp
+        current_name="$(echo "$line" | sed 's/.*- name:[[:space:]]*//' | tr -d '"')"
+        current_cmd="" ; current_url="" ; current_type=""
+        ;;
+      *"type:"*)
+        current_type="$(echo "$line" | sed 's/.*type:[[:space:]]*//' | tr -d '"')"
+        ;;
+      *"command:"*"["*)
+        current_cmd="$(echo "$line" | sed 's/.*command:[[:space:]]*\[//' | sed 's/\][[:space:]]*$//' | tr -d '"' | sed 's/,[[:space:]]*/  /g')"
+        ;;
+      *"url:"*)
+        current_url="$(echo "$line" | sed 's/.*url:[[:space:]]*//' | tr -d '"')"
+        ;;
+    esac
+  done < "$yaml"
+  _gemini_flush_mcp
+
+  echo "$json" | jq '.' > "$dst/$GEMINI_FW_DIR/_mcp.json"
+  unset -f _gemini_flush_mcp
+}
+
+# adapter_finalize <source_root> <dest_root>
+adapter_finalize() {
+  local src="$1" dst="$2"
+  local gemini_dir="$dst/$GEMINI_FW_DIR"
+  local hooks_tmp="$gemini_dir/_hooks.json"
+  local mcp_tmp="$gemini_dir/_mcp.json"
+  local settings="$gemini_dir/settings.json"
+
+  local result='{}'
+
+  if [[ -f "$hooks_tmp" ]]; then
+    result="$(echo "$result" | jq --slurpfile h "$hooks_tmp" '. + $h[0]')"
+    rm "$hooks_tmp"
+  fi
+
+  if [[ -f "$mcp_tmp" ]]; then
+    result="$(echo "$result" | jq --slurpfile m "$mcp_tmp" '. + $m[0]')"
+    rm "$mcp_tmp"
+  fi
+
+  if [[ "$result" != "{}" ]]; then
+    echo "$result" | jq '.' > "$settings"
+  fi
+}
+
+# adapter_build <source_dir> <dest_dir>
+# The single entry point invoked by scripts/build.sh.
+adapter_build() {
+  local src="$1" dst="$2"
+  rm -rf "$dst"
+  mkdir -p "$dst"
+  adapter_translate_dispatcher "$src/DISPATCHER.md" "$dst"
+  adapter_translate_references "$src/references"  "$dst"
+  adapter_translate_skills     "$src/skills"      "$dst"
+  adapter_translate_agents     "$src/agents"      "$dst"
+  adapter_translate_hooks      "$src/hooks"       "$dst"
+  adapter_translate_mcp        "$src/mcp"         "$dst"
+  adapter_finalize             "$src"             "$dst"
+}
diff --git a/adapters/gemini-cli/templates/gemini-hook-wrapper.sh.tmpl b/adapters/gemini-cli/templates/gemini-hook-wrapper.sh.tmpl
new file mode 100755
index 0000000..163575b
--- /dev/null
+++ b/adapters/gemini-cli/templates/gemini-hook-wrapper.sh.tmpl
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Generated by adapters/gemini-cli/adapter.sh — do not edit.
+# Wrapper for hook: __HOOK_NAME__
+# Reads Gemini CLI native JSON from stdin, translates it into the neutral
+# schema, and pipes the result to __HOOK_NAME__.sh.
+# =============================================================================
+set -eo pipefail
+
+INPUT=$(cat)
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+NEUTRAL=$(echo "$INPUT" | jq -c '{
+  event: "__EVENT_NAME__",
+  tool: (.tool_name // ""),
+  args: (.tool_input // {}),
+  session_id: (env.GEMINI_SESSION_ID // ""),
+  cwd: (env.GEMINI_CWD // env.GEMINI_PROJECT_DIR // ""),
+  framework: "gemini-cli"
+}')
+
+echo "$NEUTRAL" | bash "$HOOK_DIR/__HOOK_NAME__.sh"
diff --git a/scripts/launchme.sh b/scripts/launchme.sh
index f292e31..279bf63 100755
--- a/scripts/launchme.sh
+++ b/scripts/launchme.sh
@@ -114,6 +114,15 @@ case "$PLATFORM" in
     MCP_DST="$VAULT_DIR/opencode.json"
     HAS_PLUGINS=1
     ;;
+  gemini-cli)
+    DIST_COMPONENTS_DIR="$DIST_DIR/.gemini"
+    VAULT_COMPONENTS_DIR="$VAULT_DIR/.gemini"
+    DISPATCHER_SRC="$DIST_DIR/GEMINI.md"
+    DISPATCHER_DST="$VAULT_DIR/GEMINI.md"
+    MCP_SRC=""
+    MCP_DST=""
+    HAS_PLUGINS=0
+    ;;
   *)
     die "Unknown platform: $PLATFORM (install layout not defined)"
     ;;
diff --git a/scripts/updateme.sh b/scripts/updateme.sh
index 02f0113..51c51f8 100755
--- a/scripts/updateme.sh
+++ b/scripts/updateme.sh
@@ -40,6 +40,7 @@ print_banner "Update       "
 case "$PLATFORM" in
   claude-code) _SETUP_CHECK="$VAULT_DIR/.claude/agents" ;;
   opencode)    _SETUP_CHECK="$VAULT_DIR/.opencode/agents" ;;
+  gemini-cli)  _SETUP_CHECK="$VAULT_DIR/.gemini/agents" ;;
   *)           _SETUP_CHECK="$VAULT_DIR/.claude/agents" ;;
 esac
 [[ -d "$_SETUP_CHECK" ]] \
@@ -47,8 +48,9 @@ esac
 
 # ── Confirm ───────────────────────────────────────────────────────────────────
 case "$PLATFORM" in
-  opencode) _DISP_NAME="AGENTS.md"; _FW_DIR_NAME="opencode" ;;
-  *)        _DISP_NAME="CLAUDE.md"; _FW_DIR_NAME="claude" ;;
+  opencode)    _DISP_NAME="AGENTS.md"; _FW_DIR_NAME="opencode" ;;
+  gemini-cli)  _DISP_NAME="GEMINI.md"; _FW_DIR_NAME="gemini" ;;
+  *)           _DISP_NAME="CLAUDE.md"; _FW_DIR_NAME="claude" ;;
 esac
 echo -e "${BOLD}This will update core agents, skills, references, hooks, and ${_DISP_NAME}.${NC}"
 echo -e "   ${DIM}Custom agents in .${_FW_DIR_NAME}/agents/ are never overwritten or deleted.${NC}"
@@ -89,6 +91,15 @@ case "$PLATFORM" in
     MCP_DST="$VAULT_DIR/opencode.json"
     HAS_PLUGINS=1
     ;;
+  gemini-cli)
+    DIST_COMPONENTS_DIR="$DIST_DIR/.gemini"
+    VAULT_COMPONENTS_DIR="$VAULT_DIR/.gemini"
+    DISPATCHER_SRC="$DIST_DIR/GEMINI.md"
+    DISPATCHER_DST="$VAULT_DIR/GEMINI.md"
+    MCP_SRC=""
+    MCP_DST=""
+    HAS_PLUGINS=0
+    ;;
   *)
     die "Unknown platform: $PLATFORM (install layout not defined)"
     ;;
diff --git a/tests/adapters/gemini-cli/adapter.test.sh b/tests/adapters/gemini-cli/adapter.test.sh
new file mode 100755
index 0000000..e16c2cf
--- /dev/null
+++ b/tests/adapters/gemini-cli/adapter.test.sh
@@ -0,0 +1,305 @@
+#!/usr/bin/env bash
+# Tests for adapters/gemini-cli/adapter.sh
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+source "$ROOT/adapters/lib.sh"
+source "$ROOT/adapters/gemini-cli/adapter.sh"
+
+test_gemini_translate_dispatcher_renames_to_gemini_md() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  echo "# Dispatcher content" > "$src/DISPATCHER.md"
+  adapter_translate_dispatcher "$src/DISPATCHER.md" "$dst"
+  local result=0
+  [[ -f "$dst/GEMINI.md" ]] || { echo "GEMINI.md not created"; result=1; }
+  [[ ! -f "$dst/CLAUDE.md" ]] || { echo "CLAUDE.md should not exist"; result=1; }
+  [[ ! -f "$dst/AGENTS.md" ]] || { echo "AGENTS.md should not exist"; result=1; }
+  [[ "$(cat "$dst/GEMINI.md")" == "$(cat "$src/DISPATCHER.md")" ]] || { echo "content mismatch"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_references_copies_md_files() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/references"
+  echo "ref1" > "$src/references/one.md"
+  echo "ref2" > "$src/references/two.md"
+  adapter_translate_references "$src/references" "$dst"
+  local result=0
+  [[ -f "$dst/.gemini/references/one.md" ]] || { echo "one.md missing"; result=1; }
+  [[ -f "$dst/.gemini/references/two.md" ]] || { echo "two.md missing"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_skills_copies_skill_md() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/skills/foo" "$src/skills/bar"
+  cat > "$src/skills/foo/SKILL.md" <<'HEREDOC'
+---
+name: foo
+description: Foo skill
+---
+body
+HEREDOC
+  cat > "$src/skills/bar/SKILL.md" <<'HEREDOC'
+---
+name: bar
+description: Bar skill
+---
+body
+HEREDOC
+  adapter_translate_skills "$src/skills" "$dst"
+  local result=0
+  [[ -f "$dst/.gemini/skills/foo/SKILL.md" ]] || { echo "foo missing"; result=1; }
+  [[ -f "$dst/.gemini/skills/bar/SKILL.md" ]] || { echo "bar missing"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_skills_honors_exclude() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/skills/foo"
+  cat > "$src/skills/foo/SKILL.md" <<'HEREDOC'
+---
+name: foo
+description: Foo
+exclude: [gemini-cli]
+---
+HEREDOC
+  adapter_translate_skills "$src/skills" "$dst"
+  local result=0
+  [[ ! -f "$dst/.gemini/skills/foo/SKILL.md" ]] || { echo "foo should be excluded"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_agents_basic() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/agents"
+  cat > "$src/agents/scribe.md" <<'HEREDOC'
+---
+name: scribe
+description: Test scribe
+model: mid
+capabilities: [read, write, edit]
+---
+
+You are the Scribe.
+HEREDOC
+  adapter_translate_agents "$src/agents" "$dst"
+  local out="$dst/.gemini/agents/scribe.md"
+  local result=0
+  [[ -f "$out" ]] || { echo "agent file missing"; result=1; }
+  grep -q '^name: scribe' "$out" || { echo "name missing"; result=1; }
+  grep -q '^model: gemini-2.5-flash' "$out" || { echo "model not mapped"; cat "$out"; result=1; }
+  grep -q '^ *- read_file' "$out" || { echo "read_file tool missing"; cat "$out"; result=1; }
+  grep -q '^ *- write_file' "$out" || { echo "write_file tool missing"; result=1; }
+  grep -q '^ *- replace' "$out" || { echo "replace tool missing"; result=1; }
+  grep -q '^ *- grep_search' "$out" || { echo "grep_search tool missing"; result=1; }
+  grep -q '^You are the Scribe' "$out" || { echo "body missing"; result=1; }
+  grep -q '^capabilities:' "$out" && { echo "capabilities should be dropped"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_agents_bash_capability() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/agents"
+  cat > "$src/agents/architect.md" <<'HEREDOC'
+---
+name: architect
+description: Test arch
+model: high
+capabilities: [read, write, edit, bash]
+---
+
+body
+HEREDOC
+  adapter_translate_agents "$src/agents" "$dst"
+  local out="$dst/.gemini/agents/architect.md"
+  local result=0
+  grep -q '^ *- run_shell_command' "$out" || { echo "run_shell_command missing"; result=1; }
+  grep -q '^model: gemini-2.5-pro' "$out" || { echo "model not mapped to pro"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_agents_dedupes_tools() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/agents"
+  cat > "$src/agents/seeker.md" <<'HEREDOC'
+---
+name: seeker
+description: Search
+model: mid
+capabilities: [read]
+---
+
+body
+HEREDOC
+  adapter_translate_agents "$src/agents" "$dst"
+  local out="$dst/.gemini/agents/seeker.md"
+  local count; count="$(grep -c '^ *- read_file' "$out")"
+  rm -rf "$src" "$dst"
+  [[ "$count" == "1" ]] || { echo "expected 1 read_file, got $count"; return 1; }
+}
+
+test_gemini_translate_hooks_creates_files() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/hooks"
+  cat > "$src/hooks/protect.hook.yaml" <<'HEREDOC'
+name: protect
+script: protect.sh
+triggers:
+  - event: before-tool-use
+    match-tool: [edit, write]
+HEREDOC
+  echo '#!/usr/bin/env bash' > "$src/hooks/protect.sh"
+  adapter_translate_hooks "$src/hooks" "$dst"
+  local result=0
+  [[ -f "$dst/.gemini/hooks/protect.sh" ]] || { echo "protect.sh not copied"; result=1; }
+  [[ -f "$dst/.gemini/hooks/protect-wrapper.sh" ]] || { echo "wrapper not created"; result=1; }
+  [[ -f "$dst/.gemini/_hooks.json" ]] || { echo "_hooks.json not created"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_hooks_json_has_entries() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/hooks"
+  cat > "$src/hooks/protect.hook.yaml" <<'HEREDOC'
+name: protect
+script: protect.sh
+triggers:
+  - event: before-tool-use
+    match-tool: [edit, write]
+HEREDOC
+  echo '#!/usr/bin/env bash' > "$src/hooks/protect.sh"
+  adapter_translate_hooks "$src/hooks" "$dst"
+  local json="$dst/.gemini/_hooks.json"
+  local result=0
+  jq -e '.hooks.BeforeTool' "$json" >/dev/null || { echo "BeforeTool event missing"; result=1; }
+  jq -e '.hooks.BeforeTool[0].matcher' "$json" >/dev/null || { echo "matcher missing"; result=1; }
+  local matcher; matcher="$(jq -r '.hooks.BeforeTool[0].matcher' "$json")"
+  [[ "$matcher" == *"replace"* ]] || { echo "replace not in matcher: $matcher"; result=1; }
+  [[ "$matcher" == *"write_file"* ]] || { echo "write_file not in matcher: $matcher"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_hooks_no_hooks_is_noop() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  adapter_translate_hooks "$src/hooks" "$dst"
+  local result=0
+  [[ ! -f "$dst/.gemini/_hooks.json" ]] || { echo "should not create hooks json when no hooks dir"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_mcp_remote() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/mcp" "$dst/.gemini"
+  cat > "$src/mcp/servers.yaml" <<'HEREDOC'
+servers:
+  - name: Gmail
+    type: http
+    url: "https://gmail.mcp.claude.com/mcp"
+    env: {}
+HEREDOC
+  adapter_translate_mcp "$src/mcp" "$dst"
+  local json="$dst/.gemini/_mcp.json"
+  local result=0
+  [[ -f "$json" ]] || { echo "_mcp.json missing"; result=1; }
+  jq -e '.mcpServers.Gmail.url == "https://gmail.mcp.claude.com/mcp"' "$json" >/dev/null || { echo "url wrong"; cat "$json"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_translate_mcp_local() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+  mkdir -p "$src/mcp" "$dst/.gemini"
+  cat > "$src/mcp/servers.yaml" <<'HEREDOC'
+servers:
+  - name: gmail
+    type: local
+    command: [npx, -y, "@anthropic-ai/gmail-mcp"]
+    env: {}
+HEREDOC
+  adapter_translate_mcp "$src/mcp" "$dst"
+  local json="$dst/.gemini/_mcp.json"
+  local result=0
+  jq -e '.mcpServers.gmail.command == "npx"' "$json" >/dev/null || { echo "command wrong"; cat "$json"; result=1; }
+  jq -e '.mcpServers.gmail.args | length > 0' "$json" >/dev/null || { echo "args missing"; cat "$json"; result=1; }
+  rm -rf "$src" "$dst"
+  return $result
+}
+
+test_gemini_adapter_build_end_to_end() {
+  local src; src="$(mktemp -d)"
+  local dst; dst="$(mktemp -d)"
+
+  echo "# Dispatcher" > "$src/DISPATCHER.md"
+  mkdir -p "$src/agents" "$src/hooks" "$src/skills/onboarding" "$src/references" "$src/mcp"
+  cat > "$src/agents/scribe.md" <<'HEREDOC'
+---
+name: scribe
+description: Test scribe
+model: mid
+capabilities: [read, write, edit]
+---
+
+body
+HEREDOC
+  cat > "$src/hooks/protect.hook.yaml" <<'HEREDOC'
+name: protect
+script: protect.sh
+triggers:
+  - event: before-tool-use
+    match-tool: [edit]
+HEREDOC
+  echo "#!/usr/bin/env bash" > "$src/hooks/protect.sh"
+  cat > "$src/skills/onboarding/SKILL.md" <<'HEREDOC'
+---
+name: onboarding
+description: Onboarding skill
+---
+body
+HEREDOC
+  echo "reference content" > "$src/references/policy.md"
+  cat > "$src/mcp/servers.yaml" <<'HEREDOC'
+servers:
+  - name: Gmail
+    type: http
+    url: "https://gmail.mcp.claude.com/mcp"
+    env: {}
+HEREDOC
+
+  adapter_build "$src" "$dst"
+
+  local result=0
+  [[ -f "$dst/GEMINI.md" ]]                              || { echo "GEMINI.md missing"; result=1; }
+  [[ -f "$dst/.gemini/agents/scribe.md" ]]               || { echo "agent missing"; result=1; }
+  [[ -f "$dst/.gemini/skills/onboarding/SKILL.md" ]]     || { echo "skill missing"; result=1; }
+  [[ -f "$dst/.gemini/references/policy.md" ]]           || { echo "reference missing"; result=1; }
+  [[ -f "$dst/.gemini/hooks/protect.sh" ]]               || { echo "hook script missing"; result=1; }
+  [[ -f "$dst/.gemini/hooks/protect-wrapper.sh" ]]       || { echo "wrapper missing"; result=1; }
+  [[ -f "$dst/.gemini/settings.json" ]]                  || { echo "settings.json missing"; result=1; }
+  jq -e '.hooks' "$dst/.gemini/settings.json" >/dev/null || { echo "hooks missing from settings.json"; result=1; }
+  jq -e '.mcpServers' "$dst/.gemini/settings.json" >/dev/null || { echo "mcpServers missing from settings.json"; result=1; }
+  [[ ! -f "$dst/.gemini/_hooks.json" ]] || { echo "_hooks.json should be cleaned up"; result=1; }
+  [[ ! -f "$dst/.gemini/_mcp.json" ]] || { echo "_mcp.json should be cleaned up"; result=1; }
+
+  rm -rf "$src" "$dst"
+  return $result
+}