Learn about Oh My OpenCode, a plugin that transforms OpenCode into the best agent harness.
Sisyphus agent strongly recommends Opus 4.5 model. Using other models may result in significantly degraded experience.
Feeling lazy? Just include ultrawork (or ulw) in your prompt. That's it. The agent figures out the rest.
Need precision? Press Tab to enter Prometheus (Planner) mode, create a work plan through an interview process, then run /start-work to execute it with full orchestration.
- Build features from descriptions: Just tell the agent what you want. It makes a plan, writes the code, and ensures it works. Automatically. You don't have to care about the details.
- Debug and fix issues: Describe a bug or paste an error. The agent analyzes your codebase, identifies the problem, and implements a fix.
- Navigate any codebase: Ask anything about your codebase. The agent maintains awareness of your entire project structure.
- Automate tedious tasks: Fix lint issues, resolve merge conflicts, write release notes - all in a single command.
If you're feeling lazy, just include ultrawork (or ulw) in your prompt:
ulw add authentication to my Next.js app
The agent will automatically:
- Explore your codebase to understand existing patterns
- Research best practices via specialized agents
- Implement the feature following your conventions
- Verify with diagnostics and tests
- Keep working until complete
This is the "just do it" mode. Full automatic mode. The agent is already smart enough, so it explores the codebase and make plans itself. You don't have to think that deep. Agent will think that deep.
For complex or critical tasks, press Tab to switch to Prometheus (Planner) mode.
How it works:
-
Prometheus interviews you - Acts as your personal consultant, asking clarifying questions while researching your codebase to understand exactly what you need.
-
Plan generation - Based on the interview, Prometheus generates a detailed work plan with tasks, acceptance criteria, and guardrails. Optionally reviewed by Momus (plan reviewer) for high-accuracy validation.
-
Run
/start-work- The Atlas takes over:- Distributes tasks to specialized sub-agents
- Verifies each task completion independently
- Accumulates learnings across tasks
- Tracks progress across sessions (resume anytime)
When to use Prometheus:
- Multi-day or multi-session projects
- Critical production changes
- Complex refactoring spanning many files
- When you want a documented decision trail
Do NOT use atlas without /start-work.
The orchestrator is designed to execute work plans created by Prometheus. Using it directly without a plan leads to unpredictable behavior.
Correct workflow:
1. Press Tab → Enter Prometheus mode
2. Describe work → Prometheus interviews you
3. Confirm plan → Review .sisyphus/plans/*.md
4. Run /start-work → Orchestrator executes
Prometheus and Atlas are a pair. Always use them together.
Oh My OpenCode automatically configures models based on your available providers. You don't need to manually specify every model.
1. At Installation Time (Interactive Installer)
When you run bunx oh-my-opencode install, the installer asks which providers you have:
- Claude Pro/Max subscription?
- OpenAI/ChatGPT Plus?
- Google Gemini?
- GitHub Copilot?
- OpenCode Zen?
- Z.ai Coding Plan?
Based on your answers, it generates ~/.config/opencode/oh-my-opencode.json with optimal model assignments for each agent and category.
2. At Runtime (Fallback Chain)
Each agent has a provider priority chain. The system tries providers in order until it finds an available model:
Example: multimodal-looker
google → openai → zai-coding-plan → anthropic → opencode
↓ ↓ ↓ ↓ ↓
gemini gpt-5.2 glm-4.6v haiku gpt-5-nano
If you have Gemini, it uses google/gemini-3-flash. No Gemini but have Claude? Uses anthropic/claude-haiku-4-5. And so on.
Here's a real-world config for a user with Claude, OpenAI, Gemini, and Z.ai all available:
Key points:
- You only need to override what you want to change
- Unspecified agents/categories use the automatic fallback chain
- Mix providers freely (Claude for main work, Z.ai for cheap tasks, etc.)
Run opencode models to see all available models in your environment. Model names follow the format provider/model-name.
For detailed configuration options including per-agent settings, category customization, and more, see the Configuration Guide.
- Understanding the Orchestration System - Deep dive into Prometheus → Orchestrator → Junior workflow
- Ultrawork Manifesto - Philosophy and principles behind Oh My OpenCode
- Installation Guide - Detailed installation instructions
- Configuration Guide - Customize agents, models, and behaviors
- Features Reference - Complete feature documentation
{ "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json", "agents": { // Override specific agents only - rest use fallback chain "atlas": { "model": "anthropic/claude-sonnet-4-5", "variant": "max" }, "librarian": { "model": "zai-coding-plan/glm-4.7" }, "explore": { "model": "opencode/gpt-5-nano" }, "multimodal-looker": { "model": "zai-coding-plan/glm-4.6v" } }, "categories": { // Override categories for cost optimization "quick": { "model": "opencode/gpt-5-nano" }, "unspecified-low": { "model": "zai-coding-plan/glm-4.7" } }, "experimental": { "aggressive_truncation": true } }