Co-Researcher (v2.0.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: From Marketplace (Recommended)

claude plugins install poemswe/co-researcher

Option 2: From Local Directory

cd /path/to/co-researcher
claude plugins link .

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:

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.

• critical-analysis: Riguous logic checking and fallacy detection
• ethics-review: IRB compliance and privacy risk assessment
• grant-writing: Funding strategy and proposal development
• hypothesis-testing: Variable mapping and experimental design
• lateral-thinking: Cross-domain analogies and first-principles reasoning
• literature-review: Systematic search and citation analysis
• multi-source-investigation: Cross-validation across diverse sources
• peer-review: Manuscript critique and methodological review
• qualitative-research: Thematic analysis and coding
• quantitative-analysis: Statistical power and effect size interpretation
• research-methodology: Design selection and validation
• research-synthesis: Narrative synthesis with uncertainty quantification
• systematic-review: PRISMA-standard systematic review guidance

Evaluation Framework

Verify agent performance with the v2.0 benchmark system:

cd evals
p

...