oh-my-claude-sisyphus 3.3.6 → 3.3.7

package/README.md

@@ -48,13 +48,15 @@ That's it. Everything else is automatic.
 | Need research or exploration | Delegate to specialized agents |
 | Say "build me..." or use autopilot | Execute full autonomous workflow |
 
-**You don't need to learn any commands.** I detect what you need and activate the right behaviors.
+**You don't need to memorize commands.** I detect intent from natural language and activate the right behaviors automatically.
 
 ---
 
-## Magic Keywords (Power Users)
+## Magic Keywords (Optional Shortcuts)
 
-Want explicit control? Include these words anywhere in your message:
+These are **optional shortcuts** for power users who want explicit control. Natural language works just fine - these keywords simply provide precision when you want it.
+
+Include these words anywhere in your message:
 
 | Keyword | Effect |
 |---------|--------|
@@ -68,7 +70,7 @@ Want explicit control? Include these words anywhere in your message:
 
 ---
 
-## Data Analysis & Research (v3.3.4)
+## Data Analysis & Research (v3.3.7)
 
 ### Scientist Agent Tiers
 
@@ -97,17 +99,17 @@ python_repl(action="execute", researchSessionID="analysis",
             code="print(df.describe())")
 ```
 
-### /research Command (NEW)
+### /oh-my-claudecode:research Command (NEW)
 
 Orchestrate parallel scientist agents for comprehensive research workflows:
 
 ```
-/research <goal>                    # Standard research with checkpoints
-/research AUTO: <goal>              # Fully autonomous until complete
-/research status                    # Check current session
-/research resume                    # Resume interrupted session
-/research list                      # List all sessions
-/research report <session-id>       # Generate report for session
+/oh-my-claudecode:research <goal>                    # Standard research with checkpoints
+/oh-my-claudecode:research AUTO: <goal>              # Fully autonomous until complete
+/oh-my-claudecode:research status                    # Check current session
+/oh-my-claudecode:research resume                    # Resume interrupted session
+/oh-my-claudecode:research list                      # List all sessions
+/oh-my-claudecode:research report <session-id>       # Generate report for session
 ```
 
 **Research Protocol:**
@@ -136,14 +138,62 @@ I'll intelligently determine what to stop based on context.
 
 ---
 
+## MCP Server Configuration
+
+Extend Claude Code with additional tools via Model Context Protocol (MCP) servers.
+
+```
+/oh-my-claudecode:mcp-setup
+```
+
+### Supported MCP Servers
+
+| Server | Description | API Key Required |
+|--------|-------------|------------------|
+| **Context7** | Documentation and code context from popular libraries | No |
+| **Exa** | Enhanced web search (replaces built-in websearch) | Yes |
+| **Filesystem** | Extended file system access | No |
+| **GitHub** | GitHub API for issues, PRs, repos | Yes (PAT) |
+
+### Quick Setup
+
+Run the setup command and follow the prompts:
+```
+/oh-my-claudecode:mcp-setup
+```
+
+Or configure manually in `~/.claude/settings.json`:
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@context7/mcp"]
+    },
+    "exa": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/exa-mcp-server"],
+      "env": {
+        "EXA_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+After configuration, restart Claude Code for changes to take effect.
+
+---
+
 ## What's Under the Hood
 
 - **28 Specialized Agents** - architect, researcher, explore, designer, writer, vision, critic, analyst, executor, planner, qa-tester, scientist (with tier variants)
-- **30 Skills** - orchestrate, ultrawork, ralph, planner, deepsearch, deepinit, git-master, frontend-ui-ux, learner, research, and more
+- **31 Skills** - orchestrate, ultrawork, ralph, planner, deepsearch, deepinit, git-master, frontend-ui-ux, learner, research, mcp-setup, and more
+- **MCP Server Support** - Easy configuration of Context7, Exa, GitHub, and custom MCP servers
 - **Persistent Python REPL** - True variable persistence for data analysis
-- **Research Workflow** - Parallel scientist orchestration with `/research` command (new in 3.3.x)
+- **Research Workflow** - Parallel scientist orchestration with `/oh-my-claudecode:research` command (new in 3.3.x)
 - **HUD Statusline** - Real-time visualization of orchestration state
-- **Learned Skills** - Extract reusable insights from sessions with `/learner`
+- **Learned Skills** - Extract reusable insights from sessions with `/oh-my-claudecode:learner`
 - **Memory System** - Persistent context that survives compaction
 
 ---
@@ -175,9 +225,9 @@ Run `/oh-my-claudecode:hud setup` to configure display options.
 **Good news:** Your old commands still work!
 
 ```
-/ralph "task"      →  Still works (or just say "ralph: task")
-/ultrawork "task"  →  Still works (or just use "ulw" keyword)
-/planner "task"    →  Still works (or just say "plan this")
+/oh-my-claudecode:ralph "task"      →  Still works (or just say "ralph: task")
+/oh-my-claudecode:ultrawork "task"  →  Still works (or just use "ulw" keyword)
+/oh-my-claudecode:planner "task"    →  Still works (or just say "plan this")
 ```
 
 The difference? You don't *need* them anymore. Everything auto-activates.
@@ -198,7 +248,9 @@ See the [Migration Guide](docs/MIGRATION.md) for details.
 ## Requirements
 
 - [Claude Code](https://docs.anthropic.com/claude-code) CLI
-- Anthropic API key
+- One of:
+  - **Claude Max/Pro subscription** (recommended for individuals)
+  - **Anthropic API key** (for API-based usage)
 
 ---
 

package/agents/planner.md

@@ -205,7 +205,7 @@ Include:
 | **Interview Mode** | Default state | Consult, research, discuss. NO plan generation. |
 | **Pre-Generation** | "Make it into a work plan" | Summon Metis → Ask final questions |
 | **Plan Generation** | After pre-generation complete | Generate plan, optionally loop through Momus |
-| **Handoff** | Plan saved | Tell user to run `/start-work` |
+| **Handoff** | Plan saved | Tell user to run `/oh-my-claudecode:start-work` |
 
 ## Key Principles
 
@@ -213,7 +213,7 @@ Include:
 2. **Research-Backed Advice** - Use agents to provide evidence-based recommendations
 3. **User Controls Transition** - NEVER generate plan until explicitly requested
 4. **Metis Before Plan** - Always catch gaps before committing to plan
-5. **Clear Handoff** - Always end with `/start-work` instruction
+5. **Clear Handoff** - Always end with `/oh-my-claudecode:start-work` instruction
 
 ---
 
@@ -244,7 +244,7 @@ After plan is saved, display:
 **Does this plan capture your intent?**
 
 Options:
-- "proceed" or "start work" - Begin implementation via /start-work
+- "proceed" or "start work" - Begin implementation via /oh-my-claudecode:start-work
 - "adjust [X]" - Return to interview to modify specific aspect
 - "restart" - Discard plan and start fresh interview
 ```
@@ -253,7 +253,7 @@ Options:
 
 | User Response | Your Action |
 |---------------|-------------|
-| "proceed", "yes", "start", "looks good" | Tell user to run `/start-work {plan-name}` |
+| "proceed", "yes", "start", "looks good" | Tell user to run `/oh-my-claudecode:start-work {plan-name}` |
 | "adjust X", "change X", "modify X" | Return to interview mode, ask about X |
 | "restart", "start over", "no" | Discard plan, return to Phase 1 |
 | Silence or unclear | Wait. Do NOT proceed without explicit confirmation |
@@ -276,7 +276,7 @@ Planner: [Saves plan to .omc/plans/new-api.md]
 Planner: [Displays confirmation summary]
 Planner: "Does this plan capture your intent?"
 User: "looks good, proceed"
-Planner: "Great! Run `/start-work new-api` to begin implementation."
+Planner: "Great! Run `/oh-my-claudecode:start-work new-api` to begin implementation."
 ```
 
 ---
@@ -288,7 +288,7 @@ After user confirms, provide clear handoff:
 ```
 Your plan is ready for execution.
 
-Run: `/start-work {plan-name}`
+Run: `/oh-my-claudecode:start-work {plan-name}`
 
 This will:
 1. Load the plan from `.omc/plans/{plan-name}.md`
@@ -296,4 +296,4 @@ This will:
 3. Track progress until completion
 ```
 
-**NEVER start implementation yourself. ALWAYS hand off to /start-work.**
+**NEVER start implementation yourself. ALWAYS hand off to /oh-my-claudecode:start-work.**

package/agents/scientist-high.md

@@ -792,7 +792,7 @@ Before marking any stage as `[STAGE:status:success]`:
 <Promise_Tags>
 ## Research Loop Control
 
-When invoked by `/research` skill, output these tags to communicate status:
+When invoked by `/oh-my-claudecode:research` skill, output these tags to communicate status:
 
 | Tag | Meaning | When to Use |
 |-----|---------|-------------|
@@ -841,9 +841,9 @@ Created 15 new features, improved R² from 0.42 to 0.58
 Next: Test interaction terms and polynomial features
 ```
 
-### Integration with /research Skill
+### Integration with /oh-my-claudecode:research Skill
 
-The `/research` skill orchestrates multi-stage research workflows. It reads these promise tags to:
+The `/oh-my-claudecode:research` skill orchestrates multi-stage research workflows. It reads these promise tags to:
 
 1. **Route next steps**: `STAGE_COMPLETE` → proceed to next stage
 2. **Handle blockers**: `STAGE_BLOCKED` → invoke architect or escalate

package/commands/cancel-ralph.md

@@ -33,9 +33,9 @@ After running this command, you are free to stop working. The persistent mode ho
 
 ## Note on Linked Modes
 
-Since v3.0, Ralph automatically activates Ultrawork for parallel execution. When you cancel Ralph, the linked Ultrawork is also cancelled. If you started Ultrawork separately (not via Ralph), use `/cancel-ultrawork` to cancel it independently.
+Since v3.0, Ralph automatically activates Ultrawork for parallel execution. When you cancel Ralph, the linked Ultrawork is also cancelled. If you started Ultrawork separately (not via Ralph), use `/oh-my-claudecode:cancel-ultrawork` to cancel it independently.
 
 ## To Start Fresh
 
-- `/ralph "task"` - Start ralph with ultrawork (default)
-- `/ultrawork "task"` - Start ultrawork only (standalone)
+- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
+- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)

package/commands/cancel-ultraqa.md

@@ -20,8 +20,8 @@ After running this command, the QA cycling will stop.
 
 ## To Start Fresh
 
-- `/ultraqa --tests` - Run until all tests pass
-- `/ultraqa --build` - Run until build succeeds
-- `/ultraqa --lint` - Run until no lint errors
-- `/ultraqa --typecheck` - Run until no type errors
-- `/ultraqa --custom "pattern"` - Run until pattern matches
+- `/oh-my-claudecode:ultraqa --tests` - Run until all tests pass
+- `/oh-my-claudecode:ultraqa --build` - Run until build succeeds
+- `/oh-my-claudecode:ultraqa --lint` - Run until no lint errors
+- `/oh-my-claudecode:ultraqa --typecheck` - Run until no type errors
+- `/oh-my-claudecode:ultraqa --custom "pattern"` - Run until pattern matches

package/commands/cancel-ultrawork.md

@@ -16,7 +16,7 @@ The Ultrawork mode has been cancelled. Clearing state files.
 cat .omc/ultrawork-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
 ```
 
-**If linked_to_ralph is true**: Use `/cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
+**If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
 
 **Otherwise**, execute this command to cancel Ultrawork:
 
@@ -31,10 +31,10 @@ After running this command, ultrawork mode will be deactivated and the HUD will
 ## Note on Linked Modes
 
 Since v3.0, Ralph automatically activates Ultrawork. If you see `linked_to_ralph: true` in the ultrawork state, it means Ultrawork was auto-activated by Ralph. In this case:
-- Use `/cancel-ralph` to cancel both modes
+- Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
 - If you only cancel ultrawork, Ralph will continue but without parallel execution benefits
 
 ## To Start Fresh
 
-- `/ultrawork "task"` - Start ultrawork only (standalone)
-- `/ralph "task"` - Start ralph with ultrawork (default)
+- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
+- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)

package/commands/hud.md

@@ -10,12 +10,12 @@ Configure the OMC HUD (Heads-Up Display) for the statusline.
 
 | Command | Description |
 |---------|-------------|
-| `/hud` | Show current HUD status (auto-setup if needed) |
-| `/hud setup` | Install/repair HUD statusline |
-| `/hud minimal` | Switch to minimal display |
-| `/hud focused` | Switch to focused display (default) |
-| `/hud full` | Switch to full display |
-| `/hud status` | Show detailed HUD status |
+| `/oh-my-claudecode:hud` | Show current HUD status (auto-setup if needed) |
+| `/oh-my-claudecode:hud setup` | Install/repair HUD statusline |
+| `/oh-my-claudecode:hud minimal` | Switch to minimal display |
+| `/oh-my-claudecode:hud focused` | Switch to focused display (default) |
+| `/oh-my-claudecode:hud full` | Switch to full display |
+| `/oh-my-claudecode:hud status` | Show detailed HUD status |
 
 ## Auto-Setup
 
@@ -222,9 +222,9 @@ You can manually edit the config file:
 ## Troubleshooting
 
 If the HUD is not showing:
-1. Run `/hud setup` to auto-install and configure
+1. Run `/oh-my-claudecode:hud setup` to auto-install and configure
 2. Restart Claude Code after setup completes
-3. If still not working, run `/doctor` for full diagnostics
+3. If still not working, run `/oh-my-claudecode:doctor` for full diagnostics
 
 Manual verification:
 - HUD script: `~/.claude/hud/omc-hud.mjs`

package/commands/learner.md

@@ -130,5 +130,5 @@ If code helps, show it - but as illustration of the principle, not copy-paste ma
 
 ## Related Commands
 
-- /note - Save quick notes that survive compaction (less formal than skills)
-- /ralph - Start a development loop with learning capture
+- /oh-my-claudecode:note - Save quick notes that survive compaction (less formal than skills)
+- /oh-my-claudecode:ralph - Start a development loop with learning capture

package/commands/mcp-setup.md

@@ -0,0 +1,194 @@
+---
+description: Configure popular MCP servers for enhanced agent capabilities
+---
+
+# MCP Setup
+
+Configure Model Context Protocol (MCP) servers to extend Claude Code's capabilities with external tools like web search, file system access, and GitHub integration.
+
+## Overview
+
+MCP servers provide additional tools that Claude Code agents can use. This skill helps you configure popular MCP servers in your `~/.claude/settings.json`.
+
+## Step 1: Show Available MCP Servers
+
+Present the user with available MCP server options using AskUserQuestion:
+
+**Question:** "Which MCP server would you like to configure?"
+
+**Options:**
+1. **Context7** - Documentation and code context from popular libraries
+2. **Exa Web Search** - Enhanced web search (replaces built-in websearch)
+3. **Filesystem** - Extended file system access with additional capabilities
+4. **GitHub** - GitHub API integration for issues, PRs, and repository management
+5. **All of the above** - Configure all recommended MCP servers
+6. **Custom** - Add a custom MCP server
+
+## Step 2: Gather Required Information
+
+### For Context7:
+No API key required. Ready to use immediately.
+
+### For Exa Web Search:
+Ask for API key:
+```
+Do you have an Exa API key?
+- Get one at: https://exa.ai
+- Enter your API key, or type 'skip' to configure later
+```
+
+### For Filesystem:
+Ask for allowed directories:
+```
+Which directories should the filesystem MCP have access to?
+Default: Current working directory
+Enter comma-separated paths, or press Enter for default
+```
+
+### For GitHub:
+Ask for token:
+```
+Do you have a GitHub Personal Access Token?
+- Create one at: https://github.com/settings/tokens
+- Recommended scopes: repo, read:org
+- Enter your token, or type 'skip' to configure later
+```
+
+## Step 3: Update settings.json
+
+Read the current `~/.claude/settings.json` and add/update the `mcpServers` section.
+
+### Context7 Configuration:
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@context7/mcp"]
+    }
+  }
+}
+```
+
+### Exa Web Search Configuration:
+```json
+{
+  "mcpServers": {
+    "exa": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/exa-mcp-server"],
+      "env": {
+        "EXA_API_KEY": "<user-provided-key>"
+      }
+    }
+  }
+}
+```
+
+### Filesystem Configuration:
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/mcp-server-filesystem", "<allowed-directories>"]
+    }
+  }
+}
+```
+
+### GitHub Configuration:
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/github-mcp-server"],
+      "env": {
+        "GITHUB_TOKEN": "<user-provided-token>"
+      }
+    }
+  }
+}
+```
+
+## Step 4: Merge Configuration
+
+When updating settings.json:
+
+1. Read existing file: `~/.claude/settings.json`
+2. Parse as JSON (handle comments with jsonc-parser if needed)
+3. Merge new `mcpServers` entries with existing ones (don't overwrite user's other MCP servers)
+4. Write back to file with proper formatting
+
+```bash
+# Backup existing settings first
+cp ~/.claude/settings.json ~/.claude/settings.json.bak 2>/dev/null || true
+```
+
+Use the Edit tool or Write tool to update the settings file, preserving existing configuration.
+
+## Step 5: Verify Installation
+
+After configuration, verify the MCP servers are properly set up:
+
+```bash
+# Check if settings.json has mcpServers
+grep -q "mcpServers" ~/.claude/settings.json && echo "MCP servers configured" || echo "Configuration may have failed"
+
+# List configured servers
+node -e "const s = require('$HOME/.claude/settings.json'); console.log('Configured MCP servers:', Object.keys(s.mcpServers || {}).join(', ') || 'none')"
+```
+
+## Step 6: Show Completion Message
+
+```
+MCP Server Configuration Complete!
+
+CONFIGURED SERVERS:
+[List the servers that were configured]
+
+NEXT STEPS:
+1. Restart Claude Code for changes to take effect
+2. The configured MCP tools will be available to all agents
+
+USAGE TIPS:
+- Context7: Ask about library documentation (e.g., "How do I use React hooks?")
+- Exa: Use for web searches (e.g., "Search the web for latest TypeScript features")
+- Filesystem: Extended file operations beyond the working directory
+- GitHub: Interact with GitHub repos, issues, and PRs
+
+TROUBLESHOOTING:
+- If MCP servers don't appear, check ~/.claude/settings.json for syntax errors
+- Ensure you have Node.js 18+ installed for npx commands
+- Run /oh-my-claudecode:doctor to diagnose issues
+
+To add more MCP servers later, run: /oh-my-claudecode:mcp-setup
+```
+
+## Custom MCP Server
+
+If user selects "Custom":
+
+Ask for:
+1. Server name (identifier)
+2. Command to run (e.g., `npx`, `node`, path to executable)
+3. Arguments (comma-separated)
+4. Environment variables (optional, key=value pairs)
+
+Then add to mcpServers section accordingly.
+
+## Common Issues
+
+### MCP Server Not Loading
+- Ensure Node.js 18+ is installed
+- Check that npx is available in PATH
+- Verify no JSON syntax errors in settings.json
+
+### API Key Issues
+- Exa: Verify key at https://dashboard.exa.ai
+- GitHub: Ensure token has required scopes
+
+### Agents Still Using Built-in Tools
+- Restart Claude Code after configuration
+- The built-in websearch will be deprioritized when exa is configured

package/commands/note.md

@@ -10,12 +10,12 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
 
 | 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) |
+| `/oh-my-claudecode:note <content>` | Add to Working Memory with timestamp |
+| `/oh-my-claudecode:note --priority <content>` | Add to Priority Context (always loaded) |
+| `/oh-my-claudecode:note --manual <content>` | Add to MANUAL section (never pruned) |
+| `/oh-my-claudecode:note --show` | Display current notepad contents |
+| `/oh-my-claudecode:note --prune` | Remove entries older than 7 days |
+| `/oh-my-claudecode:note --clear` | Clear Working Memory (keep Priority + MANUAL) |
 
 ## Sections
 
@@ -37,11 +37,11 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
 ## 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
+/oh-my-claudecode:note Found auth bug in UserContext - missing useEffect dependency
+/oh-my-claudecode:note --priority Project uses TypeScript strict mode, all files in src/
+/oh-my-claudecode:note --manual Contact: api-team@company.com for backend questions
+/oh-my-claudecode:note --show
+/oh-my-claudecode:note --prune
 ```
 
 ## Behavior

package/commands/omc-setup.md

@@ -54,7 +54,20 @@ This will:
 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
+## Step 5: Offer MCP Server Configuration
+
+MCP servers extend Claude Code with additional tools (web search, GitHub, etc.).
+
+Ask user: "Would you like to configure MCP servers for enhanced capabilities? (Context7, Exa search, GitHub, etc.)"
+
+If yes, invoke the mcp-setup skill:
+```
+/oh-my-claudecode:mcp-setup
+```
+
+If no, skip to next step.
+
+## Step 6: Detect Upgrade from 2.x
 
 Check if user has existing configuration:
 ```bash
@@ -64,7 +77,7 @@ ls ~/.claude/commands/ralph-loop.md 2>/dev/null || ls ~/.claude/commands/ultrawo
 
 If found, this is an upgrade from 2.x.
 
-## Step 6: Show Welcome Message
+## Step 7: Show Welcome Message
 
 ### For New Users:
 
@@ -91,6 +104,9 @@ Just include these words naturally in your request:
 
 Combine them: "ralph ulw: migrate the database"
 
+MCP SERVERS:
+Run /oh-my-claudecode:mcp-setup to add tools like web search, GitHub, etc.
+
 HUD STATUSLINE:
 The status bar now shows OMC state. Restart Claude Code to see it.
 

package/commands/ralph-init.md

@@ -53,7 +53,7 @@ Started: [ISO timestamp]
 3. **Independent stories**: Minimize dependencies between stories
 4. **Priority order**: Foundational work (DB, types) before UI
 
-After creating files, report summary and suggest running `/ralph-loop` to start.
+After creating files, report summary and suggest running `/oh-my-claudecode:ralph-loop` to start.
 
 Task to break down:
 {{ARGUMENTS}}