oh-my-claude-sisyphus 2.6.0 → 3.0.0

package/skills/note/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: note
+description: Save notes to notepad.md for compaction resilience
+user-invocable: true
+---
+
+# Note Skill
+
+Save important context to `.omc/notepad.md` that survives conversation compaction.
+
+## Usage
+
+| Command | Action |
+|---------|--------|
+| `/note <content>` | Add to Working Memory with timestamp |
+| `/note --priority <content>` | Add to Priority Context (always loaded) |
+| `/note --manual <content>` | Add to MANUAL section (never pruned) |
+| `/note --show` | Display current notepad contents |
+| `/note --prune` | Remove entries older than 7 days |
+| `/note --clear` | Clear Working Memory (keep Priority + MANUAL) |
+
+## Sections
+
+### Priority Context (500 char limit)
+- **Always** injected on session start
+- Use for critical facts: "Project uses pnpm", "API in src/api/client.ts"
+- Keep it SHORT - this eats into your context budget
+
+### Working Memory
+- Timestamped session notes
+- Auto-pruned after 7 days
+- Good for: debugging breadcrumbs, temporary findings
+
+### MANUAL
+- Never auto-pruned
+- User-controlled permanent notes
+- Good for: team contacts, deployment info
+
+## Examples
+
+```
+/note Found auth bug in UserContext - missing useEffect dependency
+/note --priority Project uses TypeScript strict mode, all files in src/
+/note --manual Contact: api-team@company.com for backend questions
+/note --show
+/note --prune
+```
+
+## Behavior
+
+1. Creates `.omc/notepad.md` if it doesn't exist
+2. Parses the argument to determine section
+3. Appends content with timestamp (for Working Memory)
+4. Warns if Priority Context exceeds 500 chars
+5. Confirms what was saved
+
+## Integration
+
+Notepad content is automatically loaded on session start:
+- Priority Context: ALWAYS loaded
+- Working Memory: Loaded if recent entries exist
+
+This helps survive conversation compaction without losing critical context.

package/skills/omc-default/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: omc-default
+description: Configure OMC in local project (.claude/CLAUDE.md)
+user-invocable: true
+---
+
+# OMC Default (Project-Scoped)
+
+## Task: Configure OMC Default Mode (Project-Scoped)
+
+**CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your local project. DO NOT use the Write tool - use bash curl exclusively.
+
+### Step 1: Create Local .claude Directory
+
+Ensure the local project has a .claude directory:
+
+```bash
+# Create .claude directory in current project
+mkdir -p .claude && echo "✅ .claude directory created" || echo "❌ Failed to create .claude directory"
+```
+
+### Step 2: Download Fresh CLAUDE.md (MANDATORY)
+
+Execute this bash command to download fresh CLAUDE.md to local project config:
+
+```bash
+# Download fresh CLAUDE.md to project-local .claude/
+curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
+echo "✅ CLAUDE.md downloaded successfully to .claude/CLAUDE.md" || \
+echo "❌ Failed to download CLAUDE.md"
+```
+
+**Note**: The downloaded CLAUDE.md includes Context Persistence instructions with `<remember>` tags for surviving conversation compaction.
+
+**MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
+
+**FALLBACK** if curl fails:
+Tell user to manually download from:
+https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md
+
+### Step 3: Verify Plugin Installation
+
+The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
+
+```bash
+grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
+```
+
+If plugin is not enabled, instruct user:
+> Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
+
+### Step 4: Confirm Success
+
+After completing all steps, report:
+
+✅ **OMC Project Configuration Complete**
+- CLAUDE.md: Updated with latest configuration from GitHub at ./.claude/CLAUDE.md
+- Scope: **PROJECT** - applies only to this project
+- Hooks: Provided by plugin (no manual installation needed)
+- Agents: 19+ available (base + tiered variants)
+- Model routing: Haiku/Sonnet/Opus based on task complexity
+
+**Note**: This configuration is project-specific and won't affect other projects or global settings.
+
+---
+
+## Keeping Up to Date
+
+After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default` again in your project to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.
+
+---
+
+## Global vs Project Configuration
+
+- **`/omc-default`** (this command): Creates `./.claude/CLAUDE.md` in your current project
+- **`/omc-default-global`**: Creates `~/.claude/CLAUDE.md` for all projects
+
+Project-scoped configuration takes precedence over global configuration.

package/skills/omc-default-global/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: omc-default-global
+description: Configure OMC globally in ~/.claude/CLAUDE.md
+user-invocable: true
+---
+
+# OMC Default Global
+
+## Task: Configure OMC Default Mode (Global)
+
+**CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your global config. DO NOT use the Write tool - use bash curl exclusively.
+
+### Step 1: Download Fresh CLAUDE.md (MANDATORY)
+
+Execute this bash command to erase and download fresh CLAUDE.md to global config:
+
+```bash
+# Remove existing CLAUDE.md and download fresh from GitHub
+rm -f ~/.claude/CLAUDE.md && \
+curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
+echo "✅ CLAUDE.md downloaded successfully to ~/.claude/CLAUDE.md" || \
+echo "❌ Failed to download CLAUDE.md"
+```
+
+**MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
+
+**FALLBACK** if curl fails:
+Tell user to manually download from:
+https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md
+
+### Step 2: Clean Up Legacy Hooks (if present)
+
+Check if old manual hooks exist and remove them to prevent duplicates:
+
+```bash
+# Remove legacy bash hook scripts (now handled by plugin system)
+rm -f ~/.claude/hooks/keyword-detector.sh
+rm -f ~/.claude/hooks/stop-continuation.sh
+rm -f ~/.claude/hooks/persistent-mode.sh
+rm -f ~/.claude/hooks/session-start.sh
+```
+
+Check `~/.claude/settings.json` for manual hook entries. If the "hooks" key exists with UserPromptSubmit, Stop, or SessionStart entries pointing to bash scripts, inform the user:
+
+> **Note**: Found legacy hooks in settings.json. These should be removed since the plugin now provides hooks automatically. Remove the "hooks" section from ~/.claude/settings.json to prevent duplicate hook execution.
+
+### Step 3: Verify Plugin Installation
+
+The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
+
+```bash
+grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
+```
+
+If plugin is not enabled, instruct user:
+> Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
+
+### Step 4: Confirm Success
+
+After completing all steps, report:
+
+✅ **OMC Global Configuration Complete**
+- CLAUDE.md: Updated with latest configuration from GitHub at ~/.claude/CLAUDE.md
+- Scope: **GLOBAL** - applies to all Claude Code sessions
+- Hooks: Provided by plugin (no manual installation needed)
+- Agents: 19+ available (base + tiered variants)
+- Model routing: Haiku/Sonnet/Opus based on task complexity
+
+**Note**: Hooks are now managed by the plugin system automatically. No manual hook installation required.
+
+---
+
+## Keeping Up to Date
+
+After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default-global` again to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.

package/skills/omc-setup/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: omc-setup
+description: One-time setup for oh-my-claudecode (the ONLY command you need to learn)
+user-invocable: true
+---
+
+# OMC Setup
+
+This is the **only command you need to learn**. After running this, everything else is automatic.
+
+## Step 1: Ask User Preference
+
+Use the AskUserQuestion tool to prompt the user:
+
+**Question:** "Where should I configure oh-my-claudecode?"
+
+**Options:**
+1. **Local (this project)** - Creates `.claude/CLAUDE.md` in current project directory. Best for project-specific configurations.
+2. **Global (all projects)** - Creates `~/.claude/CLAUDE.md` for all Claude Code sessions. Best for consistent behavior everywhere.
+
+## Step 2: Execute Based on Choice
+
+### If User Chooses LOCAL:
+
+```bash
+# Create .claude directory in current project
+mkdir -p .claude
+
+# Download fresh CLAUDE.md from GitHub
+curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
+echo "Downloaded CLAUDE.md to .claude/CLAUDE.md"
+```
+
+### If User Chooses GLOBAL:
+
+```bash
+# Download fresh CLAUDE.md to global config
+curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
+echo "Downloaded CLAUDE.md to ~/.claude/CLAUDE.md"
+```
+
+## Step 3: Setup HUD Statusline
+
+The HUD shows real-time status in Claude Code's status bar. Install it by running the plugin setup script:
+
+```bash
+# Find and run plugin-setup.mjs to install HUD
+PLUGIN_SETUP=$(find ~/.claude/plugins/cache/oh-my-claudecode -name "plugin-setup.mjs" 2>/dev/null | head -1)
+if [ -z "$PLUGIN_SETUP" ]; then
+  # Try common dev paths
+  for p in ~/Workspace/oh-my-claudecode ~/Workspace/oh-my-claude-sisyphus ~/workspace/oh-my-claudecode ~/projects/oh-my-claudecode; do
+    if [ -f "$p/scripts/plugin-setup.mjs" ]; then PLUGIN_SETUP="$p/scripts/plugin-setup.mjs"; break; fi
+  done
+fi
+if [ -n "$PLUGIN_SETUP" ]; then
+  node "$PLUGIN_SETUP"
+  echo "HUD statusline installed"
+else
+  echo "Note: HUD setup script not found - HUD will work after plugin update"
+fi
+```
+
+## Step 4: Verify Plugin Installation
+
+```bash
+grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin verified" || echo "Plugin NOT found - run: claude /install-plugin oh-my-claudecode"
+```
+
+## Step 5: Detect Upgrade from 2.x
+
+Check if user has existing configuration:
+```bash
+# Check for existing 2.x artifacts
+ls ~/.claude/commands/ralph-loop.md 2>/dev/null || ls ~/.claude/commands/ultrawork.md 2>/dev/null
+```
+
+If found, this is an upgrade from 2.x.
+
+## Step 6: Show Welcome Message
+
+### For New Users:
+
+```
+OMC Setup Complete!
+
+You don't need to learn any commands. I now have intelligent behaviors that activate automatically.
+
+WHAT HAPPENS AUTOMATICALLY:
+- Complex tasks -> I parallelize and delegate to specialists
+- "plan this" -> I start a planning interview
+- "don't stop until done" -> I persist until verified complete
+- "stop" or "cancel" -> I intelligently stop current operation
+
+MAGIC KEYWORDS (optional power-user shortcuts):
+Just include these words naturally in your request:
+
+| Keyword | Effect | Example |
+|---------|--------|---------|
+| ralph | Persistence mode | "ralph: fix the auth bug" |
+| ralplan | Iterative planning | "ralplan this feature" |
+| ulw | Max parallelism | "ulw refactor the API" |
+| plan | Planning interview | "plan the new endpoints" |
+
+Combine them: "ralph ulw: migrate the database"
+
+HUD STATUSLINE:
+The status bar now shows OMC state. Restart Claude Code to see it.
+
+That's it! Just use Claude Code normally.
+```
+
+### For Users Upgrading from 2.x:
+
+```
+OMC Setup Complete! (Upgraded from 2.x)
+
+GOOD NEWS: Your existing commands still work!
+- /ralph, /ultrawork, /planner, etc. all still function
+
+WHAT'S NEW in 3.0:
+You no longer NEED those commands. Everything is automatic now:
+- Just say "don't stop until done" instead of /ralph
+- Just say "fast" or "parallel" instead of /ultrawork
+- Just say "plan this" instead of /planner
+- Just say "stop" instead of /cancel-ralph
+
+MAGIC KEYWORDS (power-user shortcuts):
+| Keyword | Same as old... | Example |
+|---------|----------------|---------|
+| ralph | /ralph | "ralph: fix the bug" |
+| ralplan | /ralplan | "ralplan this feature" |
+| ulw | /ultrawork | "ulw refactor API" |
+| plan | /planner | "plan the endpoints" |
+
+HUD STATUSLINE:
+The status bar now shows OMC state. Restart Claude Code to see it.
+
+Your workflow won't break - it just got easier!
+```
+
+## Fallback
+
+If curl fails, tell user to manually download from:
+https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md