tests: reduce background task timing flakiness (openai#37)

Co-authored-by: VOIDXAI <VOIDXAI@users.noreply.github.com>

Author: VOIDXAI

.claude-plugin/marketplace.json

@@ -1,11 +1,11 @@
 {
-  "name": "openai-codex",
+  "name": "trunkszi-codex-gemini",
   "owner": {
-    "name": "OpenAI"
+    "name": "trunkszi"
   },
   "metadata": {
-    "description": "Codex plugins to use in Claude Code for delegation and code review.",
-    "version": "1.0.2"
+    "description": "Codex and Gemini plugins for Claude Code — code review and task delegation.",
+    "version": "1.1.0"
   },
   "plugins": [
     {
@@ -16,6 +16,15 @@
         "name": "OpenAI"
       },
       "source": "./plugins/codex"
+    },
+    {
+      "name": "gemini",
+      "description": "Use Gemini CLI from Claude Code for code review.",
+      "version": "0.1.0",
+      "author": {
+        "name": "trunkszi"
+      },
+      "source": "./plugins/gemini"
     }
   ]
 }

README.md

@@ -1,36 +1,49 @@
-# Codex plugin for Claude Code
+# Codex & Gemini plugins for Claude Code
 
-Use Codex from inside Claude Code for code reviews or to delegate tasks to Codex.
+Use Codex and Gemini from inside Claude Code for code reviews or to delegate tasks.
 
-This plugin is for Claude Code users who want an easy way to start using Codex from the workflow
-they already have.
+This project provides two Claude Code plugins:
+
+- **Codex plugin** — integrates OpenAI Codex for code review, adversarial review, and task delegation
+- **Gemini plugin** — integrates Google Gemini CLI for code review and adversarial review
 
 <video src="./docs/plugin-demo.webm" controls muted playsinline autoplay></video>
 
 ## What You Get
 
+### Codex commands
+
 - `/codex:review` for a normal read-only Codex review
 - `/codex:adversarial-review` for a steerable challenge review
 - `/codex:rescue`, `/codex:status`, `/codex:result`, and `/codex:cancel` to delegate work and manage background jobs
 
+### Gemini commands
+
+- `/gemini:review` for a read-only Gemini code review
+- `/gemini:adversarial-review` for a steerable adversarial review powered by Gemini
+- `/gemini:setup` to check Gemini CLI availability and authentication
+
 ## Requirements
 
-- **ChatGPT subscription (incl. Free) or OpenAI API key.**
-  - Usage will contribute to your Codex usage limits. [Learn more](https://developers.openai.com/codex/pricing).
 - **Node.js 18.18 or later**
+- **For Codex commands:** ChatGPT subscription (incl. Free) or OpenAI API key. Usage will contribute to your Codex usage limits. [Learn more](https://developers.openai.com/codex/pricing).
+- **For Gemini commands:** Google account with Gemini access.
 
 ## Install
 
-Add the marketplace in Claude Code:
+### Option A: Install from this fork via marketplace (includes both Codex and Gemini)
+
+Add this fork as a marketplace in Claude Code:
 
 ```bash
-/plugin marketplace add openai/codex-plugin-cc
+/plugin marketplace add trunkszi/codex-plugin-cc
 ```
 
-Install the plugin:
+Install the plugins you need:
 
 ```bash
-/plugin install codex@openai-codex
+/plugin install codex@trunkszi-codex-gemini
+/plugin install gemini@trunkszi-codex-gemini
 ```
 
 Reload plugins:
@@ -39,7 +52,40 @@ Reload plugins:
 /reload-plugins
 ```
 
-Then run:
+### Option B: Install from local directory
+
+Clone this repository and load plugins directly:
+
+```bash
+git clone https://github.com/trunkszi/codex-plugin-cc.git
+cd codex-plugin-cc
+git checkout gemini/plugin-integration
+claude --plugin-dir ./plugins/codex --plugin-dir ./plugins/gemini
+```
+
+Or load only the plugin you need:
+
+```bash
+claude --plugin-dir ./plugins/codex    # Codex only
+claude --plugin-dir ./plugins/gemini   # Gemini only
+```
+
+### Option C: Install Codex plugin from official marketplace (Codex only)
+
+If you only need the original Codex plugin, install from the official marketplace:
+
+```bash
+/plugin marketplace add openai/codex-plugin-cc
+/plugin install codex@openai-codex
+/reload-plugins
+```
+
+> [!NOTE]
+> The official marketplace only includes the Codex plugin. The Gemini plugin is available through this fork (Option A or B).
+
+### Post-install setup
+
+For Codex, run:
 
 ```bash
 /codex:setup
@@ -59,10 +105,28 @@ If Codex is installed but not logged in yet, run:
 !codex login
 ```
 
+For Gemini, run:
+
+```bash
+/gemini:setup
+```
+
+If Gemini CLI is not installed:
+
+```bash
+npm install -g @google/gemini-cli
+```
+
+If Gemini CLI is installed but not authenticated, start the login flow:
+
+```bash
+!gemini
+```
+
 After install, you should see:
 
-- the slash commands listed below
-- the `codex:codex-rescue` subagent in `/agents`
+- the Codex slash commands (`/codex:*`) and the `codex:codex-rescue` subagent in `/agents`
+- the Gemini slash commands (`/gemini:*`)
 
 One simple first run is:
 
@@ -303,3 +367,128 @@ Yes. If you already use Codex, the plugin picks up the same [configuration](#com
 Yes. Because the plugin uses your local Codex CLI, your existing sign-in method and config still apply.
 
 If you need to point the built-in OpenAI provider at a different endpoint, set `openai_base_url` in your [Codex config](https://developers.openai.com/codex/config-advanced/#config-and-state-locations).
+
+---
+
+# Gemini plugin for Claude Code
+
+Use Google Gemini CLI from inside Claude Code for code reviews.
+
+This plugin is for Claude Code users who want to use Gemini as an additional review tool alongside or instead of Codex.
+
+See the [Install](#install) section above for setup instructions.
+
+## Usage
+
+### `/gemini:review`
+
+Runs a standard Gemini code review on your current work. The review runs in read-only mode (`--approval-mode plan`) and will not modify any files.
+
+> [!NOTE]
+> Code review for multi-file changes might take a while. It's generally recommended to run it in the background.
+
+Use it when you want:
+
+- a review of your current uncommitted changes
+- a review of your branch compared to a base branch like `main`
+
+Use `--base <ref>` for branch review. It also supports `--wait` and `--background`.
+
+Examples:
+
+```bash
+/gemini:review
+/gemini:review --base main
+/gemini:review --background
+/gemini:review --model gemini-2.5-pro --wait
+```
+
+This command is read-only and will not perform any changes.
+
+### `/gemini:adversarial-review`
+
+Runs a **steerable** adversarial review that questions the chosen implementation and design.
+
+It can be used to pressure-test assumptions, tradeoffs, failure modes, and whether a different approach would have been safer or simpler.
+
+It uses the same review target selection as `/gemini:review`, including `--base <ref>` for branch review.
+It also supports `--wait`, `--background`, and `--model <model>`. Unlike `/gemini:review`, it can take extra focus text after the flags.
+
+Use it when you want:
+
+- a review before shipping that challenges the direction, not just the code details
+- review focused on design choices, tradeoffs, hidden assumptions, and alternative approaches
+- pressure-testing around specific risk areas like auth, data loss, rollback, race conditions, or reliability
+
+Examples:
+
+```bash
+/gemini:adversarial-review
+/gemini:adversarial-review --base main challenge whether this was the right caching design
+/gemini:adversarial-review --model gemini-2.5-pro --wait look for race conditions
+/gemini:adversarial-review --background
+```
+
+This command is read-only. It does not fix code.
+
+### `/gemini:setup`
+
+Checks whether Gemini CLI is installed and authenticated.
+
+```bash
+/gemini:setup
+```
+
+## Typical Gemini Flows
+
+### Quick Review
+
+```bash
+/gemini:review --wait
+```
+
+### Adversarial Review Before Shipping
+
+```bash
+/gemini:adversarial-review --wait
+```
+
+### Use A Specific Model
+
+```bash
+/gemini:adversarial-review --model gemini-2.5-pro --wait
+```
+
+### Background Review
+
+```bash
+/gemini:review --background
+```
+
+## Gemini Integration
+
+The Gemini plugin invokes the [Gemini CLI](https://github.com/google-gemini/gemini-cli) in headless mode (`gemini -p <prompt> --approval-mode plan`). Each review spawns a single `gemini` process that runs to completion.
+
+Review context (git diff, file contents) is piped via stdin with randomized boundary tags to prevent prompt injection. The instruction prompt is passed via the `-p` flag.
+
+The plugin reuses shared infrastructure from the Codex plugin for git context collection, argument parsing, and workspace resolution.
+
+## Gemini FAQ
+
+### Do I need a Google Cloud account?
+
+No. Gemini CLI authenticates with a standard Google account. Run `gemini` interactively once to complete the login flow.
+
+### What model does it use by default?
+
+Gemini CLI uses its own default model (currently `gemini-2.0-pro-exp-02-05` as of CLI version 0.36.0). You can override it with `--model <model-name>` on any review command.
+
+### Can I use both Codex and Gemini plugins together?
+
+Yes. Load both plugins with:
+
+```bash
+claude --plugin-dir ./plugins/codex --plugin-dir ./plugins/gemini
+```
+
+The commands use different prefixes (`/codex:*` and `/gemini:*`) so they do not conflict.

plugins/gemini/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "gemini",
+  "version": "0.1.0",
+  "description": "Use Gemini CLI from Claude Code to review code.",
+  "author": {
+    "name": "Community"
+  }
+}

plugins/gemini/agents/gemini-review.md

@@ -0,0 +1,52 @@
+---
+name: gemini-review
+description: Use proactively when the user asks to review code with Gemini, run a Gemini code review, run a Gemini adversarial review, or mentions "gemini review", "gemini adversarial-review", or "use gemini to review". This agent handles all Gemini CLI review operations.
+tools: Bash
+---
+
+You are a forwarding wrapper around the Gemini companion review runtime.
+
+Your job is to invoke the correct Gemini review command based on the user's request. Do not do anything else.
+
+Selection guidance:
+
+- Use this subagent when the user mentions Gemini and review in the same request.
+- This includes: "use gemini to review", "gemini review", "gemini adversarial review", "use gemini:review", "use gemini:adversarial-review", or any natural language request to perform a code review using Gemini.
+- Do not use this agent for non-review tasks. Gemini plugin only supports review operations.
+
+Review type detection:
+
+- If the user mentions "adversarial", "challenge", "question the design", "pressure test", or provides focus text describing what to challenge, use `adversarial-review`.
+- Otherwise, use `review`.
+
+Argument handling:
+
+- `--model <model>`: Pass through if the user specifies a model name (e.g., `--model gemini-2.5-pro`, `--model gemini-3.1-pro-preview`).
+- `--base <ref>`: Pass through if the user specifies a base branch (e.g., `--base main`).
+- `--scope <scope>`: Pass through if specified. Valid values: `auto`, `working-tree`, `branch`.
+- `--wait` / `--background`: If the user does not specify, prefer `--wait` for small reviews, omit for larger ones to let the script decide.
+- Focus text: For adversarial reviews, any extra descriptive text from the user (e.g., "look for race conditions") should be passed as positional arguments after the flags.
+- IMPORTANT: When inserting arguments into the shell command, always wrap them in single quotes to prevent bash command substitution.
+
+Forwarding rules:
+
+- Use exactly one `Bash` call to invoke the companion script.
+
+For standard review:
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/gemini-companion.mjs" review [flags]
+```
+
+For adversarial review:
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/gemini-companion.mjs" adversarial-review [flags] [focus text]
+```
+
+- Return the stdout of the command exactly as-is.
+- Do not paraphrase, summarize, or add commentary before or after the output.
+- Do not fix any issues mentioned in the review output.
+- If the Bash call fails, return the error message as-is.
+
+Response style:
+
+- Do not add commentary before or after the review output.