Oh-my--paper  by LigphiDonk

Autonomous research lab for terminal-based scientific discovery

Created 1 month ago
366 stars

Top 77.0% on SourcePulse

GitHubView on GitHub
Project Summary

A research harness for Claude Code, Oh My Paper transforms the terminal into an autonomous research lab. It addresses the gap between coding assistance and the multifaceted research workflow by integrating literature surveys, experiment design and execution, and paper writing into a single, automated pipeline. This plugin is designed for users of Claude Code, aiming to streamline research processes and enhance productivity for engineers and researchers.

How It Works

Oh My Paper introduces a structured 5-stage research pipeline (Survey, Ideation, Experiment, Publication, Promotion) managed by five specialized agent roles, each with isolated memory to prevent context pollution. Core to its design are background hooks (SessionStart, Stop, PostToolUse) that automatically inject project context and track task completion. A shared state (tasks.json, project_truth.md) ensures collaboration, with the Conductor agent auto-updating progress without manual intervention, enabling seamless session resumption and a continuously organized research state.

Quick Start & Requirements

  • Primary install: Add the marketplace (/plugin marketplace add LigphiDonk/Oh-my--paper) and install the plugin (/plugin install omp@oh-my-paper) within Claude Code. A restart of Claude Code is required for hooks to activate.
  • Prerequisites: Claude Code environment.
  • Project Setup: Run /omp:setup in your research project directory to scaffold the .pipeline/ directory and register the SessionStart hook.
  • Links: GitHub repository: https://github.com/LigphiDonk/Oh-my--paper

Highlighted Details

  • Features a 5-stage research pipeline: Survey → Ideation → Experiment → Publication → Promotion.
  • Includes 5 specialized agent roles (Conductor, Literature Scout, Experiment Driver, Paper Writer, Reviewer) with distinct memory scopes.
  • Provides 34 built-in research skills covering literature analysis, idea generation, experiment execution, paper drafting, and more.
  • Automates workflow via background hooks and agent-driven state synchronization.
  • Supports Codex delegation for parallel coding tasks and remote experiment execution.

Maintenance & Community

The project acknowledges support from the "Linux.do community." Specific details on active contributors, sponsorships, or a public roadmap are not detailed in the README.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: The MIT license permits commercial use and integration with closed-source projects. A separate Codex CLI plugin is also available, sharing skills but differing in command syntax and hook implementation.

Limitations & Caveats

This plugin is exclusively dependent on the Claude Code environment and offers no graphical user interface, operating entirely within the terminal. Activation of background hooks necessitates an initial /omp:setup command and a Claude Code restart. The Codex CLI version has distinct command naming conventions and lacks native hook support.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
3
Star History
370 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.