oh-my-claude-sisyphus 3.3.6 → 3.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +79 -19
- package/agents/planner.md +7 -7
- package/agents/scientist-high.md +3 -3
- package/commands/cancel-ralph.md +3 -3
- package/commands/cancel-ultraqa.md +5 -5
- package/commands/cancel-ultrawork.md +4 -4
- package/commands/hud.md +8 -8
- package/commands/learner.md +2 -2
- package/commands/mcp-setup.md +194 -0
- package/commands/note.md +11 -11
- package/commands/omc-setup.md +18 -2
- package/commands/ralph-init.md +1 -1
- package/commands/ralplan.md +59 -6
- package/commands/release.md +2 -2
- package/commands/research.md +7 -7
- package/commands/ultraqa.md +6 -6
- package/dist/__tests__/installer.test.js +1 -1
- package/dist/features/auto-update.d.ts.map +1 -1
- package/dist/features/auto-update.js +27 -7
- package/dist/features/auto-update.js.map +1 -1
- package/dist/hud/transcript.d.ts.map +1 -1
- package/dist/hud/transcript.js +2 -2
- package/dist/hud/transcript.js.map +1 -1
- package/dist/installer/index.d.ts +1 -1
- package/dist/installer/index.d.ts.map +1 -1
- package/dist/installer/index.js +5 -3
- package/dist/installer/index.js.map +1 -1
- package/dist/platform/index.d.ts +16 -0
- package/dist/platform/index.d.ts.map +1 -0
- package/dist/platform/index.js +29 -0
- package/dist/platform/index.js.map +1 -0
- package/dist/platform/process-utils.d.ts +26 -0
- package/dist/platform/process-utils.d.ts.map +1 -0
- package/dist/platform/process-utils.js +157 -0
- package/dist/platform/process-utils.js.map +1 -0
- package/dist/tools/lsp/client.d.ts.map +1 -1
- package/dist/tools/lsp/client.js +10 -3
- package/dist/tools/lsp/client.js.map +1 -1
- package/dist/tools/python-repl/bridge-manager.d.ts.map +1 -1
- package/dist/tools/python-repl/bridge-manager.js +24 -78
- package/dist/tools/python-repl/bridge-manager.js.map +1 -1
- package/dist/tools/python-repl/paths.d.ts.map +1 -1
- package/dist/tools/python-repl/paths.js +5 -0
- package/dist/tools/python-repl/paths.js.map +1 -1
- package/dist/tools/python-repl/session-lock.d.ts +1 -1
- package/dist/tools/python-repl/session-lock.d.ts.map +1 -1
- package/dist/tools/python-repl/session-lock.js +26 -62
- package/dist/tools/python-repl/session-lock.js.map +1 -1
- package/docs/CLAUDE.md +27 -27
- package/docs/FULL-README.md +26 -24
- package/docs/MIGRATION-v3.md +6 -6
- package/docs/MIGRATION.md +43 -43
- package/package.json +1 -1
- package/skills/autopilot/SKILL.md +8 -8
- package/skills/cancel-autopilot/SKILL.md +3 -3
- package/skills/cancel-ralph/SKILL.md +3 -3
- package/skills/cancel-ultraqa/SKILL.md +5 -5
- package/skills/cancel-ultrawork/SKILL.md +4 -4
- package/skills/hud/SKILL.md +9 -9
- package/skills/learner/SKILL.md +3 -3
- package/skills/mcp-setup/SKILL.md +196 -0
- package/skills/note/SKILL.md +11 -11
- package/skills/omc-setup/SKILL.md +18 -2
- package/skills/ralph-init/SKILL.md +1 -1
- package/skills/ralplan/SKILL.md +59 -6
- package/skills/release/SKILL.md +2 -2
- package/skills/research/SKILL.md +17 -17
- package/skills/ultraqa/SKILL.md +6 -6
|
@@ -22,9 +22,9 @@ Autopilot is the ultimate hands-off mode. Give it a brief product idea (2-3 line
|
|
|
22
22
|
## Usage
|
|
23
23
|
|
|
24
24
|
```
|
|
25
|
-
/autopilot <your idea>
|
|
26
|
-
/ap "A CLI tool that tracks daily habits"
|
|
27
|
-
/autopilot Add dark mode to the app
|
|
25
|
+
/oh-my-claudecode:autopilot <your idea>
|
|
26
|
+
/oh-my-claudecode:ap "A CLI tool that tracks daily habits"
|
|
27
|
+
/oh-my-claudecode:autopilot Add dark mode to the app
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
## Magic Keywords
|
|
@@ -115,7 +115,7 @@ Optional settings in `.claude/settings.json`:
|
|
|
115
115
|
## Cancellation
|
|
116
116
|
|
|
117
117
|
```
|
|
118
|
-
/cancel-autopilot
|
|
118
|
+
/oh-my-claudecode:cancel-autopilot
|
|
119
119
|
```
|
|
120
120
|
|
|
121
121
|
Or say: "stop", "cancel", "abort"
|
|
@@ -124,23 +124,23 @@ Progress is preserved for resume.
|
|
|
124
124
|
|
|
125
125
|
## Resume
|
|
126
126
|
|
|
127
|
-
If autopilot was cancelled or failed, just run `/autopilot` again to resume from where it stopped.
|
|
127
|
+
If autopilot was cancelled or failed, just run `/oh-my-claudecode:autopilot` again to resume from where it stopped.
|
|
128
128
|
|
|
129
129
|
## Examples
|
|
130
130
|
|
|
131
131
|
**New Project:**
|
|
132
132
|
```
|
|
133
|
-
/autopilot A REST API for a bookstore inventory with CRUD operations
|
|
133
|
+
/oh-my-claudecode:autopilot A REST API for a bookstore inventory with CRUD operations
|
|
134
134
|
```
|
|
135
135
|
|
|
136
136
|
**Feature Addition:**
|
|
137
137
|
```
|
|
138
|
-
/autopilot Add user authentication with JWT tokens
|
|
138
|
+
/oh-my-claudecode:autopilot Add user authentication with JWT tokens
|
|
139
139
|
```
|
|
140
140
|
|
|
141
141
|
**Enhancement:**
|
|
142
142
|
```
|
|
143
|
-
/ap Add dark mode support with system preference detection
|
|
143
|
+
/oh-my-claudecode:ap Add dark mode support with system preference detection
|
|
144
144
|
```
|
|
145
145
|
|
|
146
146
|
## Best Practices
|
|
@@ -17,7 +17,7 @@ Cancel an active autopilot session gracefully.
|
|
|
17
17
|
## Usage
|
|
18
18
|
|
|
19
19
|
```
|
|
20
|
-
/cancel-autopilot
|
|
20
|
+
/oh-my-claudecode:cancel-autopilot
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Or say: "stop autopilot", "cancel autopilot", "abort autopilot"
|
|
@@ -37,14 +37,14 @@ When cancelled, autopilot preserves:
|
|
|
37
37
|
- Spec and plan files
|
|
38
38
|
- Validation verdicts
|
|
39
39
|
|
|
40
|
-
Run `/autopilot` to resume from where you left off.
|
|
40
|
+
Run `/oh-my-claudecode:autopilot` to resume from where you left off.
|
|
41
41
|
|
|
42
42
|
## Force Clear
|
|
43
43
|
|
|
44
44
|
To completely clear all state (no resume):
|
|
45
45
|
|
|
46
46
|
```
|
|
47
|
-
/cancel-autopilot --clear
|
|
47
|
+
/oh-my-claudecode:cancel-autopilot --clear
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
This removes all autopilot files including:
|
|
@@ -35,9 +35,9 @@ After running this command, you are free to stop working. The persistent mode ho
|
|
|
35
35
|
|
|
36
36
|
## Note on Linked Modes
|
|
37
37
|
|
|
38
|
-
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.
|
|
38
|
+
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.
|
|
39
39
|
|
|
40
40
|
## To Start Fresh
|
|
41
41
|
|
|
42
|
-
- `/ralph "task"` - Start ralph with ultrawork (default)
|
|
43
|
-
- `/ultrawork "task"` - Start ultrawork only (standalone)
|
|
42
|
+
- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
|
|
43
|
+
- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
|
|
@@ -22,8 +22,8 @@ After running this command, the QA cycling will stop.
|
|
|
22
22
|
|
|
23
23
|
## To Start Fresh
|
|
24
24
|
|
|
25
|
-
- `/ultraqa --tests` - Run until all tests pass
|
|
26
|
-
- `/ultraqa --build` - Run until build succeeds
|
|
27
|
-
- `/ultraqa --lint` - Run until no lint errors
|
|
28
|
-
- `/ultraqa --typecheck` - Run until no type errors
|
|
29
|
-
- `/ultraqa --custom "pattern"` - Run until pattern matches
|
|
25
|
+
- `/oh-my-claudecode:ultraqa --tests` - Run until all tests pass
|
|
26
|
+
- `/oh-my-claudecode:ultraqa --build` - Run until build succeeds
|
|
27
|
+
- `/oh-my-claudecode:ultraqa --lint` - Run until no lint errors
|
|
28
|
+
- `/oh-my-claudecode:ultraqa --typecheck` - Run until no type errors
|
|
29
|
+
- `/oh-my-claudecode:ultraqa --custom "pattern"` - Run until pattern matches
|
|
@@ -18,7 +18,7 @@ The Ultrawork mode has been cancelled. Clearing state files.
|
|
|
18
18
|
cat .omc/ultrawork-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
**If linked_to_ralph is true**: Use `/cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
|
|
21
|
+
**If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
|
|
22
22
|
|
|
23
23
|
**Otherwise**, execute this command to cancel Ultrawork:
|
|
24
24
|
|
|
@@ -33,10 +33,10 @@ After running this command, ultrawork mode will be deactivated and the HUD will
|
|
|
33
33
|
## Note on Linked Modes
|
|
34
34
|
|
|
35
35
|
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:
|
|
36
|
-
- Use `/cancel-ralph` to cancel both modes
|
|
36
|
+
- Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
|
|
37
37
|
- If you only cancel ultrawork, Ralph will continue but without parallel execution benefits
|
|
38
38
|
|
|
39
39
|
## To Start Fresh
|
|
40
40
|
|
|
41
|
-
- `/ultrawork "task"` - Start ultrawork only (standalone)
|
|
42
|
-
- `/ralph "task"` - Start ralph with ultrawork (default)
|
|
41
|
+
- `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
|
|
42
|
+
- `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
|
package/skills/hud/SKILL.md
CHANGED
|
@@ -14,16 +14,16 @@ Configure the OMC HUD (Heads-Up Display) for the statusline.
|
|
|
14
14
|
|
|
15
15
|
| Command | Description |
|
|
16
16
|
|---------|-------------|
|
|
17
|
-
| `/hud` | Show current HUD status (auto-setup if needed) |
|
|
18
|
-
| `/hud setup` | Install/repair HUD statusline |
|
|
19
|
-
| `/hud minimal` | Switch to minimal display |
|
|
20
|
-
| `/hud focused` | Switch to focused display (default) |
|
|
21
|
-
| `/hud full` | Switch to full display |
|
|
22
|
-
| `/hud status` | Show detailed HUD status |
|
|
17
|
+
| `/oh-my-claudecode:hud` | Show current HUD status (auto-setup if needed) |
|
|
18
|
+
| `/oh-my-claudecode:hud setup` | Install/repair HUD statusline |
|
|
19
|
+
| `/oh-my-claudecode:hud minimal` | Switch to minimal display |
|
|
20
|
+
| `/oh-my-claudecode:hud focused` | Switch to focused display (default) |
|
|
21
|
+
| `/oh-my-claudecode:hud full` | Switch to full display |
|
|
22
|
+
| `/oh-my-claudecode:hud status` | Show detailed HUD status |
|
|
23
23
|
|
|
24
24
|
## Auto-Setup
|
|
25
25
|
|
|
26
|
-
When you run `/hud` or `/hud setup`, the system will automatically:
|
|
26
|
+
When you run `/oh-my-claudecode:hud` or `/oh-my-claudecode:hud setup`, the system will automatically:
|
|
27
27
|
1. Check if `~/.claude/hud/omc-hud.mjs` exists
|
|
28
28
|
2. Check if `statusLine` is configured in `~/.claude/settings.json`
|
|
29
29
|
3. If missing, create the HUD wrapper script and configure settings
|
|
@@ -226,9 +226,9 @@ You can manually edit the config file:
|
|
|
226
226
|
## Troubleshooting
|
|
227
227
|
|
|
228
228
|
If the HUD is not showing:
|
|
229
|
-
1. Run `/hud setup` to auto-install and configure
|
|
229
|
+
1. Run `/oh-my-claudecode:hud setup` to auto-install and configure
|
|
230
230
|
2. Restart Claude Code after setup completes
|
|
231
|
-
3. If still not working, run `/doctor` for full diagnostics
|
|
231
|
+
3. If still not working, run `/oh-my-claudecode:doctor` for full diagnostics
|
|
232
232
|
|
|
233
233
|
Manual verification:
|
|
234
234
|
- HUD script: `~/.claude/hud/omc-hud.mjs`
|
package/skills/learner/SKILL.md
CHANGED
|
@@ -27,7 +27,7 @@ If a potential skill fails any of these questions, it's not worth saving.
|
|
|
27
27
|
|
|
28
28
|
## Recognition Pattern
|
|
29
29
|
|
|
30
|
-
Use /learner ONLY after:
|
|
30
|
+
Use /oh-my-claudecode:learner ONLY after:
|
|
31
31
|
- Solving a tricky bug that required deep investigation
|
|
32
32
|
- Discovering a non-obvious workaround specific to this codebase
|
|
33
33
|
- Finding a hidden gotcha that wastes time when forgotten
|
|
@@ -132,5 +132,5 @@ If code helps, show it - but as illustration of the principle, not copy-paste ma
|
|
|
132
132
|
|
|
133
133
|
## Related Commands
|
|
134
134
|
|
|
135
|
-
- /note - Save quick notes that survive compaction (less formal than skills)
|
|
136
|
-
- /ralph - Start a development loop with learning capture
|
|
135
|
+
- /oh-my-claudecode:note - Save quick notes that survive compaction (less formal than skills)
|
|
136
|
+
- /oh-my-claudecode:ralph - Start a development loop with learning capture
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mcp-setup
|
|
3
|
+
description: Configure popular MCP servers for enhanced agent capabilities
|
|
4
|
+
user-invocable: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# MCP Setup
|
|
8
|
+
|
|
9
|
+
Configure Model Context Protocol (MCP) servers to extend Claude Code's capabilities with external tools like web search, file system access, and GitHub integration.
|
|
10
|
+
|
|
11
|
+
## Overview
|
|
12
|
+
|
|
13
|
+
MCP servers provide additional tools that Claude Code agents can use. This skill helps you configure popular MCP servers in your `~/.claude/settings.json`.
|
|
14
|
+
|
|
15
|
+
## Step 1: Show Available MCP Servers
|
|
16
|
+
|
|
17
|
+
Present the user with available MCP server options using AskUserQuestion:
|
|
18
|
+
|
|
19
|
+
**Question:** "Which MCP server would you like to configure?"
|
|
20
|
+
|
|
21
|
+
**Options:**
|
|
22
|
+
1. **Context7** - Documentation and code context from popular libraries
|
|
23
|
+
2. **Exa Web Search** - Enhanced web search (replaces built-in websearch)
|
|
24
|
+
3. **Filesystem** - Extended file system access with additional capabilities
|
|
25
|
+
4. **GitHub** - GitHub API integration for issues, PRs, and repository management
|
|
26
|
+
5. **All of the above** - Configure all recommended MCP servers
|
|
27
|
+
6. **Custom** - Add a custom MCP server
|
|
28
|
+
|
|
29
|
+
## Step 2: Gather Required Information
|
|
30
|
+
|
|
31
|
+
### For Context7:
|
|
32
|
+
No API key required. Ready to use immediately.
|
|
33
|
+
|
|
34
|
+
### For Exa Web Search:
|
|
35
|
+
Ask for API key:
|
|
36
|
+
```
|
|
37
|
+
Do you have an Exa API key?
|
|
38
|
+
- Get one at: https://exa.ai
|
|
39
|
+
- Enter your API key, or type 'skip' to configure later
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### For Filesystem:
|
|
43
|
+
Ask for allowed directories:
|
|
44
|
+
```
|
|
45
|
+
Which directories should the filesystem MCP have access to?
|
|
46
|
+
Default: Current working directory
|
|
47
|
+
Enter comma-separated paths, or press Enter for default
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### For GitHub:
|
|
51
|
+
Ask for token:
|
|
52
|
+
```
|
|
53
|
+
Do you have a GitHub Personal Access Token?
|
|
54
|
+
- Create one at: https://github.com/settings/tokens
|
|
55
|
+
- Recommended scopes: repo, read:org
|
|
56
|
+
- Enter your token, or type 'skip' to configure later
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Step 3: Update settings.json
|
|
60
|
+
|
|
61
|
+
Read the current `~/.claude/settings.json` and add/update the `mcpServers` section.
|
|
62
|
+
|
|
63
|
+
### Context7 Configuration:
|
|
64
|
+
```json
|
|
65
|
+
{
|
|
66
|
+
"mcpServers": {
|
|
67
|
+
"context7": {
|
|
68
|
+
"command": "npx",
|
|
69
|
+
"args": ["-y", "@context7/mcp"]
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### Exa Web Search Configuration:
|
|
76
|
+
```json
|
|
77
|
+
{
|
|
78
|
+
"mcpServers": {
|
|
79
|
+
"exa": {
|
|
80
|
+
"command": "npx",
|
|
81
|
+
"args": ["-y", "@anthropic/exa-mcp-server"],
|
|
82
|
+
"env": {
|
|
83
|
+
"EXA_API_KEY": "<user-provided-key>"
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### Filesystem Configuration:
|
|
91
|
+
```json
|
|
92
|
+
{
|
|
93
|
+
"mcpServers": {
|
|
94
|
+
"filesystem": {
|
|
95
|
+
"command": "npx",
|
|
96
|
+
"args": ["-y", "@anthropic/mcp-server-filesystem", "<allowed-directories>"]
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### GitHub Configuration:
|
|
103
|
+
```json
|
|
104
|
+
{
|
|
105
|
+
"mcpServers": {
|
|
106
|
+
"github": {
|
|
107
|
+
"command": "npx",
|
|
108
|
+
"args": ["-y", "@anthropic/github-mcp-server"],
|
|
109
|
+
"env": {
|
|
110
|
+
"GITHUB_TOKEN": "<user-provided-token>"
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Step 4: Merge Configuration
|
|
118
|
+
|
|
119
|
+
When updating settings.json:
|
|
120
|
+
|
|
121
|
+
1. Read existing file: `~/.claude/settings.json`
|
|
122
|
+
2. Parse as JSON (handle comments with jsonc-parser if needed)
|
|
123
|
+
3. Merge new `mcpServers` entries with existing ones (don't overwrite user's other MCP servers)
|
|
124
|
+
4. Write back to file with proper formatting
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
# Backup existing settings first
|
|
128
|
+
cp ~/.claude/settings.json ~/.claude/settings.json.bak 2>/dev/null || true
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
Use the Edit tool or Write tool to update the settings file, preserving existing configuration.
|
|
132
|
+
|
|
133
|
+
## Step 5: Verify Installation
|
|
134
|
+
|
|
135
|
+
After configuration, verify the MCP servers are properly set up:
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
# Check if settings.json has mcpServers
|
|
139
|
+
grep -q "mcpServers" ~/.claude/settings.json && echo "MCP servers configured" || echo "Configuration may have failed"
|
|
140
|
+
|
|
141
|
+
# List configured servers
|
|
142
|
+
node -e "const s = require('$HOME/.claude/settings.json'); console.log('Configured MCP servers:', Object.keys(s.mcpServers || {}).join(', ') || 'none')"
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
## Step 6: Show Completion Message
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
MCP Server Configuration Complete!
|
|
149
|
+
|
|
150
|
+
CONFIGURED SERVERS:
|
|
151
|
+
[List the servers that were configured]
|
|
152
|
+
|
|
153
|
+
NEXT STEPS:
|
|
154
|
+
1. Restart Claude Code for changes to take effect
|
|
155
|
+
2. The configured MCP tools will be available to all agents
|
|
156
|
+
|
|
157
|
+
USAGE TIPS:
|
|
158
|
+
- Context7: Ask about library documentation (e.g., "How do I use React hooks?")
|
|
159
|
+
- Exa: Use for web searches (e.g., "Search the web for latest TypeScript features")
|
|
160
|
+
- Filesystem: Extended file operations beyond the working directory
|
|
161
|
+
- GitHub: Interact with GitHub repos, issues, and PRs
|
|
162
|
+
|
|
163
|
+
TROUBLESHOOTING:
|
|
164
|
+
- If MCP servers don't appear, check ~/.claude/settings.json for syntax errors
|
|
165
|
+
- Ensure you have Node.js 18+ installed for npx commands
|
|
166
|
+
- Run /oh-my-claudecode:doctor to diagnose issues
|
|
167
|
+
|
|
168
|
+
To add more MCP servers later, run: /oh-my-claudecode:mcp-setup
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## Custom MCP Server
|
|
172
|
+
|
|
173
|
+
If user selects "Custom":
|
|
174
|
+
|
|
175
|
+
Ask for:
|
|
176
|
+
1. Server name (identifier)
|
|
177
|
+
2. Command to run (e.g., `npx`, `node`, path to executable)
|
|
178
|
+
3. Arguments (comma-separated)
|
|
179
|
+
4. Environment variables (optional, key=value pairs)
|
|
180
|
+
|
|
181
|
+
Then add to mcpServers section accordingly.
|
|
182
|
+
|
|
183
|
+
## Common Issues
|
|
184
|
+
|
|
185
|
+
### MCP Server Not Loading
|
|
186
|
+
- Ensure Node.js 18+ is installed
|
|
187
|
+
- Check that npx is available in PATH
|
|
188
|
+
- Verify no JSON syntax errors in settings.json
|
|
189
|
+
|
|
190
|
+
### API Key Issues
|
|
191
|
+
- Exa: Verify key at https://dashboard.exa.ai
|
|
192
|
+
- GitHub: Ensure token has required scopes
|
|
193
|
+
|
|
194
|
+
### Agents Still Using Built-in Tools
|
|
195
|
+
- Restart Claude Code after configuration
|
|
196
|
+
- The built-in websearch will be deprioritized when exa is configured
|
package/skills/note/SKILL.md
CHANGED
|
@@ -12,12 +12,12 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
|
|
|
12
12
|
|
|
13
13
|
| Command | Action |
|
|
14
14
|
|---------|--------|
|
|
15
|
-
| `/note <content>` | Add to Working Memory with timestamp |
|
|
16
|
-
| `/note --priority <content>` | Add to Priority Context (always loaded) |
|
|
17
|
-
| `/note --manual <content>` | Add to MANUAL section (never pruned) |
|
|
18
|
-
| `/note --show` | Display current notepad contents |
|
|
19
|
-
| `/note --prune` | Remove entries older than 7 days |
|
|
20
|
-
| `/note --clear` | Clear Working Memory (keep Priority + MANUAL) |
|
|
15
|
+
| `/oh-my-claudecode:note <content>` | Add to Working Memory with timestamp |
|
|
16
|
+
| `/oh-my-claudecode:note --priority <content>` | Add to Priority Context (always loaded) |
|
|
17
|
+
| `/oh-my-claudecode:note --manual <content>` | Add to MANUAL section (never pruned) |
|
|
18
|
+
| `/oh-my-claudecode:note --show` | Display current notepad contents |
|
|
19
|
+
| `/oh-my-claudecode:note --prune` | Remove entries older than 7 days |
|
|
20
|
+
| `/oh-my-claudecode:note --clear` | Clear Working Memory (keep Priority + MANUAL) |
|
|
21
21
|
|
|
22
22
|
## Sections
|
|
23
23
|
|
|
@@ -39,11 +39,11 @@ Save important context to `.omc/notepad.md` that survives conversation compactio
|
|
|
39
39
|
## Examples
|
|
40
40
|
|
|
41
41
|
```
|
|
42
|
-
/note Found auth bug in UserContext - missing useEffect dependency
|
|
43
|
-
/note --priority Project uses TypeScript strict mode, all files in src/
|
|
44
|
-
/note --manual Contact: api-team@company.com for backend questions
|
|
45
|
-
/note --show
|
|
46
|
-
/note --prune
|
|
42
|
+
/oh-my-claudecode:note Found auth bug in UserContext - missing useEffect dependency
|
|
43
|
+
/oh-my-claudecode:note --priority Project uses TypeScript strict mode, all files in src/
|
|
44
|
+
/oh-my-claudecode:note --manual Contact: api-team@company.com for backend questions
|
|
45
|
+
/oh-my-claudecode:note --show
|
|
46
|
+
/oh-my-claudecode:note --prune
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
## Behavior
|
|
@@ -151,7 +151,20 @@ fi
|
|
|
151
151
|
grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin verified" || echo "Plugin NOT found - run: claude /install-plugin oh-my-claudecode"
|
|
152
152
|
```
|
|
153
153
|
|
|
154
|
-
## Step 5:
|
|
154
|
+
## Step 5: Offer MCP Server Configuration
|
|
155
|
+
|
|
156
|
+
MCP servers extend Claude Code with additional tools (web search, GitHub, etc.).
|
|
157
|
+
|
|
158
|
+
Ask user: "Would you like to configure MCP servers for enhanced capabilities? (Context7, Exa search, GitHub, etc.)"
|
|
159
|
+
|
|
160
|
+
If yes, invoke the mcp-setup skill:
|
|
161
|
+
```
|
|
162
|
+
/oh-my-claudecode:mcp-setup
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
If no, skip to next step.
|
|
166
|
+
|
|
167
|
+
## Step 6: Detect Upgrade from 2.x
|
|
155
168
|
|
|
156
169
|
Check if user has existing configuration:
|
|
157
170
|
```bash
|
|
@@ -161,7 +174,7 @@ ls ~/.claude/commands/ralph-loop.md 2>/dev/null || ls ~/.claude/commands/ultrawo
|
|
|
161
174
|
|
|
162
175
|
If found, this is an upgrade from 2.x.
|
|
163
176
|
|
|
164
|
-
## Step
|
|
177
|
+
## Step 7: Show Welcome Message
|
|
165
178
|
|
|
166
179
|
### For New Users:
|
|
167
180
|
|
|
@@ -188,6 +201,9 @@ Just include these words naturally in your request:
|
|
|
188
201
|
|
|
189
202
|
Combine them: "ralph ulw: migrate the database"
|
|
190
203
|
|
|
204
|
+
MCP SERVERS:
|
|
205
|
+
Run /oh-my-claudecode:mcp-setup to add tools like web search, GitHub, etc.
|
|
206
|
+
|
|
191
207
|
HUD STATUSLINE:
|
|
192
208
|
The status bar now shows OMC state. Restart Claude Code to see it.
|
|
193
209
|
|
|
@@ -55,7 +55,7 @@ Started: [ISO timestamp]
|
|
|
55
55
|
3. **Independent stories**: Minimize dependencies between stories
|
|
56
56
|
4. **Priority order**: Foundational work (DB, types) before UI
|
|
57
57
|
|
|
58
|
-
After creating files, report summary and suggest running `/ralph-loop` to start.
|
|
58
|
+
After creating files, report summary and suggest running `/oh-my-claudecode:ralph-loop` to start.
|
|
59
59
|
|
|
60
60
|
Task to break down:
|
|
61
61
|
{{ARGUMENTS}}
|
package/skills/ralplan/SKILL.md
CHANGED
|
@@ -77,6 +77,38 @@ Ralplan maintains persistent state in `.omc/ralplan-state.json` to track progres
|
|
|
77
77
|
|
|
78
78
|
**Phases**: `planner_planning` → `architect_consultation` → `critic_review` → `handling_verdict` → `complete`
|
|
79
79
|
|
|
80
|
+
## Plan Mode Interaction (CRITICAL)
|
|
81
|
+
|
|
82
|
+
**When ralplan is invoked while Plan mode is active:**
|
|
83
|
+
|
|
84
|
+
The Planner agent has a PHASE 3.5 (CONFIRMATION) that normally requires user confirmation before proceeding. **This MUST be bypassed within ralplan because the Critic serves as the reviewer, not the user.**
|
|
85
|
+
|
|
86
|
+
### Mandatory Constraints
|
|
87
|
+
|
|
88
|
+
| Constraint | Rationale |
|
|
89
|
+
|------------|-----------|
|
|
90
|
+
| **Planner MUST skip PHASE 3.5 confirmation** | Critic reviews the plan, not the user |
|
|
91
|
+
| **Critic MUST run before any plan approval** | No plan is approved without Critic verdict |
|
|
92
|
+
| **DO NOT exit plan mode until Critic has rendered verdict** | Premature exit skips the review step |
|
|
93
|
+
| **Log `[RALPLAN] Critic review required before approval`** | Observability for debugging |
|
|
94
|
+
|
|
95
|
+
### Flow When Plan Mode Is Active
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
1. Orchestrator invokes ralplan skill
|
|
99
|
+
2. Log: [RALPLAN] Starting - Critic review will be required
|
|
100
|
+
3. Spawn Planner in DIRECT PLANNING MODE (no interview, no confirmation)
|
|
101
|
+
4. Planner outputs PLAN_READY: <path>
|
|
102
|
+
5. Log: [RALPLAN] Plan ready, invoking Critic for review
|
|
103
|
+
6. Spawn Critic with plan path <-- MUST HAPPEN
|
|
104
|
+
7. Critic renders OKAY or REJECT
|
|
105
|
+
8. ONLY THEN can plan be approved or refined
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**CRITICAL: The Critic invocation is MANDATORY. If the Planner completes and signals plan ready, the orchestrator MUST invoke the Critic before any form of plan approval or user confirmation.**
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
80
112
|
## Execution Protocol
|
|
81
113
|
|
|
82
114
|
### Initialization
|
|
@@ -98,12 +130,15 @@ The skill begins by establishing the planning environment:
|
|
|
98
130
|
The Planner creates an initial plan based on task context:
|
|
99
131
|
|
|
100
132
|
- Invoke Planner in **direct planning mode** (bypassing interview since task context is pre-gathered)
|
|
133
|
+
- **CRITICAL: Planner MUST skip PHASE 3.5 (CONFIRMATION)** - the Critic will review, not the user
|
|
101
134
|
- Planner receives task context directly without preliminary questioning
|
|
102
135
|
- Planner mandatorily consults with Metis for gap detection
|
|
103
136
|
- Planner generates plan directly to `.omc/plans/[feature-name].md`
|
|
104
137
|
- Plan includes: requirements summary, concrete acceptance criteria, specific implementation steps with file references, risk identification with mitigations, and verification steps
|
|
105
138
|
- Signal completion with `PLAN_READY: .omc/plans/[filename].md`
|
|
139
|
+
- **After PLAN_READY: DO NOT approve or confirm the plan. Proceed to Critic Review.**
|
|
106
140
|
- Extract plan path from completion signal and update state
|
|
141
|
+
- Log: `[RALPLAN] Critic review required before approval`
|
|
107
142
|
|
|
108
143
|
### Architect Consultation (Conditional)
|
|
109
144
|
|
|
@@ -114,7 +149,11 @@ The Architect provides strategic guidance in two scenarios:
|
|
|
114
149
|
|
|
115
150
|
When invoked, the Architect receives file paths to read for analysis, not summaries. This enables thorough examination of the existing codebase context before providing recommendations.
|
|
116
151
|
|
|
117
|
-
### Critic Review
|
|
152
|
+
### Critic Review (MANDATORY - CANNOT BE SKIPPED)
|
|
153
|
+
|
|
154
|
+
**CRITICAL: This phase MUST execute. The Critic is the gatekeeper for plan approval.**
|
|
155
|
+
|
|
156
|
+
Log at start: `[RALPLAN] Invoking Critic for plan review`
|
|
118
157
|
|
|
119
158
|
The Critic examines the plan against quality standards:
|
|
120
159
|
|
|
@@ -122,6 +161,14 @@ The Critic examines the plan against quality standards:
|
|
|
122
161
|
- Critic conducts thorough review of plan completeness and feasibility
|
|
123
162
|
- Critic emits verdict: either `OKAY` (approval) or `REJECT` with specific issues
|
|
124
163
|
|
|
164
|
+
**Enforcement Rules:**
|
|
165
|
+
1. If Planner signals PLAN_READY, Critic MUST be invoked immediately
|
|
166
|
+
2. DO NOT exit ralplan loop before Critic verdict
|
|
167
|
+
3. DO NOT request user confirmation before Critic verdict
|
|
168
|
+
4. DO NOT trigger any plan mode exit behavior before Critic verdict
|
|
169
|
+
|
|
170
|
+
Log after Critic completes: `[RALPLAN] Critic verdict: <OKAY|REJECT>`
|
|
171
|
+
|
|
125
172
|
### Verdict Handling and Iteration
|
|
126
173
|
|
|
127
174
|
Based on Critic's verdict, the skill either approves the plan or continues iteration:
|
|
@@ -129,7 +176,7 @@ Based on Critic's verdict, the skill either approves the plan or continues itera
|
|
|
129
176
|
**If verdict is OKAY:**
|
|
130
177
|
- Mark plan as approved
|
|
131
178
|
- Log approval with iteration count
|
|
132
|
-
- Prepare plan for execution with `/ralph` or manual orchestration
|
|
179
|
+
- Prepare plan for execution with `/oh-my-claudecode:ralph` or manual orchestration
|
|
133
180
|
- Set state `active: false, current_phase: "complete"`
|
|
134
181
|
|
|
135
182
|
**If verdict is REJECT:**
|
|
@@ -205,15 +252,21 @@ CRITIC_FEEDBACK:
|
|
|
205
252
|
|
|
206
253
|
To stop an active ralplan session:
|
|
207
254
|
|
|
208
|
-
- Use `/cancel-ralph` (automatically detects ralplan via state file)
|
|
255
|
+
- Use `/oh-my-claudecode:cancel-ralph` (automatically detects ralplan via state file)
|
|
209
256
|
- Or manually delete `.omc/ralplan-state.json`
|
|
210
257
|
|
|
211
258
|
## Skill Workflow
|
|
212
259
|
|
|
213
260
|
1. **Initialize state** and log: `[RALPLAN Iteration 0/5] Initializing...`
|
|
214
261
|
2. **Parse task** from user input
|
|
215
|
-
3. **Spawn Planner** in direct planning mode
|
|
216
|
-
4. **
|
|
217
|
-
5. **
|
|
262
|
+
3. **Spawn Planner** in direct planning mode (SKIP Planner's PHASE 3.5 confirmation)
|
|
263
|
+
4. **Wait for PLAN_READY** signal from Planner
|
|
264
|
+
5. **Log:** `[RALPLAN] Critic review required before approval`
|
|
265
|
+
6. **Invoke Critic** with plan file path (MANDATORY - CANNOT BE SKIPPED)
|
|
266
|
+
7. **Log:** `[RALPLAN] Critic verdict: <verdict>`
|
|
267
|
+
8. **Handle verdict** - if REJECT, loop back to step 3 with feedback
|
|
268
|
+
9. **Complete** ONLY when Critic approves or max iterations reached with warnings
|
|
269
|
+
|
|
270
|
+
**HARD RULE:** Steps 5-7 are NON-NEGOTIABLE. No plan approval, user confirmation, or plan mode exit can occur before the Critic has rendered its verdict. This prevents the plan mode confirmation flow from short-circuiting the ralplan review loop.
|
|
218
271
|
|
|
219
272
|
The iterative loop refines the plan until it meets the rigorous standards of all three agents, ensuring comprehensive, architecturally sound work plans ready for execution.
|
package/skills/release/SKILL.md
CHANGED
|
@@ -11,10 +11,10 @@ Automate the release process for oh-my-claudecode.
|
|
|
11
11
|
## Usage
|
|
12
12
|
|
|
13
13
|
```
|
|
14
|
-
/release <version>
|
|
14
|
+
/oh-my-claudecode:release <version>
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
Example: `/release 2.4.0` or `/release patch` or `/release minor`
|
|
17
|
+
Example: `/oh-my-claudecode:release 2.4.0` or `/oh-my-claudecode:release patch` or `/oh-my-claudecode:release minor`
|
|
18
18
|
|
|
19
19
|
## Release Checklist
|
|
20
20
|
|
package/skills/research/SKILL.md
CHANGED
|
@@ -21,20 +21,20 @@ Research is a multi-stage workflow that decomposes complex research goals into p
|
|
|
21
21
|
## Usage Examples
|
|
22
22
|
|
|
23
23
|
```
|
|
24
|
-
/research <goal> # Standard research with user checkpoints
|
|
25
|
-
/research AUTO: <goal> # Fully autonomous until complete
|
|
26
|
-
/research status # Check current research session status
|
|
27
|
-
/research resume # Resume interrupted research session
|
|
28
|
-
/research list # List all research sessions
|
|
29
|
-
/research report <session-id> # Generate report for session
|
|
24
|
+
/oh-my-claudecode:research <goal> # Standard research with user checkpoints
|
|
25
|
+
/oh-my-claudecode:research AUTO: <goal> # Fully autonomous until complete
|
|
26
|
+
/oh-my-claudecode:research status # Check current research session status
|
|
27
|
+
/oh-my-claudecode:research resume # Resume interrupted research session
|
|
28
|
+
/oh-my-claudecode:research list # List all research sessions
|
|
29
|
+
/oh-my-claudecode:research report <session-id> # Generate report for session
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
### Quick Examples
|
|
33
33
|
|
|
34
34
|
```
|
|
35
|
-
/research What are the performance characteristics of different sorting algorithms?
|
|
36
|
-
/research AUTO: Analyze authentication patterns in this codebase
|
|
37
|
-
/research How does the error handling work across the API layer?
|
|
35
|
+
/oh-my-claudecode:research What are the performance characteristics of different sorting algorithms?
|
|
36
|
+
/oh-my-claudecode:research AUTO: Analyze authentication patterns in this codebase
|
|
37
|
+
/oh-my-claudecode:research How does the error handling work across the API layer?
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
## Research Protocol
|
|
@@ -151,7 +151,7 @@ Pending stages: {{PENDING_STAGES}}
|
|
|
151
151
|
### AUTO Mode Example
|
|
152
152
|
|
|
153
153
|
```
|
|
154
|
-
/research AUTO: Comprehensive security analysis of the authentication system
|
|
154
|
+
/oh-my-claudecode:research AUTO: Comprehensive security analysis of the authentication system
|
|
155
155
|
|
|
156
156
|
[Decomposition]
|
|
157
157
|
- Stage 1 (LOW): Enumerate auth-related files
|
|
@@ -281,12 +281,12 @@ Batch 2: Stages 6-7 (parallel)
|
|
|
281
281
|
|
|
282
282
|
| Command | Action |
|
|
283
283
|
|---------|--------|
|
|
284
|
-
| `/research status` | Show current session progress |
|
|
285
|
-
| `/research resume` | Resume most recent interrupted session |
|
|
286
|
-
| `/research resume <session-id>` | Resume specific session |
|
|
287
|
-
| `/research list` | List all sessions with status |
|
|
288
|
-
| `/research report <session-id>` | Generate/regenerate report |
|
|
289
|
-
| `/research cancel` | Cancel current session (preserves state) |
|
|
284
|
+
| `/oh-my-claudecode:research status` | Show current session progress |
|
|
285
|
+
| `/oh-my-claudecode:research resume` | Resume most recent interrupted session |
|
|
286
|
+
| `/oh-my-claudecode:research resume <session-id>` | Resume specific session |
|
|
287
|
+
| `/oh-my-claudecode:research list` | List all sessions with status |
|
|
288
|
+
| `/oh-my-claudecode:research report <session-id>` | Generate/regenerate report |
|
|
289
|
+
| `/oh-my-claudecode:research cancel` | Cancel current session (preserves state) |
|
|
290
290
|
|
|
291
291
|
## Tag Extraction
|
|
292
292
|
|
|
@@ -481,7 +481,7 @@ Optional settings in `.claude/settings.json`:
|
|
|
481
481
|
## Cancellation
|
|
482
482
|
|
|
483
483
|
```
|
|
484
|
-
/cancel-research
|
|
484
|
+
/oh-my-claudecode:cancel-research
|
|
485
485
|
```
|
|
486
486
|
|
|
487
487
|
Or say: "stop research", "cancel research", "abort"
|