hyperresearch

Hyperresearch turns Claude Code into a deep research agent, and it's #1 on the DRACO deep research benchmark, ahead of Claude Research, ChatGPT, Gemini and Perplexity. It runs in OpenAI Codex too. A tier-adaptive 16-step pipeline takes one prompt and produces an adversarially-audited report with full source provenance. Every source it reads lands in a persistent, searchable vault, so each session starts smarter than the last.

Don't want to run it locally? Hyperresearch is the hosted version: the same pipeline, with no Claude Code or Codex install needed.

[!NOTE] New: hyperresearch runs on OpenAI Codex. One command installs the full pipeline for Codex: entry skill, step procedures, the subagent roster as Codex custom agents, and a Stop hook that keeps Codex from skipping steps. Same vault, same ship gate as on Claude Code.

pip install hyperresearch && hyperresearch install . --target codex
codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true   # then: $hyperresearch <question>

Codex support ships in the next PyPI release; until then install from GitHub with pip install git+https://github.com/jordan-gibbs/hyperresearch. Details and what differs on Codex: Codex.

See a sample report

Read a full report before you install anything. These are unedited Deep runs from the hosted version, and you don't need to log in:

• Toast vs Square vs Clover: a restaurant POS competitor analysis, built mostly from SEC filings (241 sources)
• Buying a $2M HVAC business: multiples, SBA loans and diligence (213 sources)
• Who is winning AI coding agents, October 2026 (259 sources)

These are the same kind of Deep runs that put Hyperresearch at #1 on DRACO. Method and per-task scores are on the benchmark page.

Why it wins

• 250+ sources in a single run. The premier scale profile targets 100–130 in the width sweep alone; citation chasing and gap-fill fetches more than double what actually lands in the corpus.
• Every citation is verified before the report ships. A skeptical cite-checker audits whether each cited source actually supports its sentence. Hallucinated quotes and unacknowledged retractions are hard blocks at the gate.
• Syndication doesn't count as consensus. An independence audit clusters derivative copies, so five reprints of one press release argue with the weight of one source.
• Adversarial by construction. Four critics attack every draft in parallel, and a tool-locked patcher can only apply surgical edits. It physically cannot rewrite the report.
• Eight scholarly sources, one query. hpr scholar search hits OpenAlex, Crossref, CORE, DOAB, ClinicalTrials.gov, SEC EDGAR and FRED through one client layer and returns a single list deduplicated by DOI and title. Books, trials and filings come back alongside papers, each tagged so the pipeline knows which is which. The humanities and social sciences are covered on purpose, not as an afterthought.
• Paywalled papers get read, not skimmed. A closed paper normally enters a vault as a 1,500-character abstract that the report then cites as though it had been read. Hyperresearch asks Unpaywall, Europe PMC and CORE for a legal open-access copy and stores the full text instead, even when the publisher blocks the fetch outright. Every substitution is disclosed in the note, the frontmatter, and the CLI output.
• Nothing is thrown away. Every source lands in a searchable markdown-plus-SQLite vault that your next session reuses before it fetches anything new.
• Crashed runs resume. Each run keeps a manifest; run resume picks up at the exact step where it died.
• Scales from 30 minutes to a dissertation. Bounded queries auto-route to a 5-step fast path. Opt-in dissertation runs (experimental) write 25K–80K words across chapters, from 300–450 sources.

Browse the vault by DOI, venue, citation count, retraction status, or retrieved manuscript version with scholarly metadata filters.

Install

Works in Claude Code and OpenAI Codex: same pipeline, same vault.

cd your-project
pip install hyperresearch

hyperresearch install                    # Claude Code, then: /hyperresearch <anything>
hyperresearch install . --target codex   # OpenAI Codex, then: $hyperresearch <anything>

--target all installs both side by side. Codex sessions need write access and network, see below.

Prefer a plugin or a single skill? Each route below installs one bootstrap skill, deep-research, that sets the pipeline up in the current project on first use. It still needs pip install hyperresearch.

Or just ask for deep research in plain words; the skill triggers on its description.

Python 3.11–3.14.

Power users: hyperresearch install --global makes /hyperresearch reachable from every Claude Code session anywhere, at the cost of ~15 lines in every session's system reminder. Per-project install (above) keeps unrelated CC sessions clean.

The bootstrap skill

The repo is a Claude Code plugin marketplace, a Codex plugin marketplace, and a skills.sh source, and all three ship the same skill, deep-research. It checks for the hyperresearch CLI, runs hyperresearch install for the agent it is running in (--target codex under Codex), and hands off to the pipeline. The pipeline itself still comes from the Python package.

If Claude Code does not pick up the newly installed skills and subagents, restart it in the same directory and run /hyperresearch <question>. Codex discovers skills at session start, so on first use the bootstrap reads the freshly installed entry skill directly; later sessions can start with $hyperresearch <question>.

Codex

The same pipeline runs on the OpenAI Codex CLI.

cd your-project
pip install hyperresearch && hyperresearch install . --target codex

This installs the entry skill at .agents/skills/hyperresearch/, the step procedures under .hyperresearch/codex/steps/, the subagents as custom agents in .codex/agents/, a Stop hook in .codex/hooks.json, and a short block in AGENTS.md. --target all installs the Claude Code and Codex versions side by side. --global --target codex puts the entry skill in ~/.agents/skills/ and the agents in ~/.codex/agents/.

Research needs to write files and reach the network, and Codex allows neither by default. Start the session with both enabled, then invoke the skill:

codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true
# then, in the session:
$hyperresearch <anything>

# non-interactive:
codex exec --sandbox workspace-write -c sandbox_workspace_write.network_access=true \
  --dangerously-bypass-hook-trust "\$hyperres