oh-my-claude-sisyphus 3.3.10 → 3.4.0

package/skills/ecomode/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: ecomode
+description: Token-efficient parallel execution mode using Haiku and Sonnet agents
+---
+
+# Ecomode Skill
+
+Activates token-efficient parallel execution for pro-plan users who prioritize cost efficiency.
+
+## When Activated
+
+This skill enhances Claude's capabilities by:
+
+1. **Parallel Execution**: Running multiple agents simultaneously for independent tasks
+2. **Token-Conscious Routing**: Preferring Haiku and Sonnet agents, avoiding Opus
+3. **Background Operations**: Using `run_in_background: true` for long operations
+4. **Persistence Enforcement**: Never stopping until all tasks are verified complete
+5. **Cost Optimization**: Minimizing token usage while maintaining quality
+
+## Ecomode Routing Rules (CRITICAL)
+
+**ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.**
+
+| Decision | Rule |
+|----------|------|
+| DEFAULT | Use LOW tier (Haiku) for all tasks |
+| UPGRADE | Use MEDIUM (Sonnet) only when task complexity warrants |
+| AVOID | HIGH tier (Opus) - only use for planning/critique if explicitly essential |
+
+## Smart Model Routing (PREFER LOW TIER)
+
+**Choose tier based on task complexity: LOW (haiku) preferred → MEDIUM (sonnet) fallback → HIGH (opus) AVOID**
+
+### Agent Routing Table
+
+| Domain | PREFERRED (Haiku) | FALLBACK (Sonnet) | AVOID (Opus) |
+|--------|-------------------|-------------------|--------------|
+| **Analysis** | `architect-low` | `architect-medium` | ~~`architect`~~ |
+| **Execution** | `executor-low` | `executor` | ~~`executor-high`~~ |
+| **Search** | `explore` | `explore-medium` | ~~`explore-high`~~ |
+| **Research** | `researcher-low` | `researcher` | - |
+| **Frontend** | `designer-low` | `designer` | ~~`designer-high`~~ |
+| **Docs** | `writer` | - | - |
+| **Visual** | - | `vision` | - |
+| **Planning** | - | - | `planner` (if essential) |
+| **Critique** | - | - | `critic` (if essential) |
+| **Testing** | - | `qa-tester` | ~~`qa-tester-high`~~ |
+| **Security** | `security-reviewer-low` | - | ~~`security-reviewer`~~ |
+| **Build** | `build-fixer-low` | `build-fixer` | - |
+| **TDD** | `tdd-guide-low` | `tdd-guide` | - |
+| **Code Review** | `code-reviewer-low` | - | ~~`code-reviewer`~~ |
+| **Data Science** | `scientist-low` | `scientist` | ~~`scientist-high`~~ |
+
+### Tier Selection Guide (Token-Conscious)
+
+| Task Complexity | Tier | Examples |
+|-----------------|------|----------|
+| Simple lookups | LOW | "What does this function return?", "Find where X is defined" |
+| Standard work | LOW first, MEDIUM if fails | "Add error handling", "Implement this feature" |
+| Complex analysis | MEDIUM | "Debug this issue", "Refactor this module" |
+| Planning only | HIGH (if essential) | "Design architecture for new system" |
+
+### Routing Examples
+
+**CRITICAL: Always pass `model` parameter explicitly - Claude Code does NOT auto-apply models from agent definitions!**
+
+```
+// Simple question → LOW tier (DEFAULT)
+Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="What does this function return?")
+
+// Standard implementation → TRY LOW first
+Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Add validation to login form")
+
+// If LOW fails, escalate to MEDIUM
+Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add error handling to login")
+
+// File lookup → ALWAYS LOW
+Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="Find where UserService is defined")
+
+// Only use MEDIUM for complex patterns
+Task(subagent_type="oh-my-claudecode:explore-medium", model="sonnet", prompt="Find all authentication patterns in the codebase")
+```
+
+## DELEGATION ENFORCEMENT (CRITICAL)
+
+**YOU ARE AN ORCHESTRATOR, NOT AN IMPLEMENTER.**
+
+| Action | YOU Do | DELEGATE |
+|--------|--------|----------|
+| Read files for context | ✓ | |
+| Track progress (TODO) | ✓ | |
+| Spawn parallel agents | ✓ | |
+| **ANY code change** | ✗ NEVER | executor-low/executor |
+| **UI work** | ✗ NEVER | designer-low/designer |
+| **Docs** | ✗ NEVER | writer |
+
+**Path Exception**: Only write to `.omc/`, `.claude/`, `CLAUDE.md`, `AGENTS.md`
+
+## Background Execution Rules
+
+**Run in Background** (set `run_in_background: true`):
+- Package installation: npm install, pip install, cargo build
+- Build processes: npm run build, make, tsc
+- Test suites: npm test, pytest, cargo test
+- Docker operations: docker build, docker pull
+
+**Run Blocking** (foreground):
+- Quick status checks: git status, ls, pwd
+- File reads (NOT edits - delegate edits to executor-low)
+- Simple commands
+
+## Verification Checklist
+
+Before stopping, verify:
+- [ ] TODO LIST: Zero pending/in_progress tasks
+- [ ] FUNCTIONALITY: All requested features work
+- [ ] TESTS: All tests pass (if applicable)
+- [ ] ERRORS: Zero unaddressed errors
+
+**If ANY checkbox is unchecked, CONTINUE WORKING.**
+
+## Token Savings Tips
+
+1. **Batch similar tasks** to one agent instead of spawning many
+2. **Use explore (haiku)** for file discovery, not architect
+3. **Prefer executor-low** for simple changes - only upgrade if it fails
+4. **Avoid opus agents** unless the task genuinely requires deep reasoning
+5. **Use writer (haiku)** for all documentation tasks

package/skills/frontend-ui-ux/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: frontend-ui-ux
 description: Designer-turned-developer who crafts stunning UI/UX even without design mockups
-user-invocable: true
 ---
 
 # Frontend UI/UX Skill

package/skills/git-master/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: git-master
 description: Git expert for atomic commits, rebasing, and history management with style detection
-user-invocable: true
 ---
 
 # Git Master Skill

package/skills/help/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: help
 description: Guide on using oh-my-claudecode plugin
-user-invocable: true
 ---
 
 # How OMC Works
@@ -63,4 +62,4 @@ But now you don't NEED them - everything is automatic.
 
 ---
 
-*Version: 3.0.11*
+*Version: 3.4.0*

package/skills/hud/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: hud
 description: Configure HUD display options (layout, presets, display elements)
-user-invocable: true
 role: config-writer  # DOCUMENTATION ONLY - This skill writes to ~/.claude/ paths
 scope: ~/.claude/**  # DOCUMENTATION ONLY - Allowed write scope
 ---

package/skills/learner/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: learner
 description: Extract a learned skill from the current conversation
-user-invocable: true
 ---
 
 # Learner Skill

package/skills/mcp-setup/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: mcp-setup
 description: Configure popular MCP servers for enhanced agent capabilities
-user-invocable: true
 ---
 
 # MCP Setup
@@ -66,7 +65,7 @@ Read the current `~/.claude/settings.json` and add/update the `mcpServers` secti
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@context7/mcp"]
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }
@@ -78,7 +77,7 @@ Read the current `~/.claude/settings.json` and add/update the `mcpServers` secti
   "mcpServers": {
     "exa": {
       "command": "npx",
-      "args": ["-y", "@anthropic/exa-mcp-server"],
+      "args": ["-y", "exa-mcp-server"],
       "env": {
         "EXA_API_KEY": "<user-provided-key>"
       }
@@ -93,7 +92,7 @@ Read the current `~/.claude/settings.json` and add/update the `mcpServers` secti
   "mcpServers": {
     "filesystem": {
       "command": "npx",
-      "args": ["-y", "@anthropic/mcp-server-filesystem", "<allowed-directories>"]
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "<allowed-directories>"]
     }
   }
 }
@@ -104,16 +103,18 @@ Read the current `~/.claude/settings.json` and add/update the `mcpServers` secti
 {
   "mcpServers": {
     "github": {
-      "command": "npx",
-      "args": ["-y", "@anthropic/github-mcp-server"],
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
       "env": {
-        "GITHUB_TOKEN": "<user-provided-token>"
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "<user-provided-token>"
       }
     }
   }
 }
 ```
 
+> Note: GitHub MCP requires Docker. Alternatively, configure as a remote URL: https://api.githubcopilot.com/mcp/
+
 ## Step 4: Merge Configuration
 
 When updating settings.json:

package/skills/note/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: note
 description: Save notes to notepad.md for compaction resilience
-user-invocable: true
 ---
 
 # Note Skill

package/skills/omc-default/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: omc-default
 description: Configure OMC in local project (.claude/CLAUDE.md)
-user-invocable: true
 ---
 
 # OMC Default (Project-Scoped)

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

@@ -1,7 +1,6 @@
 ---
 name: omc-default-global
 description: Configure OMC globally in ~/.claude/CLAUDE.md
-user-invocable: true
 ---
 
 # OMC Default Global

package/skills/omc-setup/SKILL.md

@@ -1,14 +1,28 @@
 ---
 name: omc-setup
-description: One-time setup for oh-my-claudecode (the ONLY command you need to learn)
-user-invocable: true
+description: Setup and configure oh-my-claudecode (the ONLY command you need to learn)
 ---
 
 # OMC Setup
 
 This is the **only command you need to learn**. After running this, everything else is automatic.
 
-## Step 1: Ask User Preference
+## Usage Modes
+
+This skill handles three scenarios:
+
+1. **Initial Setup (no flags)**: First-time installation wizard
+2. **Local Configuration (`--local`)**: Configure project-specific settings (.claude/CLAUDE.md)
+3. **Global Configuration (`--global`)**: Configure global settings (~/.claude/CLAUDE.md)
+
+## Mode Detection
+
+Check for flags in the user's invocation:
+- If `--local` flag present → Skip to Local Configuration (Step 2A)
+- If `--global` flag present → Skip to Global Configuration (Step 2B)
+- If no flags → Run Initial Setup wizard (Step 1)
+
+## Step 1: Initial Setup Wizard (Default Behavior)
 
 Use the AskUserQuestion tool to prompt the user:
 
@@ -18,14 +32,20 @@ Use the AskUserQuestion tool to prompt the user:
 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
+## Step 2A: Local Configuration (--local flag or user chose LOCAL)
+
+**CRITICAL**: This ALWAYS downloads fresh CLAUDE.md from GitHub to the local project. DO NOT use the Write tool - use bash curl exclusively.
 
-### If User Chooses LOCAL:
+### Create Local .claude Directory
 
 ```bash
 # Create .claude directory in current project
-mkdir -p .claude
+mkdir -p .claude && echo ".claude directory ready"
+```
+
+### Download Fresh CLAUDE.md
 
+```bash
 # Extract old version before download
 OLD_VERSION=$(grep -m1 "^# oh-my-claudecode" .claude/CLAUDE.md 2>/dev/null | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+' || echo "none")
 
@@ -44,7 +64,40 @@ else
 fi
 ```
 
-### If User Chooses GLOBAL:
+**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
+
+### 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"
+```
+
+### Confirm Local Configuration Success
+
+After completing local configuration, 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: 28+ 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.
+
+If `--local` flag was used, **STOP HERE**. Do not continue to HUD setup or other steps.
+
+## Step 2B: Global Configuration (--global flag or user chose GLOBAL)
+
+**CRITICAL**: This ALWAYS downloads fresh CLAUDE.md from GitHub to global config. DO NOT use the Write tool - use bash curl exclusively.
+
+### Download Fresh CLAUDE.md
 
 ```bash
 # Extract old version before download
@@ -65,6 +118,44 @@ else
 fi
 ```
 
+### 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
+echo "Legacy hooks cleaned"
+```
+
+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.
+
+### 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"
+```
+
+### Confirm Global Configuration Success
+
+After completing global configuration, 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: 28+ 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.
+
+If `--global` flag was used, **STOP HERE**. Do not continue to HUD setup or other steps.
+
 ## Step 3: Setup HUD Statusline
 
 The HUD shows real-time status in Claude Code's status bar. **Invoke the hud skill** to set up and configure:
@@ -145,6 +236,36 @@ elif [ -n "$LATEST_VERSION" ]; then
 fi
 ```
 
+## Step 3.7: Set Default Execution Mode
+
+Use the AskUserQuestion tool to prompt the user:
+
+**Question:** "Which parallel execution mode should be your default when you say 'fast' or 'parallel'?"
+
+**Options:**
+1. **ultrawork (maximum capability)** - Uses all agent tiers including Opus for complex tasks. Best for challenging work where quality matters most. (Recommended)
+2. **ecomode (token efficient)** - Prefers Haiku/Sonnet agents, avoids Opus. Best for pro-plan users who want cost efficiency.
+
+Store the preference in `~/.claude/.omc-config.json`:
+
+```bash
+# Read existing config or create empty object
+CONFIG_FILE="$HOME/.claude/.omc-config.json"
+mkdir -p "$(dirname "$CONFIG_FILE")"
+
+if [ -f "$CONFIG_FILE" ]; then
+  EXISTING=$(cat "$CONFIG_FILE")
+else
+  EXISTING='{}'
+fi
+
+# Set defaultExecutionMode (replace USER_CHOICE with "ultrawork" or "ecomode")
+echo "$EXISTING" | jq --arg mode "USER_CHOICE" '. + {defaultExecutionMode: $mode, configuredAt: (now | todate)}' > "$CONFIG_FILE"
+echo "Default execution mode set to: USER_CHOICE"
+```
+
+**Note**: This preference ONLY affects generic keywords ("fast", "parallel"). Explicit keywords ("ulw", "eco") always override this preference.
+
 ## Step 4: Verify Plugin Installation
 
 ```bash
@@ -197,6 +318,7 @@ Just include these words naturally in your request:
 | ralph | Persistence mode | "ralph: fix the auth bug" |
 | ralplan | Iterative planning | "ralplan this feature" |
 | ulw | Max parallelism | "ulw refactor the API" |
+| eco | Token-efficient mode | "eco refactor the API" |
 | plan | Planning interview | "plan the new endpoints" |
 
 Combine them: "ralph ulw: migrate the database"
@@ -231,6 +353,7 @@ MAGIC KEYWORDS (power-user shortcuts):
 | ralph | /ralph | "ralph: fix the bug" |
 | ralplan | /ralplan | "ralplan this feature" |
 | ulw | /ultrawork | "ulw refactor API" |
+| eco | (new!) | "eco fix all errors" |
 | plan | /planner | "plan the endpoints" |
 
 HUD STATUSLINE:
@@ -275,7 +398,50 @@ echo "  https://github.com/Yeachan-Heo/oh-my-claudecode"
 echo ""
 ```
 
-## Fallback
+## Keeping Up to Date
 
-If curl fails, tell user to manually download from:
-https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md
+After installing oh-my-claudecode updates (via npm or plugin update), run:
+- `/oh-my-claudecode:omc-setup --local` to update project config
+- `/oh-my-claudecode:omc-setup --global` to update global config
+
+This ensures you have the newest features and agent configurations.
+
+## Help Text
+
+When user runs `/oh-my-claudecode:omc-setup --help` or just `--help`, display:
+
+```
+OMC Setup - Configure oh-my-claudecode
+
+USAGE:
+  /oh-my-claudecode:omc-setup           Run initial setup wizard
+  /oh-my-claudecode:omc-setup --local   Configure local project (.claude/CLAUDE.md)
+  /oh-my-claudecode:omc-setup --global  Configure global settings (~/.claude/CLAUDE.md)
+  /oh-my-claudecode:omc-setup --help    Show this help
+
+MODES:
+  Initial Setup (no flags)
+    - Interactive wizard for first-time setup
+    - Configures CLAUDE.md (local or global)
+    - Sets up HUD statusline
+    - Checks for updates
+    - Offers MCP server configuration
+
+  Local Configuration (--local)
+    - Downloads fresh CLAUDE.md to ./.claude/
+    - Project-specific settings
+    - Use this to update project config after OMC upgrades
+
+  Global Configuration (--global)
+    - Downloads fresh CLAUDE.md to ~/.claude/
+    - Applies to all Claude Code sessions
+    - Cleans up legacy hooks
+    - Use this to update global config after OMC upgrades
+
+EXAMPLES:
+  /oh-my-claudecode:omc-setup           # First time setup
+  /oh-my-claudecode:omc-setup --local   # Update this project
+  /oh-my-claudecode:omc-setup --global  # Update all projects
+
+For more info: https://github.com/Yeachan-Heo/oh-my-claudecode
+```

package/skills/orchestrate/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: orchestrate
 description: Activate multi-agent orchestration mode
-user-invocable: true
 ---
 
 # Orchestrate Skill