oh-my-codex 0.3.4 → 0.3.6

package/skills/doctor/SKILL.md

@@ -5,7 +5,7 @@ description: Diagnose and fix oh-my-codex installation issues
 
 # Doctor Skill
 
-Note: All `~/.claude/...` paths in this guide respect `CLAUDE_CONFIG_DIR` when that environment variable is set.
+Note: All `~/.codex/...` paths in this guide respect `CODEX_HOME` when that environment variable is set.
 
 ## Task: Run Installation Diagnostics
 
@@ -15,11 +15,11 @@ You are the OMX Doctor - diagnose and fix installation issues.
 
 ```bash
 # Get installed version
-INSTALLED=$(ls ~/.claude/plugins/cache/omc/oh-my-codex/ 2>/dev/null | sort -V | tail -1)
+INSTALLED=$(ls ~/.codex/plugins/cache/omc/oh-my-codex/ 2>/dev/null | sort -V | tail -1)
 echo "Installed: $INSTALLED"
 
 # Get latest from npm
-LATEST=$(npm view oh-my-claude-sisyphus version 2>/dev/null)
+LATEST=$(npm view oh-my-codex version 2>/dev/null)
 echo "Latest: $LATEST"
 ```
 
@@ -28,12 +28,14 @@ echo "Latest: $LATEST"
 - If INSTALLED != LATEST: WARN - outdated plugin
 - If multiple versions exist: WARN - stale cache
 
-### Step 2: Check for Legacy Hooks in settings.json
+### Step 2: Check Hook Configuration (config.toml + legacy settings.json)
 
-Read `~/.claude/settings.json` and check if there's a `"hooks"` key with entries like:
-- `bash $HOME/.claude/hooks/keyword-detector.sh`
-- `bash $HOME/.claude/hooks/persistent-mode.sh`
-- `bash $HOME/.claude/hooks/session-start.sh`
+Check `~/.codex/config.toml` first (current Codex config), then check legacy `~/.codex/settings.json` only if it exists.
+
+Look for hook entries pointing to removed scripts like:
+- `bash $HOME/.codex/hooks/keyword-detector.sh`
+- `bash $HOME/.codex/hooks/persistent-mode.sh`
+- `bash $HOME/.codex/hooks/session-start.sh`
 
 **Diagnosis**:
 - If found: CRITICAL - legacy hooks causing duplicates
@@ -41,31 +43,31 @@ Read `~/.claude/settings.json` and check if there's a `"hooks"` key with entries
 ### Step 3: Check for Legacy Bash Hook Scripts
 
 ```bash
-ls -la ~/.claude/hooks/*.sh 2>/dev/null
+ls -la ~/.codex/hooks/*.sh 2>/dev/null
 ```
 
 **Diagnosis**:
 - If `keyword-detector.sh`, `persistent-mode.sh`, `session-start.sh`, or `stop-continuation.sh` exist: WARN - legacy scripts (can cause confusion)
 
-### Step 4: Check CLAUDE.md
+### Step 4: Check AGENTS.md
 
 ```bash
-# Check if CLAUDE.md exists
-ls -la ~/.claude/CLAUDE.md 2>/dev/null
+# Check if AGENTS.md exists
+ls -la ~/.codex/AGENTS.md 2>/dev/null
 
 # Check for OMX marker
-grep -q "oh-my-codex Multi-Agent System" ~/.claude/CLAUDE.md 2>/dev/null && echo "Has OMX config" || echo "Missing OMX config"
+grep -q "oh-my-codex Multi-Agent System" ~/.codex/AGENTS.md 2>/dev/null && echo "Has OMX config" || echo "Missing OMX config"
 ```
 
 **Diagnosis**:
-- If missing: CRITICAL - CLAUDE.md not configured
-- If missing OMX marker: WARN - outdated CLAUDE.md
+- If missing: CRITICAL - AGENTS.md not configured
+- If missing OMX marker: WARN - outdated AGENTS.md
 
 ### Step 5: Check for Stale Plugin Cache
 
 ```bash
 # Count versions in cache
-ls ~/.claude/plugins/cache/omc/oh-my-codex/ 2>/dev/null | wc -l
+ls ~/.codex/plugins/cache/omc/oh-my-codex/ 2>/dev/null | wc -l
 ```
 
 **Diagnosis**:
@@ -77,19 +79,19 @@ Check for legacy agents, commands, and skills installed via curl (before plugin
 
 ```bash
 # Check for legacy agents directory
-ls -la ~/.claude/agents/ 2>/dev/null
+ls -la ~/.codex/agents/ 2>/dev/null
 
 # Check for legacy commands directory
-ls -la ~/.claude/commands/ 2>/dev/null
+ls -la ~/.codex/commands/ 2>/dev/null
 
 # Check for legacy skills directory
-ls -la ~/.claude/skills/ 2>/dev/null
+ls -la ~/.codex/skills/ 2>/dev/null
 ```
 
 **Diagnosis**:
-- If `~/.claude/agents/` exists with oh-my-codex-related files: WARN - legacy agents (now provided by plugin)
-- If `~/.claude/commands/` exists with oh-my-codex-related files: WARN - legacy commands (now provided by plugin)
-- If `~/.claude/skills/` exists with oh-my-codex-related files: WARN - legacy skills (now provided by plugin)
+- If `~/.codex/agents/` exists with oh-my-codex-related files: WARN - legacy agents (now provided by plugin)
+- If `~/.codex/commands/` exists with oh-my-codex-related files: WARN - legacy commands (now provided by plugin)
+- If `~/.codex/skills/` exists with oh-my-codex-related files: WARN - legacy skills (now provided by plugin)
 
 Look for files like:
 - `architect.md`, `researcher.md`, `explore.md`, `executor.md`, etc. in agents/
@@ -113,13 +115,13 @@ After running all checks, output a report:
 | Check | Status | Details |
 |-------|--------|---------|
 | Plugin Version | OK/WARN/CRITICAL | ... |
-| Legacy Hooks (settings.json) | OK/CRITICAL | ... |
-| Legacy Scripts (~/.claude/hooks/) | OK/WARN | ... |
-| CLAUDE.md | OK/WARN/CRITICAL | ... |
+| Hook Config (config.toml / legacy settings.json) | OK/CRITICAL | ... |
+| Legacy Scripts (~/.codex/hooks/) | OK/WARN | ... |
+| AGENTS.md | OK/WARN/CRITICAL | ... |
 | Plugin Cache | OK/WARN | ... |
-| Legacy Agents (~/.claude/agents/) | OK/WARN | ... |
-| Legacy Commands (~/.claude/commands/) | OK/WARN | ... |
-| Legacy Skills (~/.claude/skills/) | OK/WARN | ... |
+| Legacy Agents (~/.codex/agents/) | OK/WARN | ... |
+| Legacy Commands (~/.codex/commands/) | OK/WARN | ... |
+| Legacy Skills (~/.codex/skills/) | OK/WARN | ... |
 
 ### Issues Found
 1. [Issue description]
@@ -137,34 +139,34 @@ If issues found, ask user: "Would you like me to fix these issues automatically?
 
 If yes, apply fixes:
 
-### Fix: Legacy Hooks in settings.json
-Remove the `"hooks"` section from `~/.claude/settings.json` (keep other settings intact)
+### Fix: Legacy Hooks in legacy settings.json
+If `~/.codex/settings.json` exists, remove the legacy `"hooks"` section (keep other settings intact).
 
 ### Fix: Legacy Bash Scripts
 ```bash
-rm -f ~/.claude/hooks/keyword-detector.sh
-rm -f ~/.claude/hooks/persistent-mode.sh
-rm -f ~/.claude/hooks/session-start.sh
-rm -f ~/.claude/hooks/stop-continuation.sh
+rm -f ~/.codex/hooks/keyword-detector.sh
+rm -f ~/.codex/hooks/persistent-mode.sh
+rm -f ~/.codex/hooks/session-start.sh
+rm -f ~/.codex/hooks/stop-continuation.sh
 ```
 
 ### Fix: Outdated Plugin
 ```bash
-rm -rf ~/.claude/plugins/cache/oh-my-codex
+rm -rf ~/.codex/plugins/cache/oh-my-codex
 echo "Plugin cache cleared. Restart Codex CLI to fetch latest version."
 ```
 
 ### Fix: Stale Cache (multiple versions)
 ```bash
 # Keep only latest version
-cd ~/.claude/plugins/cache/omc/oh-my-codex/
+cd ~/.codex/plugins/cache/omc/oh-my-codex/
 ls | sort -V | head -n -1 | xargs rm -rf
 ```
 
-### Fix: Missing/Outdated CLAUDE.md
-Fetch latest from GitHub and write to `~/.claude/CLAUDE.md`:
+### Fix: Missing/Outdated AGENTS.md
+Fetch latest from GitHub and write to `~/.codex/AGENTS.md`:
 ```
-WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-codex/main/docs/CLAUDE.md", prompt: "Return the complete raw markdown content exactly as-is")
+WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-codex/main/docs/AGENTS.md", prompt: "Return the complete raw markdown content exactly as-is")
 ```
 
 ### Fix: Legacy Curl-Installed Content
@@ -173,14 +175,14 @@ Remove legacy agents, commands, and skills directories (now provided by plugin):
 
 ```bash
 # Backup first (optional - ask user)
-# mv ~/.claude/agents ~/.claude/agents.bak
-# mv ~/.claude/commands ~/.claude/commands.bak
-# mv ~/.claude/skills ~/.claude/skills.bak
+# mv ~/.codex/agents ~/.codex/agents.bak
+# mv ~/.codex/commands ~/.codex/commands.bak
+# mv ~/.codex/skills ~/.codex/skills.bak
 
 # Or remove directly
-rm -rf ~/.claude/agents
-rm -rf ~/.claude/commands
-rm -rf ~/.claude/skills
+rm -rf ~/.codex/agents
+rm -rf ~/.codex/commands
+rm -rf ~/.codex/skills
 ```
 
 **Note**: Only remove if these contain oh-my-codex-related files. If user has custom agents/commands/skills, warn them and ask before removing.

package/skills/ecomode/SKILL.md

@@ -93,7 +93,7 @@ Long-running commands (install, build, test) run in background. Maximum 20 concu
 
 Ecomode can be completely disabled via config. When disabled, all ecomode keywords are ignored.
 
-Set in `~/.claude/.omx-config.json`:
+Set in `~/.codex/.omx-config.json`:
 ```json
 {
   "ecomode": {

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

@@ -18,9 +18,9 @@ Routes to the designer agent or Gemini MCP for frontend work.
 ### Preferred: MCP Direct
 Before first MCP tool use, call `ToolSearch("mcp")` to discover deferred MCP tools.
 Use `mcp__g__ask_gemini` with `agent_role: "designer"` for design tasks.
-If ToolSearch finds no MCP tools, use the Claude agent fallback below.
+If ToolSearch finds no MCP tools, use the Codex agent fallback below.
 
-### Fallback: Claude Agent
+### Fallback: Codex Agent
 ```
 spawn_sub_agent(subagent_type="oh-my-codex:designer", model="sonnet", prompt="{{ARGUMENTS}}")
 ```

package/skills/help/SKILL.md

@@ -77,7 +77,7 @@ Analyze your oh-my-codex usage and get tailored recommendations to improve your
 # Check for token tracking data
 TOKEN_FILE="$HOME/.omx/state/token-tracking.jsonl"
 SESSION_FILE=".omx/state/session-history.json"
-CONFIG_FILE="$HOME/.claude/.omx-config.json"
+CONFIG_FILE="$HOME/.codex/.omx-config.json"
 
 echo "Analyzing OMX Usage..."
 echo ""

package/skills/learner/SKILL.md

@@ -7,13 +7,13 @@ description: Extract a learned skill from the current conversation
 
 ## The Insight
 
-Reusable skills are not code snippets to copy-paste, but **principles and decision-making heuristics** that teach Claude HOW TO THINK about a class of problems.
+Reusable skills are not code snippets to copy-paste, but **principles and decision-making heuristics** that teach Codex HOW TO THINK about a class of problems.
 
 **The difference:**
 - BAD (mimicking): "When you see ConnectionResetError, add this try/except block"
 - GOOD (reusable skill): "In async network code, any I/O operation can fail independently due to client/server lifecycle mismatches. The principle: wrap each I/O operation separately, because failure between operations is the common case, not the exception."
 
-A good skill changes how Claude APPROACHES problems, not just what code it produces.
+A good skill changes how Codex APPROACHES problems, not just what code it produces.
 
 ## Why This Matters
 
@@ -62,7 +62,7 @@ The system REJECTS skills that are:
 
 **Step 3: Save Location**
 
-- **User-level**: ~/.claude/skills/omc-learned/ - Rare. Only for truly portable insights.
+- **User-level**: ~/.codex/skills/omc-learned/ - Rare. Only for truly portable insights.
 - **Project-level**: .omx/skills/ - Default. Version-controlled with repo.
 
 ### What Makes a USEFUL Skill
@@ -120,14 +120,14 @@ How do you know when this skill applies? What are the signs?
 Example: "Building any long-lived connection handler (proxy, websocket, SSE)"
 
 ## The Approach
-The decision-making heuristic, not just code. How should Claude THINK about this?
+The decision-making heuristic, not just code. How should Codex THINK about this?
 Example: "For each I/O operation, ask: what if this fails right now? Handle it locally."
 
 ## Example (Optional)
 If code helps, show it - but as illustration of the principle, not copy-paste material.
 ```
 
-**Key**: A skill is REUSABLE if Claude can apply it to NEW situations, not just identical ones.
+**Key**: A skill is REUSABLE if Codex can apply it to NEW situations, not just identical ones.
 
 ## Related Commands