gemini-deep-research

name	gemini-deep-research
description	Platform knowledge for Gemini Deep Research at gemini.google.com. Standalone: spawns browser-researcher agent. Or loaded by browser-researcher at runtime via skill_path. Trigger on "gemini deep research", "use gemini to research", "run deep research on gemini", "google deep research", or when explicitly requesting Gemini's native deep research capability.
context	fork
model	opus

Gemini Deep Research — Platform Knowledge

Standalone Invocation

If invoked directly via /gemini-deep-research, spawn the browser-researcher agent:

Agent(
  subagent_type="browser-researcher",
  name="gemini-researcher",
  prompt="skill_path: <skill-path>/SKILL.md\nresearch_prompt: <from user>\noutput_path: <from user or .work/gemini-report.md>\ncaller: <your name>",
  run_in_background=true
)

Then relay messages between user and agent via SendMessage. If loaded by browser-researcher via Read, ignore this section.

Platform Configuration

• url: https://gemini.google.com/app
• backend: playwright-cli
• submit_method: enter_key
• plan_review: gated
• hard_timeout: 90
• completion_signal: "I've completed your research"

Playwright-CLI Backend

All browser interaction is driven by scripts/pw-driver.py via Bash. The agent calls subcommands; the driver handles Chrome lifecycle, CDP attach, and all DOM interaction internally.

Phase	Subcommand
Login check	python3 scripts/pw-driver.py status (exit 10 = login required)
One-time login	python3 scripts/pw-driver.py login (user runs interactively)
Research activation + submit	python3 scripts/pw-driver.py start-research --prompt-file=<path>
Plan capture	python3 scripts/pw-driver.py wait-plan --timeout=120
Plan approval	python3 scripts/pw-driver.py approve-plan
Plan revision	python3 scripts/pw-driver.py revise-plan --text-file=<path> (or --text=<str>)
Research monitoring	python3 scripts/pw-driver.py wait-complete --timeout=5400
Report extraction	python3 scripts/pw-driver.py extract --output=<path>
Session close	python3 scripts/pw-driver.py close

Exit codes: 0 success · 10 login required · 20 timeout · 30 extraction failure · 40 DOM mismatch.

DOM Reference (verified March 2026)

• Report container: div.markdown.markdown-main-panel (select largest by text length)
• Prompt input: textbox "Enter a prompt for Gemini"
• Deep Research toggle: button "Deselect Deep research" (X on chip)
• Model picker: button "Open mode picker"
• Completion text: "I've completed your research. Feel free to ask me follow-up questions or request changes."

These selectors may change as Google updates Gemini's UI.

Platform Quirks

• Clarifying forms: Gemini may show refinement questions (checkboxes, dropdowns) before research. Handle autonomously based on the research prompt context. Only escalate genuinely ambiguous questions.
• Pro model selection: Always select Pro for best results. If already selected, dismiss picker.
• Report panel: Opens on the right side after completion. If not visible, look for the report link card in chat and click it.
• Research activation: 4-step sequence — Tools button → Deep Research item → model picker → Pro model.