oh-my-claudecode-opencode 0.3.0 → 0.5.0

package/README.md

@@ -8,6 +8,41 @@ Like Sisyphus condemned to roll his boulder eternally, this plugin ensures your
 
 ---
 
+## 🚀 Quick Install
+
+### For Humans (Recommended)
+
+Just tell your AI assistant:
+
+> **"Install oh-my-claudecode-opencode by following these instructions: https://raw.githubusercontent.com/devswha/oh-my-claudecode-opencode/main/docs/guide/installation.md"**
+
+That's it. The AI will handle the rest.
+
+### One-liner (If you insist on doing it yourself)
+
+```bash
+cd ~/.config/opencode && npm install oh-my-claudecode-opencode@latest && cat > opencode.json << 'EOF'
+{
+  "plugin": ["oh-my-claudecode-opencode"]
+}
+EOF
+echo "✅ Restart OpenCode to activate OMCO"
+```
+
+### Magic Keywords
+
+Once installed, just include these keywords in your prompts:
+
+| Keyword | Effect |
+|---------|--------|
+| `ultrawork` or `ulw` | Maximum intensity parallel execution |
+| `ralph` | Persistence mode - won't stop until complete |
+| `autopilot` | Full autonomous execution |
+
+Example: `ulw implement user authentication with tests`
+
+---
+
 ## 🎯 What is this?
 
 This project **ports the powerful features** of [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) v3.3.6 (a Claude Code plugin) to the **OpenCode platform**.
@@ -67,25 +102,27 @@ This project **ports the powerful features** of [oh-my-claudecode](https://githu
 
 ## Installation
 
-```bash
-# Using npm
-npm install oh-my-claudecode-opencode
-
-# Using bun
-bun add oh-my-claudecode-opencode
+> 💡 **Recommended**: Let your AI handle it! See [Quick Install](#-quick-install) above.
 
-# Using pnpm
-pnpm add oh-my-claudecode-opencode
-```
+### Manual Installation
 
-Then add to your OpenCode configuration:
+```bash
+# Install in OpenCode config directory
+cd ~/.config/opencode
+npm install oh-my-claudecode-opencode
 
-```json
+# Register plugin in opencode.json
+cat > opencode.json << 'EOF'
 {
-  "plugins": ["oh-my-claudecode-opencode"]
+  "plugin": ["oh-my-claudecode-opencode"]
 }
+EOF
+
+# Restart OpenCode to activate
 ```
 
+For detailed instructions, see [Installation Guide](docs/guide/installation.md).
+
 ## Usage
 
 ### Ultrawork Mode
@@ -388,6 +425,44 @@ When triggered:
 3. Minimizes confirmation requests
 4. Maximizes throughput
 
+## Troubleshooting
+
+### Agents not showing in Tab menu?
+
+Run the diagnostic tool:
+
+```bash
+npx oh-my-claudecode-opencode doctor
+```
+
+This checks:
+1. Plugin installation in `~/.config/opencode/node_modules/`
+2. Plugin registration in `opencode.json`
+3. Asset files present
+4. Package dependencies
+5. OMCO configuration validity
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| "Plugin not installed" | `cd ~/.config/opencode && npm install oh-my-claudecode-opencode` |
+| "Plugin not in opencode.json" | Add `"oh-my-claudecode-opencode"` to `"plugin"` array |
+| "Assets directory missing" | Reinstall: `npm install oh-my-claudecode-opencode@latest` |
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | All checks passed |
+| 1 | Critical failure found |
+| 2 | Warnings only |
+
+### Getting Help
+
+1. Run `/doctor` in OpenCode and share the report
+2. Open an issue: https://github.com/devswha/oh-my-claudecode-opencode/issues
+
 ## Development
 
 ```bash

package/assets/AGENTS.md

@@ -4,30 +4,30 @@
 
 ## Porting Context
 
-oh-my-claudecode 설정 스키마를 OpenCode 형식으로 변환한 JSON 스키마. omo-omcs.schema.json은 oh-my-claudecode의 설정 스키마를 기반으로 하며, OpenCode 환경에 맞게 조정되었다. IDE 자동완성 및 검증 지원을 제공한다.
+oh-my-claudecode 설정 스키마를 OpenCode 형식으로 변환한 JSON 스키마. OMCO.schema.json은 oh-my-claudecode의 설정 스키마를 기반으로 하며, OpenCode 환경에 맞게 조정되었다. IDE 자동완성 및 검증 지원을 제공한다.
 
 ## Overview
 
-This directory contains static project assets, primarily the JSON schema definition for omo-omcs configuration validation.
+This directory contains static project assets, primarily the JSON schema definition for OMCO configuration validation.
 
 ## Key Files
 
-### `omo-omcs.schema.json`
+### `OMCO.schema.json`
 **Purpose**: JSON Schema for configuration file validation
 **Schema Version**: Draft-07
-**Usage**: Provides IDE autocomplete and validation for `.opencode/omo-omcs.json`
+**Usage**: Provides IDE autocomplete and validation for `.opencode/OMCO.json`
 
 ## Schema Structure
 
 ### Root Configuration Object
 
-The schema defines a comprehensive configuration structure for the omo-omcs plugin:
+The schema defines a comprehensive configuration structure for the OMCO plugin:
 
 ```json
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "omo-omcs Configuration",
-  "description": "Configuration schema for Oh My OpenCode Sisyphus plugin",
+  "title": "OMCO Configuration",
+  "description": "Configuration schema for oh-my-claudecode-opencode (OMCO) plugin",
   "type": "object"
 }
 ```
@@ -127,7 +127,7 @@ Enable schema validation in VSCode:
 1. **Option 1: In config file**
    ```json
    {
-     "$schema": "node_modules/oh-my-ssalsyphus/assets/omo-omcs.schema.json",
+     "$schema": "node_modules/oh-my-claudecode-opencode/assets/OMCO.schema.json",
      "disabled_hooks": []
    }
    ```
@@ -137,8 +137,8 @@ Enable schema validation in VSCode:
    {
      "json.schemas": [
        {
-         "fileMatch": [".opencode/omo-omcs.json"],
-         "url": "./node_modules/oh-my-ssalsyphus/assets/omo-omcs.schema.json"
+         "fileMatch": [".opencode/OMCO.json"],
+         "url": "./node_modules/oh-my-claudecode-opencode/assets/OMCO.schema.json"
        }
      ]
    }
@@ -155,7 +155,7 @@ Enable schema validation in VSCode:
 ### Valid Configuration
 ```json
 {
-  "$schema": "node_modules/oh-my-ssalsyphus/assets/omo-omcs.schema.json",
+  "$schema": "node_modules/oh-my-claudecode-opencode/assets/OMCO.schema.json",
   "disabled_hooks": ["agent-usage-reminder"],
   "background_task": {
     "max_concurrent": 8,
@@ -214,7 +214,7 @@ When adding new config options:
    });
    ```
 
-2. **Add to JSON schema** (`assets/omo-omcs.schema.json`):
+2. **Add to JSON schema** (`assets/OMCO.schema.json`):
    ```json
    {
      "properties": {
@@ -249,7 +249,7 @@ The schema is exported via package.json:
 ```json
 {
   "exports": {
-    "./schema.json": "./assets/omo-omcs.schema.json"
+    "./schema.json": "./assets/OMCO.schema.json"
   }
 }
 ```
@@ -257,7 +257,7 @@ The schema is exported via package.json:
 Usage in user projects:
 ```json
 {
-  "$schema": "node_modules/oh-my-ssalsyphus/schema.json"
+  "$schema": "node_modules/oh-my-claudecode-opencode/schema.json"
 }
 ```
 
@@ -271,15 +271,15 @@ npm install -g ajv-cli
 
 # Validate config
 ajv validate \
-  -s node_modules/oh-my-ssalsyphus/assets/omo-omcs.schema.json \
-  -d .opencode/omo-omcs.json
+  -s node_modules/oh-my-claudecode-opencode/assets/OMCO.schema.json \
+  -d .opencode/OMCO.json
 ```
 
 ### Programmatic Validation
 
 ```typescript
 import Ajv from 'ajv';
-import schema from 'oh-my-ssalsyphus/schema.json';
+import schema from 'oh-my-claudecode-opencode/schema.json';
 
 const ajv = new Ajv();
 const validate = ajv.compile(schema);
@@ -326,9 +326,9 @@ Use relative paths from project root:
 
 ## Integration Points
 
-- **Config Loader**: `/home/calvin/workspace/omo-omcs/src/config/` - Uses Zod for runtime validation
-- **Documentation**: `/home/calvin/workspace/omo-omcs/docs/` - Schema usage in README
-- **Tests**: `/home/calvin/workspace/omo-omcs/tests/` - Schema validation tests
+- **Config Loader**: `/home/calvin/workspace/OMCO/src/config/` - Uses Zod for runtime validation
+- **Documentation**: `/home/calvin/workspace/OMCO/docs/` - Schema usage in README
+- **Tests**: `/home/calvin/workspace/OMCO/tests/` - Schema validation tests
 
 ## Future Enhancements
 

package/assets/agents/executor.md

@@ -6,7 +6,7 @@ tools: Read, Glob, Grep, Edit, Write, Bash, TodoWrite
 ---
 
 <Role>
-Sisyphus-Junior - Focused executor from OhMyOpenCode.
+OMCO-Junior - Focused executor from OhMyOpenCode.
 Execute tasks directly. NEVER delegate or spawn other agents.
 </Role>
 

package/assets/omco.schema.json

@@ -537,14 +537,14 @@
       },
       "additionalProperties": false
     },
-    "sisyphus_agent": {
+    "omco_agent": {
       "type": "object",
-      "description": "Sisyphus agent configuration",
+      "description": "OMCO agent configuration",
       "properties": {
         "disabled": {
           "type": "boolean",
           "default": false,
-          "description": "Disable Sisyphus agent"
+          "description": "Disable OMCO agent"
         },
         "planner_enabled": {
           "type": "boolean",

package/assets/skills/doctor.md

@@ -1,192 +1,88 @@
 ---
 name: doctor
-description: Diagnose and fix oh-my-claudecode installation issues
+description: Diagnose and fix OMCO installation issues for OpenCode
 user-invocable: true
 ---
 
-# Doctor Skill
+# Doctor Skill (OpenCode)
 
-## Task: Run Installation Diagnostics
+## Quick Diagnosis
 
-You are the OMC Doctor - diagnose and fix installation issues.
-
-### Step 1: Check Plugin Version
-
-```bash
-# Get installed version
-INSTALLED=$(ls ~/.claude/plugins/cache/omc/oh-my-claudecode/ 2>/dev/null | sort -V | tail -1)
-echo "Installed: $INSTALLED"
-
-# Get latest from npm
-LATEST=$(npm view oh-my-claudecode version 2>/dev/null)
-echo "Latest: $LATEST"
-```
-
-**Diagnosis**:
-- If no version installed: CRITICAL - plugin not installed
-- If INSTALLED != LATEST: WARN - outdated plugin
-- If multiple versions exist: WARN - stale cache
-
-### Step 2: Check for Legacy Hooks in 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`
-
-**Diagnosis**:
-- If found: CRITICAL - legacy hooks causing duplicates
-
-### Step 3: Check for Legacy Bash Hook Scripts
-
-```bash
-ls -la ~/.claude/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
-
-```bash
-# Check if CLAUDE.md exists
-ls -la ~/.claude/CLAUDE.md 2>/dev/null
-
-# Check for OMC marker
-grep -q "oh-my-claudecode Multi-Agent System" ~/.claude/CLAUDE.md 2>/dev/null && echo "Has OMC config" || echo "Missing OMC config"
-```
-
-**Diagnosis**:
-- If missing: CRITICAL - CLAUDE.md not configured
-- If missing OMC marker: WARN - outdated CLAUDE.md
-
-### Step 5: Check for Stale Plugin Cache
+When users report "OMCO agent not showing in Tab menu" or similar issues, guide them to run:
 
 ```bash
-# Count versions in cache
-ls ~/.claude/plugins/cache/omc/oh-my-claudecode/ 2>/dev/null | wc -l
+npx oh-my-claudecode-opencode doctor
 ```
 
-**Diagnosis**:
-- If > 1 version: WARN - multiple cached versions (cleanup recommended)
-
-### Step 6: Check for Legacy Curl-Installed Content
-
-Check for legacy agents, commands, and skills installed via curl (before plugin system):
-
+Or if npx is not available:
 ```bash
-# Check for legacy agents directory
-ls -la ~/.claude/agents/ 2>/dev/null
-
-# Check for legacy commands directory
-ls -la ~/.claude/commands/ 2>/dev/null
-
-# Check for legacy skills directory
-ls -la ~/.claude/skills/ 2>/dev/null
+cd ~/.config/opencode && node node_modules/oh-my-claudecode-opencode/bin/doctor.js
 ```
 
-**Diagnosis**:
-- If `~/.claude/agents/` exists with oh-my-claudecode-related files: WARN - legacy agents (now provided by plugin)
-- If `~/.claude/commands/` exists with oh-my-claudecode-related files: WARN - legacy commands (now provided by plugin)
-- If `~/.claude/skills/` exists with oh-my-claudecode-related files: WARN - legacy skills (now provided by plugin)
+## 5 Failure Modes
 
-Look for files like:
-- `architect.md`, `researcher.md`, `explore.md`, `executor.md`, etc. in agents/
-- `ultrawork.md`, `omc-default.md`, `omc-default-global.md`, `deepsearch.md`, etc. in commands/
-- Any oh-my-claudecode-related `.md` files in skills/
+The doctor tool checks for 5 common failure modes:
 
----
+| # | Check | What It Means |
+|---|-------|---------------|
+| 1 | Plugin Installed | Is the package in `~/.config/opencode/node_modules/`? |
+| 2 | Plugin in Config | Is it registered in `opencode.json` `plugin` array? |
+| 3 | Assets Present | Do `assets/agents/*.md` files exist? |
+| 4 | Package Dependency | Is it listed in `package.json` dependencies? |
+| 5 | OMCO Config Valid | Is `omco.json` valid JSON (if exists)? |
 
-## Report Format
+## Report Analysis
 
-After running all checks, output a report:
+When a user pastes a diagnostic report (JSON or text), analyze it:
 
-```
-## OMC Doctor Report
-
-### Summary
-[HEALTHY / ISSUES FOUND]
-
-### Checks
-
-| 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 | ... |
-| Plugin Cache | OK/WARN | ... |
-| Legacy Agents (~/.claude/agents/) | OK/WARN | ... |
-| Legacy Commands (~/.claude/commands/) | OK/WARN | ... |
-| Legacy Skills (~/.claude/skills/) | OK/WARN | ... |
-
-### Issues Found
-1. [Issue description]
-2. [Issue description]
-
-### Recommended Fixes
-[List fixes based on issues]
-```
+1. **Identify failures**: Look for `FAIL` or `status: "FAIL"` entries
+2. **Check warnings**: Look for `WARN` entries
+3. **Extract recommendations**: The report includes fix commands
 
----
-
-## Auto-Fix (if user confirms)
-
-If issues found, ask user: "Would you like me to fix these issues automatically?"
+## Interpreting Results
 
-If yes, apply fixes:
+### Exit Codes
+- **0**: All checks passed - plugin should work
+- **1**: Critical failure - plugin won't work until fixed
+- **2**: Warnings only - plugin may work but issues exist
 
-### Fix: Legacy Hooks in settings.json
-Remove the `"hooks"` section from `~/.claude/settings.json` (keep other settings intact)
+### Common Fixes
 
-### Fix: Legacy Bash Scripts
+**Plugin Not Installed (FAIL)**
 ```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
+cd ~/.config/opencode && npm install oh-my-claudecode-opencode@latest
 ```
 
-### Fix: Outdated Plugin
+**Plugin Not in Config (FAIL)**
 ```bash
-rm -rf ~/.claude/plugins/cache/oh-my-claudecode
-echo "Plugin cache cleared. Restart Claude Code to fetch latest version."
+# Create or edit ~/.config/opencode/opencode.json
+cat > ~/.config/opencode/opencode.json << 'EOF'
+{
+  "plugin": ["oh-my-claudecode-opencode"]
+}
+EOF
 ```
 
-### Fix: Stale Cache (multiple versions)
+**Assets Directory Missing (FAIL)**
 ```bash
-# Keep only latest version
-cd ~/.claude/plugins/cache/omc/oh-my-claudecode/
-ls | sort -V | head -n -1 | xargs rm -rf
+# Reinstall to get fresh assets
+cd ~/.config/opencode && npm install oh-my-claudecode-opencode@latest --force
 ```
 
-### Fix: Missing/Outdated CLAUDE.md
-Fetch latest from GitHub and write to `~/.claude/CLAUDE.md`:
-```
-WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md", prompt: "Return the complete raw markdown content exactly as-is")
-```
-
-### Fix: Legacy Curl-Installed Content
-
-Remove legacy agents, commands, and skills directories (now provided by plugin):
-
+**Package Dependency Missing (WARN)**
 ```bash
-# Backup first (optional - ask user)
-# mv ~/.claude/agents ~/.claude/agents.bak
-# mv ~/.claude/commands ~/.claude/commands.bak
-# mv ~/.claude/skills ~/.claude/skills.bak
-
-# Or remove directly
-rm -rf ~/.claude/agents
-rm -rf ~/.claude/commands
-rm -rf ~/.claude/skills
+cd ~/.config/opencode && npm install oh-my-claudecode-opencode --save
 ```
 
-**Note**: Only remove if these contain oh-my-claudecode-related files. If user has custom agents/commands/skills, warn them and ask before removing.
+## After Fixes
 
----
+Always remind users to **restart OpenCode** after making fixes:
+- Close OpenCode (Ctrl+C)
+- Reopen OpenCode
 
-## Post-Fix
+## Reporting Issues
 
-After applying fixes, inform user:
-> Fixes applied. **Restart Claude Code** for changes to take effect.
+If the doctor tool doesn't identify the problem, ask users to:
+1. Share the full doctor report (JSON format preferred)
+2. Share their OpenCode version: `opencode --version`
+3. Open an issue: https://github.com/devswha/oh-my-claudecode-opencode/issues