repo-research

June 7, 2026 · View on GitHub

Usage:

$ repo-research [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • diagnostics: Diagnose issues with the setup
  • pulse: Analyze activity of user's starred...
  • topics: Search for repositories related to...
  • hotspots: Analyze maintenance hotspots in a repository
  • history: List recent conversation history
  • show: Display full conversation transcript
  • chat: Start a new interactive chat session
  • resume: Resume an existing conversation interactively
  • ui: Launch the Gradio web UI

repo-research diagnostics

Diagnose issues with the setup

Usage:

$ repo-research diagnostics [OPTIONS]

Options:

  • --model-name TEXT: Override the model name for this command
  • --thread-id TEXT: Resume conversation with this thread ID
  • --help: Show this message and exit.

repo-research pulse

Analyze activity of user's starred repositories

Usage:

$ repo-research pulse [OPTIONS]

Options:

  • -s, --sort [created|updated]: Sort starred repositories by: created or updated [default: updated]
  • -d, --direction [asc|desc]: Sort direction: asc or desc [default: desc]
  • -l, --limit INTEGER RANGE: Maximum number of starred repositories to analyze (1-100) [default: 50; 1<=x<=100]
  • --model-name TEXT: Override the model name for this command
  • --thread-id TEXT: Resume conversation with this thread ID
  • --help: Show this message and exit.

repo-research topics

Search for repositories related to specific topics/with specific labels

Usage:

$ repo-research topics [OPTIONS] TOPICS_RAW

Arguments:

  • TOPICS_RAW: [required]

Options:

  • -s, --sort [created|updated]: Sort results by: stars, forks, or updated [default: updated]
  • -l, --limit INTEGER RANGE: Maximum number of results to return (1-100) [default: 25; 1<=x<=100]
  • --language TEXT: Filter by programming language (e.g., 'python', 'rust')
  • --license TEXT: Filter by license type (e.g., 'mit', 'apache-2.0', 'gpl-3.0')
  • --min-stars INTEGER RANGE: Minimum number of stars [default: 25; x>=0]
  • --max-stars INTEGER RANGE: Maximum number of stars [x>=0]
  • -d, --pushed-within-days INTEGER RANGE: Only repos pushed within last N days (1-365) [1<=x<=365]
  • --archived: Filter by archived status (true=only archived, false=exclude archived)
  • --fork: Filter by fork status (true=only forks, false=exclude forks)
  • --model-name TEXT: Override the model name for this command
  • --thread-id TEXT: Resume conversation with this thread ID
  • --help: Show this message and exit.

repo-research hotspots

Analyze maintenance hotspots in a repository

Usage:

$ repo-research hotspots [OPTIONS] REPO

Arguments:

  • REPO: [required]

Options:

  • -d, --days INTEGER RANGE: Number of days of history to analyze (1-365) [default: 90; 1<=x<=365]
  • -c, --max-commits INTEGER RANGE: Maximum number of commits to analyze (1-1000) [default: 200; 1<=x<=1000]
  • -m, --min-changes INTEGER RANGE: Minimum changes required for a file to be a hotspot (≥1) [default: 3; x>=1]
  • -p, --path TEXT: Focus analysis on specific path (e.g., 'src/integrations')
  • --model-name TEXT: Override the model name for this command
  • --thread-id TEXT: Resume conversation with this thread ID
  • --export-md: Export analysis to markdown file in ./outputs/ directory
  • --help: Show this message and exit.

repo-research history

List recent conversation history

Usage:

$ repo-research history [OPTIONS]

Options:

  • -n, --limit INTEGER: Number of conversations to show [default: 20]
  • --help: Show this message and exit.

repo-research show

Display full conversation transcript

Usage:

$ repo-research show [OPTIONS] THREAD_ID

Arguments:

  • THREAD_ID: [required]

Options:

  • --help: Show this message and exit.

repo-research chat

Start a new interactive chat session

Usage:

$ repo-research chat [OPTIONS]

Options:

  • --model-name TEXT: Override the model name for this command
  • --help: Show this message and exit.

repo-research resume

Resume an existing conversation interactively

Usage:

$ repo-research resume [OPTIONS] [THREAD_ID]

Arguments:

  • [THREAD_ID]: Thread ID to resume (omit to use --last)

Options:

  • --last: Resume the most recent conversation
  • --model-name TEXT: Override the model name for this command
  • --help: Show this message and exit.

repo-research ui

Launch the Gradio web UI

Usage:

$ repo-research ui [OPTIONS]

Options:

  • --share: Create a public share link
  • --host TEXT: Server hostname/IP address [default: 127.0.0.1]
  • --port INTEGER: Server port number [default: 7860]
  • --help: Show this message and exit.