code-context-control 2.51.0__py3-none-any.whl → 2.52.0__py3-none-any.whl

cli/_hook_utils.py

@@ -33,6 +33,28 @@ LEGACY_UNLOCK_FILE = ".c3/unlocked_files.json"
 STATE_WARNINGS: list = []
 
 
+def ensure_utf8_stdio() -> None:
+    """Force UTF-8 on the hook process's stdio pipes.
+
+    On Windows a hook subprocess gets cp1252 stdout/stdin (piped, non-TTY),
+    so printing user-visible text containing box-drawing chars ("─") or emoji
+    raises UnicodeEncodeError and surfaces as a "Stop hook error" in the IDE.
+    Claude Code reads hook stdout as UTF-8. Call this at the top of every
+    entrypoint that prints raw (non-json.dumps) text. Never raises.
+    """
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            if hasattr(stream, "reconfigure"):
+                stream.reconfigure(encoding="utf-8", errors="replace")
+        except Exception:
+            pass
+    try:
+        if hasattr(sys.stdin, "reconfigure"):
+            sys.stdin.reconfigure(encoding="utf-8", errors="strict")
+    except Exception:
+        pass
+
+
 def log_hook_error(hook_name: str, exc: BaseException) -> None:
     """Append a timestamped error entry to .c3/hook_errors.log.
 

cli/c3.py

@@ -92,7 +92,7 @@ console = Console() if HAS_RICH else None
 # Config
 CONFIG_DIR = ".c3"
 CONFIG_FILE = ".c3/config.json"
-__version__ = "2.51.0"
+__version__ = "2.52.0"
 
 
 def _command_deps() -> CommandDeps:
@@ -711,8 +711,7 @@ def _select_init_ide(default_ide: str) -> str:
         "VS Code      — .vscode/mcp.json + Copilot instructions",
         "Cursor       — .cursor/mcp.json",
         "Codex        — .codex/config.toml + AGENTS.md",
-        "Gemini       — .gemini/settings.json + GEMINI.md",
-        "Antigravity  — ~/.gemini/antigravity/mcp_config.json",
+        "Antigravity  — ~/.gemini/antigravity/mcp_config.json + AGENTS.md",
     ]
     selected = _prompt_choice("Step 1/3 — Choose IDE profile", choices)
     mapping = {
@@ -721,8 +720,7 @@ def _select_init_ide(default_ide: str) -> str:
         choices[2]: "vscode",
         choices[3]: "cursor",
         choices[4]: "codex",
-        choices[5]: "gemini",
-        choices[6]: "antigravity",
+        choices[5]: "antigravity",
     }
     chosen = mapping.get(selected or "", normalize_ide_name(default_ide) if default_ide != "auto" else "auto")
     print(f"  IDE profile: {chosen}")
@@ -887,7 +885,7 @@ def _parse_cli_ide_arg(value: str) -> str:
     normalized = normalize_ide_name(raw)
     if normalized not in PROFILES:
         raise argparse.ArgumentTypeError(
-            "Unsupported IDE. Use one of: auto, claude, vscode, cursor, codex, gemini, antigravity."
+            "Unsupported IDE. Use one of: auto, claude, vscode, cursor, codex, antigravity."
         )
     return normalized
 
@@ -4013,29 +4011,6 @@ enabled = true
 ```
 """
 
-_GEMINI_MD_CONTENT = _C3_COMPACT_WORKFLOW + """
-
-## IDE Configuration (Gemini CLI)
-This project uses project-scoped MCP servers. Ensure your `.gemini/settings.json` includes:
-```json
-{
-  "mcpServers": {
-    "c3": {
-      "command": "c3-mcp",
-      "args": ["--project", "."]
-    }
-  }
-}
-```
-
-## Gemini Enforcement
-- `c3 init` and `c3 install-mcp` install this file as a required workflow, not a suggestion.
-- After install, use the `c3` MCP server for recall, search, structural mapping, surgical reads, filtering, and session logging before native Gemini repo exploration.
-- Do not bypass C3 with broad native search/read steps unless a matching `c3_*` tool failed or was too narrow for a final follow-up.
-- If fallback is necessary, say which `c3_*` tool was attempted or skipped and why.
-"""
-
-
 _TERSE_SKILL_CONTENT = """\
 # /terse — Terse Output Mode
 
@@ -4113,28 +4088,16 @@ Say "normal mode", start a new session, or let the turn counter expire.
 _TERSE_SKILL_MARKER = "# /terse — Terse Output Mode"
 
 
-_TERSE_GEMINI_TOML = (
-    'description = "Terse output mode. Usage: /terse [lite|full|ultra] (default: full)."\n'
-    "prompt = '''\n"
-    + _TERSE_SKILL_CONTENT.replace("'''", "''\\''")
-    + "\n'''\n"
-)
-
-
 def _ensure_terse_skill(ide: str = "claude-code") -> None:
     """Install the /terse slash command for the given IDE profile.
 
     claude-code -> ~/.claude/commands/terse.md
     codex       -> ~/.codex/prompts/terse.md
-    gemini      -> ~/.gemini/commands/terse.toml
     """
     home = Path.home()
     if ide == "codex":
         skill_path = home / ".codex" / "prompts" / "terse.md"
         content = _TERSE_SKILL_CONTENT
-    elif ide == "gemini":
-        skill_path = home / ".gemini" / "commands" / "terse.toml"
-        content = _TERSE_GEMINI_TOML
     else:
         skill_path = home / ".claude" / "commands" / "terse.md"
         content = _TERSE_SKILL_CONTENT
@@ -4357,7 +4320,7 @@ def _upsert_json_mcp_server(config_path: Path, config_key: str, server_name: str
 
 def _ensure_project_session_configs(target: Path, server_script: str, primary_profile: str | None = None,
                                     c3_mcp_exe: str | None = None) -> None:
-    """Keep project-local Codex and Gemini MCP configs in sync for new sessions."""
+    """Keep the project-local Codex MCP config in sync for new sessions."""
     # Ensure forward slashes for config portability and avoid Windows path-splitting issues
     server_script_posix = Path(server_script).as_posix()
     if c3_mcp_exe:
@@ -4381,26 +4344,16 @@ def _ensure_project_session_configs(target: Path, server_script: str, primary_pr
         )
         print(f"{codex_state.capitalize()} {codex_path}")
 
-    if primary_profile != "gemini":
-        gemini_path = target / ".gemini" / "settings.json"
-        gemini_state = _upsert_json_mcp_server(
-            gemini_path,
-            "mcpServers",
-            "c3",
-            {
-                "command": mcp_command,
-                "args": server_args,
-            },
-        )
-        print(f"{gemini_state.capitalize()} {gemini_path}")
 
 
-def _ensure_global_session_fallbacks(server_script: str, c3_mcp_exe: str | None = None) -> None:
-    """Keep user-global Codex/Gemini MCP configs pointing at C3.
+
+def _ensure_global_session_fallbacks(server_script: str, c3_mcp_exe: str | None = None,
+                                     primary_profile: str | None = None) -> None:
+    """Keep user-global Codex/Antigravity MCP configs pointing at C3.
 
     These fallback entries omit `--project` so the MCP server can resolve the
     active working directory dynamically when a session starts in a project that
-    does not yet have project-local Codex/Gemini config files.
+    does not yet have a project-local Codex config file.
     """
     server_script_posix = Path(server_script).as_posix()
     # With the installed entry point, no script path is needed; --project stays
@@ -4423,20 +4376,25 @@ def _ensure_global_session_fallbacks(server_script: str, c3_mcp_exe: str | None
     except PermissionError:
         print(f"Warning: Could not update {codex_path} (global fallback skipped)")
 
-    gemini_path = Path.home() / ".gemini" / "settings.json"
-    try:
-        gemini_state = _upsert_json_mcp_server(
-            gemini_path,
-            "mcpServers",
-            "c3",
-            {
-                "command": c3_mcp_exe or sys.executable,
-                "args": fallback_args,
-            },
-        )
-        print(f"{gemini_state.capitalize()} {gemini_path}  (global fallback)")
-    except PermissionError:
-        print(f"Warning: Could not update {gemini_path} (global fallback skipped)")
+    # Antigravity shares the ~/.gemini home dir but reads its own MCP config.
+    # When Antigravity is the primary profile, the main install flow already
+    # wrote this file — here we only keep it fresh for codex installs
+    # on machines that have Antigravity (its config dir exists).
+    antigravity_path = Path.home() / ".gemini" / "antigravity" / "mcp_config.json"
+    if primary_profile != "antigravity" and antigravity_path.parent.is_dir():
+        try:
+            ag_state = _upsert_json_mcp_server(
+                antigravity_path,
+                "mcpServers",
+                "c3",
+                {
+                    "command": c3_mcp_exe or sys.executable,
+                    "args": fallback_args,
+                },
+            )
+            print(f"{ag_state.capitalize()} {antigravity_path}  (global fallback)")
+        except PermissionError:
+            print(f"Warning: Could not update {antigravity_path} (global fallback skipped)")
 
 
 def _uninstall_mcp_all(project_path: str):
@@ -4474,8 +4432,8 @@ def _uninstall_mcp_all(project_path: str):
             config_paths.append(Path.home() / profile.config_path)
         else:
             config_paths.append(target / profile.config_path)
-            # For Codex and Gemini, also check the global fallback in home dir
-            if ide_name in ("codex", "gemini"):
+            # For Codex, also check the global fallback in home dir
+            if ide_name == "codex":
                 config_paths.append(Path.home() / profile.config_path)
 
         for mcp_config_path in config_paths:
@@ -4597,6 +4555,22 @@ def _uninstall_mcp_all(project_path: str):
                 except Exception as e:
                     print(f"  Warning: Could not update {vscode_settings_path}: {e}")
 
+    # Legacy Gemini CLI configs (profile removed in v2.52) — still strip the c3 entry.
+    for legacy_cfg in (target / ".gemini" / "settings.json",
+                       Path.home() / ".gemini" / "settings.json"):
+        if not legacy_cfg.exists():
+            continue
+        try:
+            with open(legacy_cfg, encoding="utf-8") as f:
+                legacy_data = json.load(f)
+            if "c3" in (legacy_data.get("mcpServers") or {}):
+                del legacy_data["mcpServers"]["c3"]
+                with open(legacy_cfg, "w", encoding="utf-8") as f:
+                    json.dump(legacy_data, f, indent=2)
+                print(f"  Removed C3 from {legacy_cfg}")
+        except Exception as e:
+            print(f"  Warning: Could not update {legacy_cfg}: {e}")
+
     # Final pass: clean up empty IDE directories (.claude, .codex, .gemini, .vscode, .github)
     dirs_to_check = [".claude", ".codex", ".gemini", ".vscode", ".github"]
     for dname in dirs_to_check:
@@ -4715,11 +4689,27 @@ def _ensure_global_claude_md() -> None:
 
 
 def _instruction_documents_for_project() -> list[tuple[str, str]]:
-    """Return the project-local instruction documents C3 should keep in sync."""
+    """Return every project-local instruction document C3 has ever managed.
+
+    Used by uninstall/cleanup paths, so it must keep listing legacy docs
+    (GEMINI.md — profile removed in v2.52; empty template, never generated).
+    """
     return [
         ("CLAUDE.md", _CLAUDE_MD_CONTENT),
         ("AGENTS.md", _AGENTS_MD_CONTENT),
-        ("GEMINI.md", _GEMINI_MD_CONTENT),
+        ("GEMINI.md", ""),
+    ]
+
+
+_LEGACY_INSTRUCTION_DOCS = ("GEMINI.md",)  # Gemini CLI profile removed in v2.52
+
+
+def _instruction_documents_to_generate() -> list[tuple[str, str]]:
+    """Instruction docs to write for a project (legacy docs excluded)."""
+    return [
+        (name, template)
+        for name, template in _instruction_documents_for_project()
+        if name not in _LEGACY_INSTRUCTION_DOCS
     ]
 
 
@@ -4727,7 +4717,7 @@ def _sync_project_instruction_docs(project_path: str, sm: SessionManager) -> Non
     """Write the current C3 instruction docs into the project root."""
     repo_root = Path(__file__).resolve().parent.parent
     synced: list[str] = []
-    for instructions_file, template in _instruction_documents_for_project():
+    for instructions_file, template in _instruction_documents_to_generate():
         print(f"Generating {instructions_file}...")
         # Resolve placeholder for project-scoped MCP configs
         resolved_template = template.replace("<path-to-c3>", str(repo_root).replace("\\", "/"))
@@ -4993,8 +4983,8 @@ def cmd_install_mcp(args):
         if _found:
             c3_mcp_exe = Path(_found).resolve().as_posix()
 
-    # On Windows, Gemini CLI splits command args by space, so the script path stays a
-    # single arg. 'python' keeps the source fallback portable across platforms.
+    # Keep the script path as a single arg; 'python' keeps the source fallback
+    # portable across platforms.
     if c3_mcp_exe:
         new_entry = {"command": c3_mcp_exe, "args": ["--project", "."]}
     else:
@@ -5069,9 +5059,9 @@ def cmd_install_mcp(args):
         # instead of letting it surface as anonymous out-of-band drift.
         from services.artifact_defs import note_pending_write
         note_pending_write(target, profile.config_path, "install_mcp")
-    if profile.name in {"codex", "gemini"}:
+    if profile.name in {"codex", "antigravity"}:
         _ensure_project_session_configs(target, server_script, primary_profile=profile.name, c3_mcp_exe=c3_mcp_exe)
-        _ensure_global_session_fallbacks(server_script, c3_mcp_exe=c3_mcp_exe)
+        _ensure_global_session_fallbacks(server_script, c3_mcp_exe=c3_mcp_exe, primary_profile=profile.name)
 
     # ── Persist IDE choice to .c3/config.json ──
     c3_config_dir = target / ".c3"
@@ -5085,7 +5075,7 @@ def cmd_install_mcp(args):
     with open(c3_config_path, 'w', encoding="utf-8") as f:
         json.dump(c3_config, f, indent=2)
 
-    # ── Install hooks (Claude Code + Gemini CLI) ──
+    # ── Install hooks (Claude Code) ──
     if profile.supports_hooks and profile.settings_path:
         settings_dir = target / Path(profile.settings_path).parent
         settings_dir.mkdir(parents=True, exist_ok=True)
@@ -5116,26 +5106,15 @@ def cmd_install_mcp(args):
         hook_stop_cmd     = f"{_dispatch_base} stop"
         hook_prompt_cmd   = f"{_dispatch_base} prompt"
 
-        # Tool matcher names differ by IDE: Gemini uses snake_case built-in names.
-        if profile.name == "gemini":
-            shell_matcher  = "run_shell_command"
-            read_matcher   = "read_file"
-            grep_matcher   = "grep"
-            glob_matcher   = "find_files"
-            edit_matcher   = "edit_file"
-            write_matcher  = "write_file"
-            # Gemini has no MultiEdit / NotebookEdit equivalents.
-            extra_edit_matchers = []
-        else:
-            shell_matcher  = "Bash"
-            read_matcher   = "Read"
-            grep_matcher   = "Grep"
-            glob_matcher   = "Glob"
-            edit_matcher   = "Edit"
-            write_matcher  = "Write"
-            # Claude Code also exposes MultiEdit (batch edits) and NotebookEdit;
-            # both bypass enforcement/logging unless their matchers are registered.
-            extra_edit_matchers = ["MultiEdit", "NotebookEdit"]
+        shell_matcher  = "Bash"
+        read_matcher   = "Read"
+        grep_matcher   = "Grep"
+        glob_matcher   = "Glob"
+        edit_matcher   = "Edit"
+        write_matcher  = "Write"
+        # Claude Code also exposes MultiEdit (batch edits) and NotebookEdit;
+        # both bypass enforcement/logging unless their matchers are registered.
+        extra_edit_matchers = ["MultiEdit", "NotebookEdit"]
 
         # ── PostToolUse hooks ──
         # Matcher set is unchanged from pre-v2.42; every matcher now points at
@@ -5193,8 +5172,7 @@ def cmd_install_mcp(args):
         existing_post.extend(desired_post_hooks)
         settings.setdefault("hooks", {})[hook_event] = existing_post
 
-        # PreToolUse hooks (Claude Code: "PreToolUse", Gemini: "BeforeTool")
-        pre_event = "BeforeTool" if profile.name == "gemini" else "PreToolUse"
+        pre_event = "PreToolUse"
         pre_matchers = {h.get("matcher") for h in desired_pre_hooks}
         existing_pre = [
             h for h in settings.get("hooks", {}).get(pre_event, [])
@@ -5204,7 +5182,6 @@ def cmd_install_mcp(args):
         settings.setdefault("hooks", {})[pre_event] = existing_pre
 
         # ── Stop hooks (auto-snapshot + session stats on session end / Ctrl+C) ──
-        # Stop hooks fire for both Claude Code ("Stop") and Gemini ("Stop").
         desired_stop_hooks = [
             {
                 "matcher": "",
@@ -5239,26 +5216,25 @@ def cmd_install_mcp(args):
         settings.setdefault("hooks", {})[stop_event] = existing_stop
 
         # ── UserPromptSubmit hook (per-prompt project-memory injection) ──
-        # Claude Code only: Gemini CLI has no equivalent hook event. Same
-        # merge discipline as Stop: replace only C3's own entries (identified
-        # by the dispatcher script in the command), keep user-added ones.
-        if profile.name != "gemini":
-            prompt_event = "UserPromptSubmit"
-
-            def _is_c3_prompt_hook(entry: dict) -> bool:
-                return any(
-                    "hook_dispatch.py" in (hk.get("command") or "")
-                    for hk in entry.get("hooks", [])
-                )
+        # Same merge discipline as Stop: replace only C3's own entries
+        # (identified by the dispatcher script in the command), keep
+        # user-added ones.
+        prompt_event = "UserPromptSubmit"
 
-            existing_prompt = [
-                h for h in settings.get("hooks", {}).get(prompt_event, [])
-                if not _is_c3_prompt_hook(h)
-            ]
-            existing_prompt.append(
-                {"matcher": "", "hooks": [{"type": "command", "command": hook_prompt_cmd}]}
+        def _is_c3_prompt_hook(entry: dict) -> bool:
+            return any(
+                "hook_dispatch.py" in (hk.get("command") or "")
+                for hk in entry.get("hooks", [])
             )
-            settings.setdefault("hooks", {})[prompt_event] = existing_prompt
+
+        existing_prompt = [
+            h for h in settings.get("hooks", {}).get(prompt_event, [])
+            if not _is_c3_prompt_hook(h)
+        ]
+        existing_prompt.append(
+            {"matcher": "", "hooks": [{"type": "command", "command": hook_prompt_cmd}]}
+        )
+        settings.setdefault("hooks", {})[prompt_event] = existing_prompt
 
         # Claude Code only: enable MCP server prompt settings
         if profile.name == "claude-code":
@@ -5364,20 +5340,6 @@ def cmd_install_mcp(args):
             print(f"Warning: {global_codex_cfg} has [mcp_servers.c3] enabled = false.")
             print("  This can make C3 look disabled. Set it to true or remove that global c3 section.")
 
-    # ── Gemini settings.json enforcement file ──────────────────
-    if profile.name == "gemini":
-        # Warn about a common conflict: global Gemini config pointing elsewhere.
-        global_gemini_cfg = Path.home() / ".gemini" / "settings.json"
-        if global_gemini_cfg.exists():
-            try:
-                with open(global_gemini_cfg, 'r', encoding="utf-8") as f:
-                    g_data = json.load(f)
-                if "mcpServers" in g_data and "c3" in g_data["mcpServers"]:
-                    print(f"Note: Global config {global_gemini_cfg} also defines 'c3'.")
-                    print("  The project-local config at .gemini/settings.json should take precedence.")
-            except Exception:
-                pass
-
     _sync_project_instruction_docs(str(target), sm)
 
     # ── User-global C3 enforcement ──────────────────────────────
@@ -5387,7 +5349,7 @@ def cmd_install_mcp(args):
         print(f"Warning: Could not update global CLAUDE.md: {e}")
 
     # ── Install /terse skill for supported IDEs ──────────────────
-    if profile.name in ("claude-code", "codex", "gemini"):
+    if profile.name in ("claude-code", "codex"):
         try:
             _ensure_terse_skill(profile.name)
         except Exception as e:

cli/commands/parser.py

@@ -21,7 +21,7 @@ def build_parser(version: str, parse_cli_ide_arg):
     p_init.add_argument("project_path", nargs="?", default=".")
     p_init.add_argument("--force", action="store_true", help="Skip prompts and apply update non-interactively")
     p_init.add_argument("--clear", action="store_true", help="Remove all C3 files and exit without rebuilding")
-    p_init.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,gemini,antigravity}", help="Target IDE for MCP config (default: auto-detect)")
+    p_init.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,antigravity}", help="Target IDE for MCP config (default: auto-detect)")
     p_init.add_argument("--mcp-mode", choices=["direct", "proxy"], default="direct", help="Default MCP mode if install is selected during init (default: direct)")
     p_init.add_argument("--git", action="store_true", help="Initialize a local Git repository during init/update")
     p_init.add_argument("--permissions", choices=["read-only", "c3-strict", "standard", "permissive"], default=None, help="Apply Claude Code permission tier (Claude Code only, used with --force)")
@@ -93,14 +93,14 @@ def build_parser(version: str, parse_cli_ide_arg):
 
     p_install_mcp = subparsers.add_parser("install-mcp", help="Generate MCP config for your IDE")
     p_install_mcp.add_argument("targets", nargs="*", help="Optional project path and/or IDE shorthand (for example: `claude` or `. codex`)")
-    p_install_mcp.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,gemini,antigravity}", help="Target IDE (default: auto-detect)")
+    p_install_mcp.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,antigravity}", help="Target IDE (default: auto-detect)")
     p_install_mcp.add_argument("--mcp-mode", choices=["direct", "proxy"], default="direct", help="MCP entrypoint mode (default: direct)")
     p_install_mcp.add_argument("--permissions", choices=["read-only", "c3-strict", "standard", "permissive"], default=None, help="Apply Claude Code permission tier (Claude Code only)")
     p_install_mcp.add_argument("--include-mcp-wildcard", action="store_true", help="Add mcp__* wildcard so non-C3 MCP servers don't prompt per-call")
 
     p_mcp_install = subparsers.add_parser("mcp-install", help="Alias for install-mcp")
     p_mcp_install.add_argument("targets", nargs="*", help="Optional project path and/or IDE shorthand")
-    p_mcp_install.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,gemini,antigravity}", help="Target IDE (default: auto-detect)")
+    p_mcp_install.add_argument("--ide", default="auto", type=parse_cli_ide_arg, metavar="{auto,claude,vscode,cursor,codex,antigravity}", help="Target IDE (default: auto-detect)")
     p_mcp_install.add_argument("--mcp-mode", choices=["direct", "proxy"], default="direct", help="MCP entrypoint mode (default: direct)")
     p_mcp_install.add_argument("--permissions", choices=["read-only", "c3-strict", "standard", "permissive"], default=None, help="Apply Claude Code permission tier (Claude Code only)")
     p_mcp_install.add_argument("--include-mcp-wildcard", action="store_true", help="Add mcp__* wildcard so non-C3 MCP servers don't prompt per-call")

cli/docs.html

@@ -790,7 +790,6 @@
       <div class="subtitle">
         A local code intelligence system that reduces AI coding assistant token usage through compression,
         indexing, and persistent memory. Works with <strong>Claude Code</strong>, <strong>Google Antigravity</strong>,
-        <strong>Gemini CLI</strong>,
         <strong>VS Code Copilot</strong>, and <strong>Cursor</strong> via MCP. Available as an <strong>MCP
           server</strong>,
         <strong>CLI</strong>, and <strong>web dashboard</strong>.
@@ -955,7 +954,7 @@ c3 init /path/to/your/project</code></pre>
               <code>.c3/</code> directory, builds the code index, and then walks through a guided 3-step setup:
               choose the IDE profile, optionally run a local <code>git init</code>, and optionally install MCP.
               When MCP is installed, C3 writes the IDE config plus project-local session files such as
-              <code>.codex/config.toml</code> and <code>.gemini/settings.json</code>. For VS Code, also generates
+              <code>.codex/config.toml</code>. For VS Code, also generates
               <code>.github/copilot-instructions.md</code> (hard enforcement language) and
               <code>.vscode/settings.json</code> (Copilot instruction links). For Codex, generates
               <code>AGENTS.md</code> with the C3 session protocol. Use <code>--ide vscode</code>,
@@ -967,7 +966,7 @@ c3 init /path/to/your/project</code></pre>
           <div class="step-content">
             <div class="step-title">Restart your IDE</div>
             <div class="step-desc">Open your IDE in the project. For Claude Code, run <code>/mcp</code> to verify C3
-              tools appear. For Google Antigravity and Gemini CLI, the MCP tools will be loaded based on your config.
+              tools appear. For Google Antigravity, the MCP tools will be loaded based on your config.
               For VS Code, check MCP tools in the Copilot agent panel. For Codex, the <code>.codex/config.toml</code> is
               picked up automatically on next session start.</div>
           </div>
@@ -1021,19 +1020,11 @@ c3 init /path/to/your/project</code></pre>
           <td>No</td>
           <td>No</td>
         </tr>
-        <tr>
-          <td><strong>Gemini CLI</strong></td>
-          <td><code>.gemini/settings.json</code></td>
-          <td><code>GEMINI.md</code></td>
-          <td>—</td>
-          <td>No</td>
-          <td>No</td>
-        </tr>
         <tr>
           <td><strong>Google Antigravity</strong></td>
           <td><code>~/.gemini/antigravity/mcp_config.json</code> <span class="badge badge-warn"
               style="font-size:10px">global</span></td>
-          <td><code>GEMINI.md</code></td>
+          <td><code>AGENTS.md</code></td>
           <td>—</td>
           <td>No</td>
           <td>No</td>
@@ -1059,13 +1050,12 @@ python cli/c3.py install-mcp /path/to/project --ide vscode
 python cli/c3.py install-mcp /path/to/project --ide cursor
 python cli/c3.py install-mcp /path/to/project --ide claude
 python cli/c3.py install-mcp /path/to/project --ide codex
-python cli/c3.py install-mcp /path/to/project --ide gemini
 python cli/c3.py install-mcp /path/to/project --ide antigravity
 
 # IDE shorthand when already inside the project directory
 python cli/c3.py install-mcp claude
 python cli/c3.py install-mcp codex
-python cli/c3.py install-mcp . gemini</code></pre>
+python cli/c3.py install-mcp . antigravity</code></pre>
 
       <p><code>--git</code> runs a local-only <code>git init</code>. It does not create remotes or connect to GitHub,
         GitLab, or any other hosted service.</p>
@@ -1104,30 +1094,20 @@ python cli/c3.py install-mcp . gemini</code></pre>
         </li>
       </ul>
 
-      <p><strong>Gemini CLI</strong> — <code>install-mcp --ide gemini</code> (and <code>c3 init --ide gemini</code>)
-        write a project-scoped JSON config and a GEMINI.md instructions file:</p>
-      <ul>
-        <li><code>.gemini/settings.json</code> — project-scoped MCP config under the <code>mcpServers</code> key.
-          Gemini CLI reads both this file and <code>~/.gemini/settings.json</code> (user-global). Merged with existing
-          settings. Auto-detected when a <code>.gemini/</code> directory or <code>.gemini/settings.json</code> already
-          exists.</li>
-        <li><code>GEMINI.md</code> — Gemini CLI reads this file as project context (loaded from the project root and
-          parent directories). Generated with REQUIRED/MANDATORY/NEVER language and the 7-step C3 session protocol. Only
-          created if absent.</li>
-      </ul>
+      <p><em>The Gemini CLI profile was removed in v2.52 — use Google Antigravity instead. <code>c3 uninstall</code>
+        still cleans up legacy <code>.gemini/settings.json</code> and <code>GEMINI.md</code> files.</em></p>
 
       <p><strong>Google Antigravity</strong> — <code>install-mcp --ide antigravity</code> writes the MCP config to the
-        user-global Antigravity config and a project-local <code>GEMINI.md</code>:</p>
+        user-global Antigravity config and a project-local <code>AGENTS.md</code>:</p>
       <ul>
         <li><code>~/.gemini/antigravity/mcp_config.json</code> — user-global Antigravity MCP config under the
           <code>mcpServers</code> key. This is the file managed by Antigravity's <em>Manage MCPs</em> UI. Merged with
           existing config. Each project still passes <code>--project</code> to the MCP server so C3 indexes the correct
           directory.
         </li>
-        <li><code>GEMINI.md</code> — Antigravity and Gemini CLI both read <code>GEMINI.md</code> files from the
-          project root. Same content as Gemini CLI profile. Only created if absent.</li>
-        <li>Auto-detected when <code>~/.gemini/antigravity/</code> directory already exists alongside a
-          <code>.gemini/</code> project directory.
+        <li><code>AGENTS.md</code> — Antigravity prefers <code>AGENTS.md</code> read from the project root
+          (shared with the Codex profile). Only created if absent.</li>
+        <li>Auto-detected when a legacy <code>.gemini/</code> project directory exists.
         </li>
       </ul>
 

cli/guide/getting-started.html

@@ -172,10 +172,6 @@ c3 init</code></pre>
             <td><code>AGENTS.md</code></td>
             <td>Instructions for Codex sessions</td>
           </tr>
-          <tr>
-            <td><code>.gemini/settings.json</code></td>
-            <td>Instructions for Gemini sessions</td>
-          </tr>
         </tbody>
       </table>
 
@@ -194,7 +190,7 @@ c3 init</code></pre>
         <span class="callout-icon">🛡️</span>
         <div class="callout-body">
           <strong>Your hand-written content is preserved</strong>
-          Generated instruction files (<code>CLAUDE.md</code>, <code>AGENTS.md</code>, <code>GEMINI.md</code>) wrap C3 content in a <code>&lt;!-- C3:BEGIN … --&gt;</code> / <code>&lt;!-- C3:END --&gt;</code> block. Re-running init (or <code>c3 claudemd save</code> / the <strong>Compact</strong> action) rewrites only that block — anything you add outside it stays put. An existing hand-written file with no block is kept and the C3 block is appended below it.
+          Generated instruction files (<code>CLAUDE.md</code>, <code>AGENTS.md</code>) wrap C3 content in a <code>&lt;!-- C3:BEGIN … --&gt;</code> / <code>&lt;!-- C3:END --&gt;</code> block. Re-running init (or <code>c3 claudemd save</code> / the <strong>Compact</strong> action) rewrites only that block — anything you add outside it stays put. An existing hand-written file with no block is kept and the C3 block is appended below it.
         </div>
       </div>
     </section>
@@ -219,9 +215,11 @@ c3 init</code></pre>
       <pre><code>c3 install-mcp codex</code></pre>
       <p>Updates <code>.codex/config.toml</code> and <code>AGENTS.md</code>.</p>
 
-      <h3>Gemini CLI</h3>
-      <pre><code>c3 install-mcp gemini</code></pre>
-      <p>Updates <code>.gemini/settings.json</code>.</p>
+      <h3>Antigravity</h3>
+      <pre><code>c3 install-mcp antigravity</code></pre>
+      <p>Updates the user-global <code>~/.gemini/antigravity/mcp_config.json</code> and <code>AGENTS.md</code>.</p>
+
+      <p><em>The Gemini CLI profile was removed in v2.52 — use Antigravity instead. <code>c3 uninstall</code> still cleans up legacy <code>.gemini/settings.json</code> and <code>GEMINI.md</code> files.</em></p>
 
       <h3>All IDEs at once</h3>
       <pre><code>c3 install-mcp all</code></pre>

cli/guide/tools.html

@@ -611,7 +611,7 @@ c3_impact(target=<span class="str">'_legacy_compress'</span>)</code></pre>
                 <td class="param-name">cmd</td>
                 <td class="param-type">string</td>
                 <td class="param-default">required</td>
-                <td class="param-desc">Shell command to execute (runs via <code>subprocess.Popen(shell=True)</code>)</td>
+                <td class="param-desc">Shell command to execute (Git Bash on Windows when available; otherwise the platform default shell)</td>
               </tr>
               <tr>
                 <td class="param-name">cwd</td>
@@ -648,7 +648,10 @@ c3_shell(cmd=<span class="str">'pytest tests/test_c3_shell.py -v'</span>)
 c3_shell(cmd=<span class="str">'git commit -m "wire c3_shell"'</span>)
 
 <span class="com"># Build with a longer timeout</span>
-c3_shell(cmd=<span class="str">'npm run build'</span>, timeout=<span class="str">300</span>)</code></pre>
+c3_shell(cmd=<span class="str">'npm run build'</span>, timeout=<span class="str">300</span>)
+
+<span class="com"># Portable JSON formatting — Git Bash may not include jq</span>
+c3_shell(cmd=<span class="str">'curl -s http://localhost:8000/health | python -m json.tool'</span>)</code></pre>
 
           <h4>Safety classification</h4>
           <div class="tag-row">
@@ -661,7 +664,7 @@ c3_shell(cmd=<span class="str">'npm run build'</span>, timeout=<span class="str"
           <div class="callout callout-tip">
             <span class="callout-icon">💡</span>
             <div class="callout-body">
-              Prefer <code>c3_shell</code> over native <code>Bash</code> for anything noisy, git-mutating, or long-running. You get structured returns, consistent Windows timeout behaviour, free output filtering, and ledger coupling. Fall back to native <code>Bash</code> only for interactive / TTY commands.
+              Prefer <code>c3_shell</code> over native <code>Bash</code> for anything noisy, git-mutating, or long-running. You get structured returns, consistent timeout behaviour, free output filtering, and ledger coupling. Git Bash does not guarantee optional utilities such as <code>jq</code>; use Python's stdlib JSON tools for portable commands. Fall back to native <code>Bash</code> only for interactive / TTY commands.
             </div>
           </div>
         </div>

cli/hook_dispatch.py

@@ -235,6 +235,9 @@ def dispatch(event: str, payload: dict, project_path: Path | None = None) -> dic
 
 
 def main() -> None:
+    # Windows hook subprocesses get cp1252 pipes; sub-hook _text may carry
+    # box-drawing chars / emoji, so print(text) below would UnicodeEncodeError.
+    _hook_utils.ensure_utf8_stdio()
     event = sys.argv[1].strip().lower() if len(sys.argv) > 1 else ""
     if event not in VALID_EVENTS:
         log_hook_error(