Skip to content

Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself. Hosted API + MCP: hyperresearch.ai

docs: how-it-works GIF at the top of the README (#172)

Jordan Gibbs9c16854fed2d
diff --git a/README.md b/README.md
index 7f5476a..0942b7e 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,10 @@
**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.
+<p align="center">
+ <img src="assets/how-it-works.gif" alt="hyperresearch in Claude Code: /hyperresearch splits the question, gathers 214 sources from web, OpenAlex, Crossref, SEC EDGAR, FRED and CORE into research/notes, cite-checks every claim and fixes the unsupported one, then writes the final cited report" width="780">
+</p>
+
**Don't want to run it locally?** [Hyperresearch](https://hyperresearch.ai/?utm_source=github&utm_medium=readme) is the hosted version: the same pipeline, with no Claude Code or Codex install needed.
> [!NOTE]
diff --git a/assets/how-it-works.gif b/assets/how-it-works.gif
new file mode 100644
index 0000000..fbc3ac5
Binary files /dev/null and b/assets/how-it-works.gif differ