|
| 1 | +# Oh My OpenCode Super-Expert |
| 2 | + |
| 3 | +A Claude Desktop Project for becoming an expert on [Oh-My-OpenCode](https://github.com/code-yeongyu/oh-my-opencode) - the "oh-my-zsh" for AI coding assistants. |
| 4 | + |
| 5 | +## What is this? |
| 6 | + |
| 7 | +This project provides comprehensive reference documentation for Claude Desktop to answer questions about Oh-My-OpenCode (OMO). Upload these files to a Claude Desktop project to get expert-level assistance with: |
| 8 | + |
| 9 | +- Configuring agents and model overrides |
| 10 | +- Understanding the agent delegation system |
| 11 | +- Troubleshooting API credit issues |
| 12 | +- Using skills, hooks, and MCPs |
| 13 | +- Following best practices and avoiding anti-patterns |
| 14 | + |
| 15 | +## Files |
| 16 | + |
| 17 | +| File | Purpose | |
| 18 | +|------|---------| |
| 19 | +| `project-instructions.md` | **Upload to Claude Project settings** - Concise instructions for Claude | |
| 20 | +| `oh-my-opencode-super-expert.md` | Comprehensive 800+ line reference guide | |
| 21 | +| `models_overrides.md` | Complete model override configurations (especially for Antigravity) | |
| 22 | +| `update-prompt.md` | Instructions for updating docs when OMO changes | |
| 23 | + |
| 24 | +## Setup |
| 25 | + |
| 26 | +### 1. Create a Claude Desktop Project |
| 27 | + |
| 28 | +1. Open [Claude Desktop](https://claude.ai) |
| 29 | +2. Create a new Project called "Oh My OpenCode Expert" |
| 30 | +3. Go to Project Settings |
| 31 | + |
| 32 | +### 2. Add Project Instructions |
| 33 | + |
| 34 | +Copy the contents of `project-instructions.md` into the **Custom Instructions** field. |
| 35 | + |
| 36 | +### 3. Add Knowledge Files |
| 37 | + |
| 38 | +Upload these files to the project's **Knowledge** section: |
| 39 | +- `oh-my-opencode-super-expert.md` |
| 40 | +- `models_overrides.md` |
| 41 | + |
| 42 | +### 4. Start Asking Questions |
| 43 | + |
| 44 | +Now you can ask Claude about: |
| 45 | +- "How do I configure all agents to use Antigravity models?" |
| 46 | +- "What's the correct config key for Metis?" |
| 47 | +- "How do I delegate frontend work properly?" |
| 48 | +- "What anti-patterns should I avoid?" |
| 49 | + |
| 50 | +## Key Features Covered |
| 51 | + |
| 52 | +### Agent System |
| 53 | +11 specialized agents including Sisyphus (orchestrator), Oracle (debugger), Librarian (researcher), and more. |
| 54 | + |
| 55 | +### Model Overrides |
| 56 | +Complete configurations for: |
| 57 | +- **Google Antigravity** - Use Claude/Gemini via Google quota (no API keys!) |
| 58 | +- Direct API providers (Anthropic, OpenAI, Google) |
| 59 | +- Custom model assignments per agent |
| 60 | + |
| 61 | +### Critical Knowledge |
| 62 | + |
| 63 | +**Agent Config Keys (EXACT format required):** |
| 64 | +| Agent | Config Key | |
| 65 | +|-------|------------| |
| 66 | +| Sisyphus | `Sisyphus` | |
| 67 | +| Prometheus | `Prometheus (Planner)` | |
| 68 | +| Metis | `Metis (Plan Consultant)` | |
| 69 | +| Momus | `Momus (Plan Reviewer)` | |
| 70 | +| Oracle | `oracle` | |
| 71 | + |
| 72 | +> **Warning**: Using wrong keys like `metis` instead of `Metis (Plan Consultant)` will cause overrides to silently fail! |
| 73 | +
|
| 74 | +## Keeping Documentation Updated |
| 75 | + |
| 76 | +When Oh-My-OpenCode releases new versions: |
| 77 | + |
| 78 | +1. Pull latest changes to your local OMO repo |
| 79 | +2. Use the prompt in `update-prompt.md` to regenerate documentation |
| 80 | +3. Re-upload updated files to your Claude project |
| 81 | + |
| 82 | +## Related Links |
| 83 | + |
| 84 | +- [Oh-My-OpenCode Repository](https://github.com/code-yeongyu/oh-my-opencode) |
| 85 | +- [OpenCode](https://github.com/sst/opencode) |
| 86 | +- [Antigravity Auth Plugin](https://github.com/NoeFabris/opencode-antigravity-auth) |
| 87 | + |
| 88 | +## License |
| 89 | + |
| 90 | +MIT |
| 91 | + |
| 92 | +--- |
| 93 | + |
| 94 | +*Based on Oh-My-OpenCode commit: `abd1ec109264611474120a8136ebc3ae59b8a20f`* |
0 commit comments