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

1. ✅ Download latest CLAUDE.md with full Sisyphus orchestration prompt
2. ✅ Configure 19 agents with intelligent model routing
3. ✅ Enable magic keyword detection (ultrawork, search, analyze)
4. ✅ Activate continuation enforcement (tasks complete before stopping)
5. ✅ 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