Research CLI

Stateless CLI for Gemini Deep Research via the v1alpha Interactions API.

Refer to the Instruction Manual for detailed setup and usage guides.

Installation

Quick Install (Binary)

curl -s https://raw.githubusercontent.com/rmedranollamas/research-cli/main/install.sh | sudo bash

From Source

Ensure you have uv installed, then sync the project:

uv sync

Usage

Set your GEMINI_API_KEY and run a research task:

export GEMINI_API_KEY="your-api-key"
uv run research run "Your research query here"

You can also list past research:

uv run research list

The CLI will stream the agent's reasoning (thoughts) and then display the final report in Markdown.

Agent Skill

A specification-compliant agent skill is included in skills/gemini-research/. This allows AI agents to learn how to interact with this CLI autonomously.

Development

• Linting: uv run ruff check . --fix
• Formatting: uv run ruff format .
• Type Checking: uv run ty check