Oh My Paper
A research harness for Claude Code — turn your terminal into an autonomous research lab.
中文文档
TL;DR
# In Claude Code:
/plugin marketplace add LigphiDonk/Oh-my--paper
/plugin install omp@oh-my-paper
Restart Claude Code. Run /omp:setup inside your research project, then drive the full pipeline with /omp:survey, /omp:experiment, and /omp:write. No GUI, no window-switching — everything in the terminal.
Table of Contents
Why This Exists
Claude Code is already a great coding agent. But research isn't just coding — it's literature survey, idea evaluation, experiment design, paper writing, reference checking, and a dozen other things that require domain-specific workflows.
Oh My Paper makes Claude Code research-aware by adding:
- A structured 5-stage pipeline — Survey → Ideation → Experiment → Publication → Promotion
- 5 specialized agent roles — each with isolated memory and clear responsibilities
- 34 built-in research skills — from paper search to figure generation
- Background hooks — auto-inject project context at session start, prompt role selection, track task completion
- Codex delegation — hand off parallel tasks to Codex in a separate terminal
Install it and forget about it. Your sessions get smarter. Your research gets organized.
Install
Step 1: Add the marketplace
/plugin marketplace add LigphiDonk/Oh-my--paper
Step 2: Install the plugin
/plugin install omp@oh-my-paper
Step 3: Restart Claude Code
Required for hooks to activate.
Step 4: Initialize your project
/omp:setup
This scaffolds the .pipeline/ directory and registers the SessionStart hook for your project.
Update
The most reliable way to get the latest version:
/plugin uninstall omp
/plugin install omp@oh-my-paper
/reload-plugins
Or overwrite the plugin cache directly (faster, no restart needed):
cp -r /path/to/oh-my-paper/plugins/oh-my-paper/. \
~/.claude/plugins/cache/oh-my-paper/omp/1.0.0/
# Then in Claude Code:
/reload-plugins
Install from Local Directory
git clone https://github.com/LigphiDonk/Oh-my--paper.git /tmp/oh-my-paper
# In Claude Code:
/plugin marketplace add /tmp/oh-my-paper
/plugin install omp@oh-my-paper
Slash Commands
All commands are prefixed with /omp:.
| Command | What It Does |
|---|
/omp:setup | Scaffold a new research project — creates .pipeline/, memory files, and registers the SessionStart hook |
/omp:survey | AI-assisted literature survey — search papers, build literature_bank.md |
/omp:ideate | Generate and evaluate research ideas based on survey findings |
/omp:experiment | Design experiments, write evaluation code, run on remote compute nodes |
/omp:write | Draft paper sections, generate figures and captions, manage LaTeX files |
/omp:review | Peer-review your paper or experiment results before submission |
/omp:delegate | Generate a Codex prompt for a coding/experiment task; wait for result and update project state |
/omp:plan | Review global progress, confirm next steps, update research plan |
Quick Start
/omp:setup # scaffold the project
/omp:survey # start literature survey
/omp:ideate # generate ideas from survey
/omp:experiment # design & run experiments
/omp:write # draft the paper
/omp:review # final quality gate
The Agent Team
When you open Claude Code in an Oh My Paper project, the SessionStart hook fires and Claude immediately asks which role you want to take on. Each role has isolated memory — it only reads and writes the files it needs.
