oh-my-claude-sisyphus

Name: oh-my-claude-sisyphus
Author: Yeachan-Heo

Warning

Sisyphus from OmO (Oh My Opencode), ported to the Claude Code SDK. Written with Claude Code — ironically. Anthropic, what are you gonna do next?

1,413stars

131forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/Yeachan-Heo/oh-my-claude-sisyphus

Getting Started

Guides for using ai agents skills like oh-my-claude-sisyphus.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 4/28/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@hono/node-server: @hono/node-server: Middleware bypass via repeated slashes in serveStatic",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "hono: Hono missing validation of cookie name on write path in setCookie()",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-04-28T06:29:50.895Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is oh-my-claude-sisyphus?

oh-my-claude-sisyphus is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Yeachan-Heo. Sisyphus from OmO (Oh My Opencode), ported to the Claude Code SDK. Written with Claude Code — ironically. Anthropic, what are you gonna do next?. It has 1,413 GitHub stars.

Is oh-my-claude-sisyphus safe to use?

oh-my-claude-sisyphus returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install oh-my-claude-sisyphus?

Clone the repository with "git clone https://github.com/Yeachan-Heo/oh-my-claude-sisyphus" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is oh-my-claude-sisyphus written in?

oh-my-claude-sisyphus is primarily written in TypeScript. It is open-source under Yeachan-Heo on GitHub, so you can review or fork the full source.

Are there alternatives to oh-my-claude-sisyphus?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh oh-my-claude-sisyphus against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-pilot open-codex-computer-use

🚀 v2.6.0 - Claude Code Native Multi-Agent Orchestration

Multi-agent orchestration system for Claude Code

Like Sisyphus, these agents persist until every task is complete.

Install • Usage • Agents • Architecture • Website

⚡ NEW in 2.6: Compaction-Resilient Memory & Structured Task Tracking

Game-changing release: Claude never forgets critical project knowledge, even through context compaction.

🧠 Three-Tier Memory System

The Problem: Long sessions lose context through compaction. Critical discoveries vanish.

The Solution: Persistent notepad system that survives compaction:

Tier	Purpose	Retention
Priority Context	Critical discoveries (API URLs, key files)	Always loaded on session start
Working Memory	Session notes with timestamps	Auto-pruned after 7 days
MANUAL	User permanent notes	Never pruned

# Agents can persist discoveries automatically
<remember>Project uses pnpm not npm</remember>
<remember priority>API client at src/api/client.ts</remember>

# Or save notes manually
/note Database schema uses PostgreSQL with Prisma ORM

📋 Ralph Loop PRD Support

Structured task tracking inspired by Ralph:

Product Requirements Document (PRD) format with user stories
Progress tracking with learnings and patterns
Completion guarantee - loop continues until ALL stories pass
Three powerful modes:
- /ralph-loop - Self-referential loop until completion
- /ultrawork-ralph - Maximum intensity + completion guarantee
- /ultraqa - Autonomous test-verify-fix cycles

# Initialize a structured task
/ralph-init implement user authentication with OAuth

# Maximum intensity with completion guarantee
/ultrawork-ralph refactor the entire API layer

# Autonomous QA cycling
/ultraqa all tests must pass with 90%+ coverage

See CHANGELOG.md for full details.

The Saga

Day 0: oh-my-opencode was born. A multi-agent orchestration system. Beautiful. Powerful. Perhaps too powerful.

Day ???: THE BANNING. They pulled the plug. They thought it was over.

Day ??? + 1: RESURRECTION. From the ashes rose oh-my-claude-sisyphus. Twelve agents. One mission.

Today: The boulder rolls. The agents orchestrate. The chaos continues.

Inspired by oh-my-opencode.

Quick Install

Choose ONE installation method below. Do not mix methods.

Option A: Claude Code Plugin (Recommended)

# In Claude Code, run:
/plugin marketplace add Yeachan-Heo/oh-my-claude-sisyphus 
/plugin install oh-my-claude-sisyphus

Uses Node.js hooks from the plugin directory. Integrates directly with Claude Code's plugin system.

Option B: Curl One-Liner (Deprecated)

curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/scripts/install.sh | bash

Deprecated: This method installs bash hooks to ~/.claude/ which can conflict with plugin installations. Use the plugin method above instead.

Option C: Via npm (Windows & Cross-Platform)

npm install -g oh-my-claude-sisyphus

Windows Users: This is the recommended installation method. Requires Node.js 20+.

Important: Plugin install and curl install are mutually exclusive. Using both will cause hook conflicts. Choose one method only.

Manual Install (macOS/Linux)

git clone https://github.com/Yeachan-Heo/oh-my-claude-sisyphus.git
cd oh-my-claude-sisyphus
chmod +x scripts/install.sh
./scripts/install.sh

🎯 Configuration: Choose Global or Project Scope

After ANY installation method, choose how you want to configure Sisyphus:

Option A: Project-Scoped (Recommended)

Configure Sisyphus for the current project only:

/sisyphus-default

Creates ./.claude/CLAUDE.md in your current project
Configuration applies only to this project
Won't affect other projects or global settings
Safe: Preserves your global CLAUDE.md

Option B: Global Configuration

Configure Sisyphus for all Claude Code sessions:

/sisyphus-default-global

Creates ~/.claude/CLAUDE.md globally
Configuration applies to all projects
Warning: Completely overwrites existing ~/.claude/CLAUDE.md

Why This Matters

Without running one of these commands, Claude operates with basic capabilities. Running either enables:

Feature	Without	With Sisyphus Config
Agent delegation	Manual only	Automatic based on task
Keyword detection	Disabled	ultrawork, search, analyze
Todo continuation	Basic	Enforced completion
Model routing	Default	Smart tier selection
Skill composition	None	Auto-combines skills

What These Commands Do

✅ Download latest CLAUDE.md with full Sisyphus orchestration prompt
✅ Configure 19 agents with intelligent model routing
✅ Enable magic keyword detection (ultrawork, search, analyze)
✅ Activate continuation enforcement (tasks complete before stopping)
✅ Set up skill composition (sisyphus + ultrawork + git-master, etc.)

When to Run Them

First time: Run after installation (choose project or global)
After updates: Re-run to get the latest configuration
Different machines: Run on each machine where you use Claude Code
New projects: Run /sisyphus-default in each project that needs Sisyphus

Configuration Precedence

If both configurations exist, project-scoped takes precedence over global:

./.claude/CLAUDE.md  (project)   →  Overrides  →  ~/.claude/CLAUDE.md  (global)

NOTE: After updating the plugin (via npm update, git pull, or Claude Code's plugin update), you MUST re-run /sisyphus-default or /sisyphus-default-global to apply the latest CLAUDE.md changes. The plugin update does NOT automatically update your CLAUDE.md files.

What Gets Installed

Plugin Structure (Claude Code Plugin Format)

The repository is also a Claude Code plugin with this structure:

oh-my-claude-sisyphus/
├── .claude-plugin/
│   └── plugin.json            # Plugin manifest
├── agents/                    # 12 specialized subagents
├── commands/                  # 12 slash commands
├── skills/                    # 4 skills (ultrawork, deepinit, git-master, frontend-ui-ux)
├── hooks/
│   └── hooks.json             # Hook configuration
└── scripts/                   # Hook scripts

Traditional Installation Structure

The installer adds to your Claude Code config (~/.claude/):

~/.claude/
├── agents/
│   ├── oracle.md              # Architecture & debugging expert (Opus)
│   ├── librarian.md           # Documentation & research (Sonnet)
│   ├── explore.md             # Fast pattern matching (Haiku)
│   ├── frontend-engineer.md   # UI/UX specialist (Sonnet)
│   ├── document-writer.md     # Technical writing (Haiku)
│   ├── multimodal-looker.md   # Visual analysis (Sonnet)
│   ├── momus.md               # Plan reviewer (Opus)
│   ├── metis.md               # Pre-planning consultant (Opus)
│   ├── sisyphus-junior.md     # Focused executor (Sonnet)
│   ├── prometheus.md          # Strategic planner