Quick Start

What You Install

This product is split across two repos:

• Product runtime: ~/Claude/Harness/omr
• Public docs site: ~/Claude/arch-site

Only the product runtime is required to run research automation.

New Machine Setup

Prerequisites:

• Claude Code
• Node.js 20+
• Git
• tmux
• Optional: codex and gemini CLIs for external workers

Recommended workspace layout:

~/Claude/Harness/
  omr/        # product repo
  shared/     # private infra/config
  <projects>/ # research project directories

Install:

mkdir -p ~/Claude/Harness
cd ~/Claude/Harness
git clone git@github.com:JingxuanKang/ohmyresearch.git omr
cd ~/Claude/Harness/omr
./install.sh

After install:

1. Restart Claude Code.
2. Open Claude Code in ~/Claude/Harness.
3. Run omr setup once if you want to refresh hooks, agents, and skills explicitly.

Verification:

which omr
omr --help
cd ~ && omr --help   # should fail outside Harness

Core Commands

Inside Claude Code, the research product revolves around these commands:

Command	Purpose
/research init <name> <description>	Create a research project in the current directory
/research status	Show current stage and gate configuration
``/research gate <stage> <human	auto
autopilot	Advance between research stages automatically
ralph	Loop inside the current stage until completion criteria are met
ultrawork	Run independent research tasks in parallel
/handoff	Write a resumable handoff file for the next session

Gate Types

The runtime gate model is now:

Gate	Meaning
human	Pause for explicit user approval
auto	Continue automatically
default	Use the repo's per-stage default policy

Recommended defaults:

• ideation: human
• baseline-digestion: auto
• design: human
• implementation: default
• training: default
• analysis: human
• writing: human
• review: human

Typical Flow

1. /research init
2. describe research direction
3. run autopilot
4. review outputs at human gates
5. use ralph or ultrawork when needed inside a stage
6. use /handoff before ending the session

Update

cd ~/Claude/Harness/omr
git pull --ff-only origin main
npm install
npm run build
omr update-reconcile

Next

• Research State
• Commands & Interaction
• Pipeline Overview