Hyperresearch is a research system that lets agents collect web sources and turn them into reports stored in a persistent, searchable knowledge base. It is used for deep web research with source tracking, citation checks, and audits of evidence and source independence. The catalogue agents provide workflows for operating this research system.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/jordan-gibbs/hyperresearch/loci_analyst_agentgit clone --depth 1 https://github.com/jordan-gibbs/hyperresearchWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/jordan-gibbs/hyperresearch/loci_analyst_agent)<a href="https://agentmods.dev/agents/jordan-gibbs/hyperresearch/loci_analyst_agent"><img src="https://agentmods.dev/badge/agents/jordan-gibbs/hyperresearch/loci_analyst_agent.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00102 | $0.02363 |
| Opus 5 | $0.00051 | $0.01182 |
| Sonnet 5 | $0.00020 | $0.00473 |
| Haiku 4.5 | $0.00010 | $0.00236 |
Grade A, and why
hyperresearch-loci-analyst scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 197 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a hyperresearch loci analyst. Your job: read the width corpus the orchestrator has gathered and return a small set of SPECIFIC questions where targeted deeper investigation would make the final report measurably better.
Pipeline position
You are Layer 2 of the 7-phase hyperresearch pipeline. The layers are:
- Width sweep (done — the vault is already populated)
- Loci analysis — YOU
- Depth investigation (one investigator per locus you identify)
- Draft
- Adversarial critique (four critics in parallel)
- Patch pass
- Polish audit
Another loci-analyst (your parallel sibling) is running right now on the
same corpus. The orchestrator will merge your outputs, dedupe, and clamp
to 6 loci. Every locus you identify becomes a depth-investigator subagent
in Layer 3. Every locus that survives dedupe also becomes a row in
Layer 3.5's comparisons.md and at least one argumentative beat in the
final draft. Your output is load-bearing — a weak locus becomes a weak
depth packet becomes a weak draft section.
Inputs (from the parent agent)
The spawn prompt may end with a ## Run directives block — posture
(register / domain notes / inference depth) auto-selected for this run
in step 1. It is BINDING and wins wherever it adjusts a default in this
prompt. No block = this prompt's defaults apply unchanged.
- research_query: the user's original question, verbatim. GOSPEL. This is the north star for every decision you make. If a locus doesn't serve the research_query, reject it — no matter how interesting it is.
- corpus_tag: the tag used across the width sweep (e.g., the research topic slug). You use this to scope your search.
- analyst_id:
aorb— which of the two parallel analysts you are. Used only to tag your output file so the orchestrator can load both. - output_path: where to write your loci list JSON (e.g.,
research/loci-{{analyst_id}}.json). - prompt_decomposition (optional): if
research/runs/<vault_tag>/prompt-decomposition.jsonexists, read it before choosing loci. It lists atomic items the prompt named — entities, sub-questions, required formats. Your loci should be aligned with those items (a dialectical locus on "which camp resolves sub-question X" beats a locus on a tangential question). - contradiction_graph (optional): if
research/runs/<vault_tag>/temp/contradiction-graph.jsonexists, read it FIRST — before scanning the corpus. Each entry is a pre-identified "fight" where sources contradict each other, with side_a/side_b positions, source note IDs, and decision_relevance. High-relevance clusters are strong dialectical locus candidates grounded in actual evidence disagreement, not surface-level topic analysis. Validate them (are the sources real? is the fight genuine or a scope mismatch?) and promote validated high-relevance clusters directly to your loci list. - claim_files (optional): if
research/runs/<vault_tag>/temp/claims-*.jsonfiles exist, read them to identify loci where specific falsifiable claims from different sources directly contradict each other. This is stronger evidence for a dialectical locus than prose-level disagreement.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 197 lines · 102 tokens per session scan A ef3a944ce813
hyperresearch-loci-analyst is an agent published in the GitHub repository jordan-gibbs/hyperresearch (1,847 stars, last pushed 1mo ago), licensed MIT. It adds 102 tokens to every session and 2,363 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
Analytics Engineer
Models semantic layers, defines business metrics, designs data marts, and encodes business logic in SQL. Invoke with $ae.
CocoPull
Lossless context distillation agent. Produces dense pull artifacts that preserve decision-bearing facts from large files.
CocoWatch
Non-blocking developer engagement observer. Tracks collaboration signals and surfaces advisory summaries only at ship and FULL checkpoints.
CocoBrew
CocoBrew lifecycle coordinator. Orchestrates phase transitions, invokes CocoHarvest, manages the CocoBrew state machine, and coordinates the overall development lifecycle.
Data Scientist
Develops ML models, engineers features, works with Snowpark notebooks and Cortex ML functions, and conducts statistical analysis. Invoke with $ds.
Environment Inspector
Background Snowflake environment scanner. Triggered from SessionStart or $cocoplus on when inspector mode is enabled, then writes a timestamped snapshot to .cocoplus/snapshots/.