PluginInstalls cleanly

Research reviews with checked citations

Co-Researcher plugin

An MIT research plugin that runs literature reviews and peer reviews against OpenAlex, arXiv and Europe PMC, then checks every citation before output.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Daily work and research

What it does

Co-Researcher turns your assistant into a careful research helper. It searches real scholarly databases (OpenAlex, arXiv and Europe PMC), screens the papers, reads the open-access full texts it can get legally and writes a review.

Before it hands anything over, a checker script runs without a model. It confirms that:

  • every quote appears in its paper
  • every citation points to exactly one screened paper
  • every number in a claim appears in its quote, and each cited sentence agrees with its claim in numbers, negation and direction
  • the bibliography resolves against OpenAlex, Europe PMC and Crossref, with retracted papers flagged

When a check fails, the agent gets up to three rounds to repair it. The result is marked valid, valid with warnings, or INVALID EVIDENCE. The plugin has 15 skills (literature review, systematic review, peer review, critical analysis, grant writing and more) and three commands: /research, /analyze and /review. Other skills start when you describe the task in plain words.

Example prompts

  • "/research "remote work and productivity""
  • "Review the evidence on intermittent fasting and sleep quality. Show me the plan first."
  • "/review draft-paper.md — give me a peer review of the methods section."
  • "/analyze this article and list any logical fallacies: article.md"

How to install

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

How to use it

Restart Claude Code, then type: /research "remote work and productivity". It drafts a plan and waits for your approval before it searches.

Check it works

Run /plugin in Claude Code and check that co-researcher is installed and enabled. Start a new session and type /research — the command should appear. Add --plan-only to a small request (for example /research "remote work and productivity" --plan-only) and check that a plan comes back and nothing is searched.

Common problems

Other assistants

  • Gemini CLI: gemini extensions install https://github.com/poemswe/co-researcher (gallery line; the README writes gemini extension install, and extension is an alias in Gemini CLI). The gallery lists it with skills, commands and hooks — https://geminicli.com/extensions/
  • Codex: the README's skills-only route for other agents is npx skills add poemswe/co-researcher, which leaves out the commands and the session-start hook. The README's full Codex route has Codex fetch and follow INSTALL.md, which clones the repo and edits ~/.codex/AGENTS.md (see the risks) — https://github.com/poemswe/co-researcher/blob/main/.codex/INSTALL.md
  • OpenCode: the README has a similar "fetch and follow" route — https://github.com/poemswe/co-researcher

What to watch out for

  • A SessionStart hook runs on every start, resume, clear and compact. It only prints fixed text that tells Claude never to fabricate citations and to follow the matching Co-Researcher skill exactly (hooks/session-start.sh at commit 694b06b)
  • The skills use Bash, WebSearch and WebFetch and write review/<slug>/ and research/<slug>/ folders in your current folder, so start it in a dedicated folder. Their tools: lists are not Claude Code's allowed-tools, so the normal permission prompts still apply
  • The research scripts run through uv. scripts/setup.sh installs uv with the astral.sh script (curl | sh) if it is missing, and can save an OpenAlex API key to ~/.env in your home folder; the OpenAlex script loads that whole file
  • One optional dependency is AGPL-3.0: read_paper.py uses pymupdf4llm (with its PyMuPDF backend) for PDF text, and uv downloads it only when that script runs. The README says the AGPL terms apply if you redistribute a service built on it
  • The README's Codex route tells Codex to fetch and follow a remote INSTALL.md from the main branch. That file clones the repo and adds an <EXTREMELY_IMPORTANT> block to ~/.codex/AGENTS.md that tells Codex to run a bootstrap script RIGHT NOW in every session. Read the file yourself first, or use the skills-only route
  • The checks confirm the review says what its sources say, not that the sources are right. The README says they cannot judge meaning, so read the review as critically as any draft

Licence and author

Licence
MIT
Author
poemswe
Source code
github.com/poemswe/co-researcher

How we tested it

We installed it on an empty test computer on 31 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
31 Oct 2026
Method
Intake sandbox run on 2026-10-31 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed co-researcher@co-researcher-marketplace with the Claude Code command line.

Checked again on 31 Oct 2026

Alternatives

  • Exa MCP — fast web search and research, without the academic citation checks
  • VoltAgent research subagents — general research sub-agents for Claude Code
  • You.com Agent Skills — web search and research skills

FAQ

  • Q: Does it cost money? A: The plugin is free under MIT. OpenAlex, arXiv and Europe PMC are public. An OpenAlex API key is free and optional, but without one OpenAlex allows only a few searches a day.
  • Q: Can I trust the citations? A: The checker catches made-up, mismatched and retracted references, but the README says it cannot judge meaning, so a sentence that overstates a finding can still pass.
  • Q: Is it only for academics? A: No. Anyone who needs an evidence summary with real sources, such as a health, policy or market question, can use it.

Sources

  • github.com/poemswe/co-researcher
  • github.com/poemswe/co-researcher/tree/694b06bbf4adfdc9ca8f567c3fbbd74a18b5e26b
  • github.com/poemswe/co-researcher/blob/694b06bbf4adfdc9ca8f567c3fbbd74a18b5e26b/hooks/session-start.sh
  • github.com/poemswe/co-researcher/blob/694b06bbf4adfdc9ca8f567c3fbbd74a18b5e26b/.codex/INSTALL.md
  • github.com/poemswe/co-researcher/blob/694b06bbf4adfdc9ca8f567c3fbbd74a18b5e26b/scripts/setup.sh
  • github.com/poemswe/co-researcher/releases/tag/v2.12.0
  • geminicli.com/extensions/
  • code.claude.com/docs/en/skills