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. 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.

Install from the GitHub marketplace:

/plugin marketplace add junjiezhou1122/ideascientist-claude-code
/plugin install ideascientist@ideascientist-native

The equivalent terminal commands are:

claude plugin marketplace add junjiezhou1122/ideascientist-claude-code
claude plugin install ideascientist@ideascientist-native

Restart Claude Code after installation. If Claude requests permission to read bundled contracts or templates, grant Read access to the plugin files. Loading a plugin does not automatically grant filesystem access to its bundled resources. Use the actual installed path shown by Claude Code rather than a fixed cache version.

To load a local checkout, clone the published repository and start Claude Code from the research project where you want to save outputs:

git clone https://github.com/junjiezhou1122/ideascientist-claude-code.git
# Replace both paths with the absolute path to your checkout.
claude --plugin-dir /absolute/path/to/ideascientist-claude-code --add-dir /absolute/path/to/ideascientist-claude-code

--add-dir lets the agents read the bundled workflow, contracts, and artifact schema. Keep research outputs in your working project.

Install for Codex

Use Codex CLI with native plugin and multi-agent support. This adapter was loaded with 0.160.0. Install from the same Git repository:

codex plugin marketplace add junjiezhou1122/ideascientist-claude-code
codex plugin add ideascientist@ideascientist-native