co-researcher

Co-Researcher (v2.1.0)

A professional research suite for conducting rigorous academic research using specialized agents and multi-platform CLI commands. Compatible with Claude Code, Gemini CLI, OpenAI Codex, and OpenCode.

Installation

Claude Code

Option 1: Slash commands

/plugin marketplace add poemswe/co-researcher
/plugin install co-researcher

Option 2: Claude CLI

claude plugin install poemswe/co-researcher
claude plugin install co-researcher

Gemini CLI

Option 1: From GitHub

gemini extension install https://github.com/poemswe/co-researcher

Option 2: From Local Directory

cd /path/to/co-researcher
gemini extension link .

Codex

Option 1: Ask Codex (Agentic) Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.codex/INSTALL.md

Option 2: Manual Setup

# 1. Clone this repo to ~/.codex/skills/co-researcher
# 2. Add hook to ~/.codex/AGENTS.md
# 3. Run:
~/.codex/skills/co-researcher/.codex/co-researcher-codex bootstrap

See .codex/INSTALL.md for details.

OpenCode

Option 1: Ask OpenCode (Agentic) Tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.opencode/INSTALL.md

Option 2: Manual Setup

# 1. Clone this repo
# 2. Run the installer:
./.opencode/install.sh

See .opencode/INSTALL.md for details.

Native Platform Parity

The suite provides native research commands across all supported platforms:

Feature	Command (Claude)	Slash (Gemini)	Skill (Codex)
Research Project	/research	/research	$research
Methodology	/methodology	/methodology	$methodology
Critical Analysis	/analyze	/analyze	$analyze
Bibliography	/bibliography	/bibliography	$bibliography
Synthesize	/synthesize	/synthesize	$synthesize
Peer Review	/review	/review	$review
Ethical Risk	/ethics	/ethics	$ethics
Grant Proposal	/grant	/grant	$grant

Research Orchestration Engine

The /research command features intelligent agent orchestration that automatically:

• Analyzes your research question
• Selects optimal agents for your specific needs
• Creates an execution plan with clear phases
• Coordinates multi-agent workflows

Usage Modes

Interactive Mode (default - recommended):

/research "impact of social media on teenage mental health"

Review and approve the execution plan before agents run.

Auto Mode (for trusted workflows):

/research "climate change mitigation strategies" --auto

Executes the plan automatically without confirmation.

Plan-Only Mode (for review):

/research "AI ethics frameworks" --plan-only

Generates execution plan but doesn't run it.

Example Workflow

# 1. Start research with orchestration
/research "effectiveness of remote work on productivity"

# The engine will:
# - literature-reviewer: Find recent studies on remote work outcomes
# - critical-analyzer: Evaluate methodology and bias in key studies  
# - quant-analyst: Interpret effect sizes and statistical significance
# - hypothesis-explorer: Map variables (work location, productivity metrics, confounds)

# 2. Review generated plan and approve execution
# 3. Agents run in coordinated sequence
# 4. Receive integrated findings

Templates

Pre-configured agent combinations for common scenarios:

/research "topic" --template=quick        # Fast literature scan
/research "topic" --template=rigorous     # Full systematic review
/research "topic" --template=comprehensive # Deep multi-method analysis

Specialized Skills

The suite includes PhD-level research skills, each governed by Systemic Honesty principles.