gemini-deep-research 0.1.0__tar.gz

gemini_deep_research-0.1.0/.gitignore

@@ -0,0 +1,86 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+wheels/
+share/python-wheels/
+MANIFEST
+
+# Virtual environments
+venv/
+.venv/
+env/
+ENV/
+.env
+.env.*
+!.env.example
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Ruff / mypy caches
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+dmypy.json
+
+# uv (note: uv.lock is committed for reproducibility)
+.uv/
+
+# Jupyter / IPython
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+
+# Editors / IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*.sublime-workspace
+*.sublime-project
+
+# OS
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Claude Code local state
+.claude/
+
+# Project-local scratch
+scratch/
+tmp/
+*.log
+
+# Local config accidentally copied into repo
+.gdr/
+gdr-reports/

gemini_deep_research-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gdr contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gemini_deep_research-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: gemini-deep-research
+Version: 0.1.0
+Summary: Unofficial terminal-first client for Google's Gemini Deep Research and Deep Research Max agents (not affiliated with Google).
+Project-URL: Homepage, https://github.com/johnswyou/gemini-deep-research
+Project-URL: Repository, https://github.com/johnswyou/gemini-deep-research
+Project-URL: Issues, https://github.com/johnswyou/gemini-deep-research/issues
+Author: gdr contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,cli,deep-research,gemini,google,llm,research
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: google-genai>=1.55.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: platformdirs>=4.2.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# gdr — Gemini Deep Research CLI
+
+> **Status:** Alpha. APIs and commands may change before v1.0.
+
+> **Disclaimer:** Unofficial, community-built CLI. Not affiliated with, endorsed by, or sponsored by Google LLC. "Gemini" and "Deep Research" are trademarks of Google LLC, used here nominatively to describe the APIs this tool interacts with.
+
+A terminal-first client for Google's **Gemini Deep Research** and **Deep Research Max** agents. Run long-horizon research tasks from your shell and get cleanly organized artifacts — markdown reports, charts, citations, and a full transcript — saved to disk.
+
+`gdr` is a thin, honest wrapper over the [`google-genai`](https://github.com/googleapis/python-genai) SDK. The SDK does the work; `gdr` adds ergonomics: streaming UI, safe config/secret management, local history, a collaborative planning flow, resume-after-disconnect, and safe MCP wiring.
+
+## Why
+
+Deep Research tasks run for 5–60 minutes. Running them from a web UI means keeping a browser tab open. `gdr` decouples the task from your terminal session: start a research run, live-stream thought summaries, walk away, resume later by ID, and get artifacts on disk that fit into any downstream pipeline.
+
+## Install
+
+```bash
+# With pipx (recommended — isolated install)
+pipx install gemini-deep-research
+
+# With uv tool
+uv tool install gemini-deep-research
+
+# From source (dev)
+git clone https://github.com/johnswyou/gemini-deep-research
+cd gemini-deep-research
+uv sync --extra dev
+uv run gdr --help
+```
+
+## Quickstart
+
+```bash
+export GEMINI_API_KEY=...             # get one at https://aistudio.google.com/apikey
+
+# One-line research with the fast agent
+gdr research "Latest trends in RISC-V adoption"
+
+# Maximum-quality agent for due diligence
+gdr research --max "Competitive landscape of EV batteries"
+
+# Review and refine the agent's plan before it spends tokens
+gdr research --plan "Impact of AI on semiconductor supply chain"
+
+# Ground in your own documents
+gdr research --file ~/Downloads/10k.pdf \
+  "Compare risk factors vs our 2024 filing"
+```
+
+Each run produces a timestamped directory under `~/gdr-reports/` containing `report.md`, `sources.json`, `transcript.json`, `metadata.json`, and any generated images.
+
+## Command reference
+
+| Command | Purpose |
+| --- | --- |
+| `gdr research <query>` | Run a research task (fast agent by default, `--max` for Max) |
+| `gdr research --plan <query>` | Collaborative planning — review and refine the plan before execution |
+| `gdr status <id>` | Check the status of a running or completed task |
+| `gdr resume <id>` | Re-attach to a running task after Ctrl+C or disconnect |
+| `gdr follow-up <id> <question>` | Ask a follow-up using the previous interaction as context |
+| `gdr plan refine <id> <feedback>` | Iterate on a pending plan without executing |
+| `gdr plan approve <id>` | Approve and execute a pending plan |
+| `gdr cancel <id>` | Cancel a running task |
+| `gdr ls` | List recent interactions |
+| `gdr show <id>` | Render a saved artifact |
+| `gdr config {path,get,set,edit}` | Manage the TOML config file |
+| `gdr doctor [--fix]` | Diagnose and optionally repair your setup |
+
+Run `gdr --help` or `gdr <command> --help` for full flag reference.
+
+See [`docs/USAGE.md`](docs/USAGE.md) for long-form command documentation,
+[`docs/MCP.md`](docs/MCP.md) for MCP server integration, and
+[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) for common failure
+modes and recovery recipes. Runnable demos live in [`examples/`](examples/).
+
+## Configuration
+
+Config lives at `~/.config/gdr/config.toml`. Run `gdr doctor --fix` to scaffold it. Environment variables referenced with `env:VAR_NAME` are expanded at load time so secrets stay out of the file.
+
+```toml
+api_key = "env:GEMINI_API_KEY"
+default_agent = "deep-research-preview-04-2026"
+output_dir = "~/gdr-reports"
+auto_open = true
+confirm_max = true                  # prompt before running the Max agent
+default_tools = ["google_search", "url_context", "code_execution"]
+thinking_summaries = "auto"         # "auto" or "none"
+visualization = "auto"              # "auto" or "off"
+safe_untrusted = true               # auto-strip dangerous tools when --file/--url is used
+
+[mcp_servers.factset]
+url = "https://mcp.factset.com"
+headers.Authorization = "Bearer env:FACTSET_TOKEN"
+```
+
+## Safety
+
+Deep Research agents can read files and the public web. `gdr` ships with:
+
+- **Redaction** of MCP auth headers and API keys from `transcript.json`.
+- **Path confinement**: all artifacts land under the configured `output_dir`; slug names are sanitized.
+- **Header validation** for MCP servers (no CRLF injection, no reserved names).
+- **`--untrusted-input`** flag that disables `code_execution` and `mcp_server` tools for a run — use when grounding in attacker-controlled files or URLs.
+
+See [`docs/MCP.md`](docs/MCP.md) for the MCP security model and
+[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) for the
+`--untrusted-input` recipe.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run ruff check .
+uv run mypy src
+uv run pytest -q
+```
+
+## Roadmap
+
+Deferred to v1.1: HTML/PDF export, cost estimation, SQLite history
+backend, interactive setup wizard. See `docs/USAGE.md` for the
+currently-shipping surface.
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).
+
+## Credits
+
+Built on [Google's Gemini Interactions API](https://ai.google.dev/gemini-api/docs/interactions) and the [`google-genai`](https://github.com/googleapis/python-genai) Python SDK.

gemini_deep_research-0.1.0/README.md

@@ -0,0 +1,130 @@
+# gdr — Gemini Deep Research CLI
+
+> **Status:** Alpha. APIs and commands may change before v1.0.
+
+> **Disclaimer:** Unofficial, community-built CLI. Not affiliated with, endorsed by, or sponsored by Google LLC. "Gemini" and "Deep Research" are trademarks of Google LLC, used here nominatively to describe the APIs this tool interacts with.
+
+A terminal-first client for Google's **Gemini Deep Research** and **Deep Research Max** agents. Run long-horizon research tasks from your shell and get cleanly organized artifacts — markdown reports, charts, citations, and a full transcript — saved to disk.
+
+`gdr` is a thin, honest wrapper over the [`google-genai`](https://github.com/googleapis/python-genai) SDK. The SDK does the work; `gdr` adds ergonomics: streaming UI, safe config/secret management, local history, a collaborative planning flow, resume-after-disconnect, and safe MCP wiring.
+
+## Why
+
+Deep Research tasks run for 5–60 minutes. Running them from a web UI means keeping a browser tab open. `gdr` decouples the task from your terminal session: start a research run, live-stream thought summaries, walk away, resume later by ID, and get artifacts on disk that fit into any downstream pipeline.
+
+## Install
+
+```bash
+# With pipx (recommended — isolated install)
+pipx install gemini-deep-research
+
+# With uv tool
+uv tool install gemini-deep-research
+
+# From source (dev)
+git clone https://github.com/johnswyou/gemini-deep-research
+cd gemini-deep-research
+uv sync --extra dev
+uv run gdr --help
+```
+
+## Quickstart
+
+```bash
+export GEMINI_API_KEY=...             # get one at https://aistudio.google.com/apikey
+
+# One-line research with the fast agent
+gdr research "Latest trends in RISC-V adoption"
+
+# Maximum-quality agent for due diligence
+gdr research --max "Competitive landscape of EV batteries"
+
+# Review and refine the agent's plan before it spends tokens
+gdr research --plan "Impact of AI on semiconductor supply chain"
+
+# Ground in your own documents
+gdr research --file ~/Downloads/10k.pdf \
+  "Compare risk factors vs our 2024 filing"
+```
+
+Each run produces a timestamped directory under `~/gdr-reports/` containing `report.md`, `sources.json`, `transcript.json`, `metadata.json`, and any generated images.
+
+## Command reference
+
+| Command | Purpose |
+| --- | --- |
+| `gdr research <query>` | Run a research task (fast agent by default, `--max` for Max) |
+| `gdr research --plan <query>` | Collaborative planning — review and refine the plan before execution |
+| `gdr status <id>` | Check the status of a running or completed task |
+| `gdr resume <id>` | Re-attach to a running task after Ctrl+C or disconnect |
+| `gdr follow-up <id> <question>` | Ask a follow-up using the previous interaction as context |
+| `gdr plan refine <id> <feedback>` | Iterate on a pending plan without executing |
+| `gdr plan approve <id>` | Approve and execute a pending plan |
+| `gdr cancel <id>` | Cancel a running task |
+| `gdr ls` | List recent interactions |
+| `gdr show <id>` | Render a saved artifact |
+| `gdr config {path,get,set,edit}` | Manage the TOML config file |
+| `gdr doctor [--fix]` | Diagnose and optionally repair your setup |
+
+Run `gdr --help` or `gdr <command> --help` for full flag reference.
+
+See [`docs/USAGE.md`](docs/USAGE.md) for long-form command documentation,
+[`docs/MCP.md`](docs/MCP.md) for MCP server integration, and
+[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) for common failure
+modes and recovery recipes. Runnable demos live in [`examples/`](examples/).
+
+## Configuration
+
+Config lives at `~/.config/gdr/config.toml`. Run `gdr doctor --fix` to scaffold it. Environment variables referenced with `env:VAR_NAME` are expanded at load time so secrets stay out of the file.
+
+```toml
+api_key = "env:GEMINI_API_KEY"
+default_agent = "deep-research-preview-04-2026"
+output_dir = "~/gdr-reports"
+auto_open = true
+confirm_max = true                  # prompt before running the Max agent
+default_tools = ["google_search", "url_context", "code_execution"]
+thinking_summaries = "auto"         # "auto" or "none"
+visualization = "auto"              # "auto" or "off"
+safe_untrusted = true               # auto-strip dangerous tools when --file/--url is used
+
+[mcp_servers.factset]
+url = "https://mcp.factset.com"
+headers.Authorization = "Bearer env:FACTSET_TOKEN"
+```
+
+## Safety
+
+Deep Research agents can read files and the public web. `gdr` ships with:
+
+- **Redaction** of MCP auth headers and API keys from `transcript.json`.
+- **Path confinement**: all artifacts land under the configured `output_dir`; slug names are sanitized.
+- **Header validation** for MCP servers (no CRLF injection, no reserved names).
+- **`--untrusted-input`** flag that disables `code_execution` and `mcp_server` tools for a run — use when grounding in attacker-controlled files or URLs.
+
+See [`docs/MCP.md`](docs/MCP.md) for the MCP security model and
+[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) for the
+`--untrusted-input` recipe.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run ruff check .
+uv run mypy src
+uv run pytest -q
+```
+
+## Roadmap
+
+Deferred to v1.1: HTML/PDF export, cost estimation, SQLite history
+backend, interactive setup wizard. See `docs/USAGE.md` for the
+currently-shipping surface.
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).
+
+## Credits
+
+Built on [Google's Gemini Interactions API](https://ai.google.dev/gemini-api/docs/interactions) and the [`google-genai`](https://github.com/googleapis/python-genai) Python SDK.

gemini_deep_research-0.1.0/pyproject.toml

@@ -0,0 +1,173 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gemini-deep-research"
+version = "0.1.0"
+description = "Unofficial terminal-first client for Google's Gemini Deep Research and Deep Research Max agents (not affiliated with Google)."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "gdr contributors" }]
+keywords = ["gemini", "deep-research", "cli", "llm", "google", "ai", "research", "agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "google-genai>=1.55.0",
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "pydantic>=2.7.0",
+    "platformdirs>=4.2.0",
+    "httpx>=0.27.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "pytest-mock>=3.14",
+    "ruff>=0.6",
+    "mypy>=1.10",
+]
+
+[project.scripts]
+gdr = "gdr.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/johnswyou/gemini-deep-research"
+Repository = "https://github.com/johnswyou/gemini-deep-research"
+Issues = "https://github.com/johnswyou/gemini-deep-research/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gdr"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/gdr",
+    "tests",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+
+# ---------------------------------------------------------------------------
+# Ruff (lint + format)
+# ---------------------------------------------------------------------------
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "UP",  # pyupgrade
+    "N",   # pep8-naming
+    "RUF", # ruff-specific
+    "SIM", # flake8-simplify
+    "PTH", # flake8-use-pathlib
+    "C4",  # flake8-comprehensions
+    "PL",  # pylint
+    "TID", # flake8-tidy-imports
+]
+ignore = [
+    "E501",    # line length handled by formatter
+    "PLR0913", # too many arguments — CLI commands legitimately have many
+    "PLR2004", # magic value comparisons — readable in tests
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["PLR", "B011"]
+"src/gdr/cli.py" = ["PLC0415"]
+
+[tool.ruff.lint.flake8-bugbear]
+# Typer's idiom requires `typer.Option(...)` / `typer.Argument(...)` in
+# default values of command functions. These calls are side-effect-free
+# metadata constructors, so the bugbear B008 warning is spurious here.
+extend-immutable-calls = ["typer.Option", "typer.Argument"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+# ---------------------------------------------------------------------------
+# Mypy (strict typing)
+# ---------------------------------------------------------------------------
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+warn_return_any = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+no_implicit_optional = true
+check_untyped_defs = true
+pretty = true
+show_error_codes = true
+mypy_path = "src"
+packages = ["gdr"]
+explicit_package_bases = true
+
+[[tool.mypy.overrides]]
+module = ["google.*", "google.genai.*"]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+# `tomli` is only imported on Python 3.10; we run mypy on 3.11+.
+module = "tomli"
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+# ---------------------------------------------------------------------------
+# Pytest
+# ---------------------------------------------------------------------------
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+    "live: tests that hit the real Gemini API (requires GEMINI_API_KEY and RUN_LIVE_TESTS=1)",
+]
+
+# ---------------------------------------------------------------------------
+# Coverage
+# ---------------------------------------------------------------------------
+[tool.coverage.run]
+source = ["src/gdr"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+]

gemini_deep_research-0.1.0/src/gdr/__init__.py

@@ -0,0 +1,7 @@
+"""gdr — a terminal client for Google's Gemini Deep Research agents."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

gemini_deep_research-0.1.0/src/gdr/__main__.py

@@ -0,0 +1,13 @@
+"""Entry point for `python -m gdr`."""
+
+from __future__ import annotations
+
+from gdr.cli import app
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

gemini_deep_research-0.1.0/src/gdr/cli.py

@@ -0,0 +1,76 @@
+"""Typer app root for the gdr CLI.
+
+This module wires up the top-level application and registers subcommands.
+Subcommands live in `gdr.commands.*` and are added here as each phase lands.
+"""
+
+from __future__ import annotations
+
+import typer
+
+from gdr import __version__
+from gdr.commands import (
+    cancel,
+    doctor,
+    follow_up,
+    ls,
+    plan,
+    research,
+    resume,
+    show,
+    status,
+)
+from gdr.commands import (
+    config as config_cmd,
+)
+from gdr.constants import APP_DESCRIPTION, APP_NAME
+
+app = typer.Typer(
+    name=APP_NAME,
+    help=APP_DESCRIPTION,
+    no_args_is_help=True,
+    add_completion=True,
+    rich_markup_mode="rich",
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"{APP_NAME} {__version__}")
+        raise typer.Exit
+
+
+@app.callback()
+def main(
+    _version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show the installed gdr version and exit.",
+    ),
+) -> None:
+    """Gemini Deep Research from your terminal.
+
+    Run `gdr research <query>` to start. See `gdr --help` for the full command
+    list once more commands are registered in later phases.
+    """
+
+
+# Subcommands — each module exposes a `run` function or a Typer sub-app.
+app.command(name="research", help="Run a Deep Research task and save artifacts to disk.")(
+    research.run
+)
+app.add_typer(plan.app, name="plan")
+app.command(name="ls", help="List recent interactions from the local store.")(ls.run)
+app.command(name="show", help="Print a saved artifact from a prior research run.")(show.run)
+app.command(name="status", help="Check the current status of an interaction.")(status.run)
+app.command(name="resume", help="Reattach to a running or completed interaction.")(resume.run)
+app.command(
+    name="follow-up", help="Ask a follow-up question using a prior interaction as context."
+)(follow_up.run)
+app.command(name="cancel", help="Cancel an in-progress interaction.")(cancel.run)
+app.add_typer(config_cmd.app, name="config")
+app.command(name="doctor", help="Validate the local environment for gdr.")(doctor.run)

gemini_deep_research-0.1.0/src/gdr/commands/__init__.py

@@ -0,0 +1,5 @@
+"""Top-level CLI command implementations.
+
+Each subcommand lives in its own module (e.g. `gdr.commands.research`) and is
+registered on the Typer app in `gdr.cli`.
+"""