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-researcherHow 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
- The search or citation scripts fail — they run through uv; ask Claude to run the plugin's
scripts/setup.shonce, or install uv yourself (README: "Runbash scripts/setup.shonce to installuv") — https://github.com/poemswe/co-researcher - Searches stop with "Rate limit (429) without an API key" — without a key OpenAlex allows about 10 filter queries or 1 search a day; get a free key at openalex.org and run
bash scripts/setup.shin your own terminal to save it — https://github.com/poemswe/co-researcher/blob/main/skills/literature-review/SKILL.md - The review arrives marked INVALID EVIDENCE — some checks still failed after three repair rounds; ask the agent to fix the named items or check them yourself — https://github.com/poemswe/co-researcher
- A paper's full text is missing — only legal open-access routes are used, so paywalled papers are read from the abstract and the review lists that as a warning — https://github.com/poemswe/co-researcher
Other assistants
- Gemini CLI:
gemini extensions install https://github.com/poemswe/co-researcher(gallery line; the README writesgemini extension install, andextensionis 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.
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