@themuuln/pi-research

Deep research extensions for pi-coding-agent (and OMP, the Oh My Pi fork). Three commands that turn a prompt into an evidence-backed, publication-quality research run:

| Command | What it does | |---|---| | /research <query> | Deep multi-agent research with planning, parallel workers, quality checkpoints, synthesis and audit | | /research-general <query> | Same orchestrator for ANY topic — markets, health, geopolitics, consumer decisions, science, news. Source tiers, freshness and bias checks built in | | /dig <query> | Fast adaptive research — 3-4 calls (~30s) for simple facts, auto-escalates to deeper rounds or subagents when evidence is thin |

Install

pi install @themuuln/pi-research

OMP users can install the same package; it works in both runtimes.

Usage

/research compare Bun and Node.js runtime tradeoffs for CLI tools
/research-general is a carnivore diet backed by current evidence?
/dig mongolian payment sms automation
/dig --deep carbon capture tax credits
/dig --lang=mn cэрэг мэдээ

How it works

/research and /research-general

The command injects an orchestrator prompt that:

1. Boots a run directory (default ~/.omp/research/ when ~/.omp exists, otherwise ~/.pi/research/; override with PI_RESEARCH_HOME)
2. Writes a plan: complexity class, orthogonal sub-questions, source-quality bar
3. Parallel mode — when a task tool is available, spawns one subagent per sub-question in a single batch, each writing notes to notes/*.md Inline mode — without a task tool, does the searching itself and writes the same notes sequentially (same workflow, no subagents)
4. Synthesizes claims + sources, then calls the research_checkpoint / research_general_checkpoint tool — a code-enforced quality gate (min sources, avg confidence, unresolved contradictions)
5. Iterates with targeted gap-fillers up to 3 rounds, then critic pass, synthesis.md, and meta.json

/dig

1. Triage → Phase 1 (fast search, 3-4 calls)
2. Calls dig_checkpoint — the tool returns DONE / ITERATE / ESCALATE
3. DONE: synthesize. ITERATE: one more inline round. ESCALATE: spawns 1-2 read-only subagents (or, inline mode, does 3-6 more targeted searches)
4. Answers in the query's language, with evidence, caveats and exact sources

Configuration

| Env var | Default | Purpose | |---|---|---| | PI_RESEARCH_HOME | ~/.omp/research (if ~/.omp exists) else ~/.pi/research | Where run directories are created |

Requirements

• Node.js >= 20
• A pi-coding-agent-compatible runtime (pi or OMP) with web access tools configured (search, page fetch). Research quality depends on the tools the runtime exposes — the orchestrator uses whatever is available.

License

MIT