junjiezhou1122/ideascientist-claude-code

README preview

# IdeaScientist for Claude Code, Codex and Pi

Give a research problem to the entry point for your coding agent:

| Runtime | Start a run |
|---|---|
| Claude Code | `/ideascientist:ideate <research problem>` |
| Codex | `$ideascientist:ideascientist-ideate <research problem>` |
| Pi | `/ideascientist <research problem>` |

Start with a research problem. The plugin automatically searches for methodological gaps, reads supporting papers, transfers a mechanism across research settings, challenges and revises the candidate, and develops a surviving idea into a complete falsifiable proposal. One command coordinates the workflow, subject to available evidence and finite budgets.

This is an independent native translation/adaptation for Claude Code, Codex and Pi of the research methodology in [IdeaScientist: Orchestrating Agents for Grounded Scientific Ideation](https://github.com/jiarui-liu/IdeaScientist). Original work by the IdeaScientist authors. This is not an official upstream distribution.

The output is a research proposal with traceable paper evidence, explicit assumptions, an evaluation plan, and conditions that would falsify its predictions. The plugin does not run experiments, train models, or implement research code.

## Install the plugin

Use a current Claude Code version with nested subagent support. The native design was tested with Claude Code **2.1.287**. All seven agents use `model: inherit` and your existing Claude Code login and model configuration. You do not need the original Python runtime, Vault database, vector services, custom model endpoints, MCP servers, or training environment. The offline checker, fixed arXiv metadata helper, and Claude Code reader's PDF acquisition helper require Python **3.10 or later** and only its standard library.

View full repository on GitHub →