oh-my-paper

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
• Install
• Slash Commands
• The Agent Team
• 34 Research Skills
• Hooks
• Research Pipeline
• Project Scaffold
• How Memory Works
• Codex Delegation
• Remote Experiments
• For LLM Agents
• Philosophy
• Contributing
• Uninstall

---

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.