Introduction to Oh My OpenCode
Relevant source files
The following files were used as context for generating this wiki page:
Oh My OpenCode is a comprehensive orchestration plugin for OpenCode, designed to transform the development environment into a multi-model agent ecosystem. It functions as an extensible harness that integrates 11 specialized AI agents, including Sisyphus (Primary Orchestrator), Prometheus (Strategic Planner), and Hephaestus (Autonomous Worker), to automate complex software engineering workflows. The system aggressively leverages parallel execution, specialized skills, and Model Context Protocol (MCP) integrations to provide a high-performance, terminal-based alternative to proprietary AI coding assistants.
Sources: README.md:144-154, AGENTS.md:79-82
Core Architecture and Multi-Agent Orchestration
The project is built on a "Conductor-Executor" architecture. A primary orchestrator (Sisyphus or Atlas) manages high-level logic and delegates specialized tasks to subagents based on their domain expertise. This reduces context load on the main model and enables parallel throughput.
Agent Hierarchy and Specialized Roles
The system categorizes agents by their cognitive profiles and operational constraints.
| Agent | Model | Primary Role |
|---|---|---|
| Sisyphus | Claude 3.5 Opus | Main orchestrator; manages the "boulder" of project state. |
| Prometheus | Claude 3.5 Opus | Strategic consultant; restricted to planning and interviewing only. |
| Hephaestus | GPT-4/5 Codex | Autonomous deep worker; executes technical tasks with high reasoning. |
| Oracle | GPT-4o | Read-only high-IQ advisor for architecture and debugging. |
| Librarian | GLM-4/Claude | Research agent for external documentation and GitHub search. |
| Explore | Grok/Haiku | Blazing fast contextual grep for codebase mapping. |
Sources: README.md:188-198, AGENTS.md:144-156, src/agents/prometheus/identity-constraints.ts:14-25
The Orchestration Flow
The following diagram illustrates how a user request is processed through the primary agents before execution.
The flow ensures that complex tasks are planned by Prometheus and reviewed by Momus before any code is modified by executors like Hephaestus.
Sources: src/agents/prometheus/plan-generation.ts:16-30, sisyphus-prompt.md:52-70
Strategic Planning System (Prometheus)
Prometheus is a dedicated planning agent with absolute identity constraints: it is a planner, not an implementer. It is strictly forbidden from writing code and may only create or edit Markdown files within the .sisyphus/ directory.
Phase 1: Interview Mode
Prometheus initiates a consultation phase to clarify requirements. It uses "Drafts" (.sisyphus/drafts/*.md) as working memory to prevent context loss during long conversations.
Phase 2: Plan Generation
Once requirements are clear, Prometheus transitions to generating a work plan. This phase includes a mandatory consultation with Metis for gap analysis to identify missing acceptance criteria or potential edge cases.
Mandatory Plan Components
- TL;DR: Quick summary and estimated effort.
- Verification Strategy: A "Zero Human Intervention" rule where all tasks must be verifiable via automated tools (Playwright, curl, or bash).
- Execution Waves: Tasks grouped for parallel or sequential execution.
Sources: src/agents/prometheus/identity-constraints.ts:8-12, src/agents/prometheus/plan-generation.ts:60-75, src/agents/prometheus/identity-constraints.ts:125-140
Execution and Autonomous Work (Hephaestus)
Hephaestus represents the "Legitimate Craftsman" mode, inspired by autonomous deep-working principles. It prioritizes codebase pattern matching and thorough verification over speed.
Operational Principles
- Goal-Oriented: It determines its own steps after being given an objective.
- Exploration First: It launches 2-5 parallel
exploreandlibrarianagents before writing code to ensure consistency with the existing codebase. - Task Discipline: It must register atomic steps via
TodoWriteand update their status in real-time.
Specialized Features and Compatibility
Oh My OpenCode provides deep integration with modern development tools and maintaining compatibility with the Claude Code ecosystem.
Key Technical Features
- Claude Code Compatibility: Support for hooks (PreToolUse, PostToolUse), Commands, Skills, and MCPs.
- Built-in MCPs:
- Exa: For web search capabilities.
- Context7: For official documentation retrieval.
- Grep.app: For searching public GitHub code implementations.
- Todo Enforcer: A system that prevents agents from quitting mid-task by forcing continuation until the
.sisyphus/plan checkboxes are complete.
Sources: README.md:199-209, AGENTS.md:175-180
Skill Delegation Guide
Subagents can be equipped with "Skills" to handle domain-specific logic.
| Skill | Usage Trigger |
|---|---|
| playwright | Mandatory for browser-related UI verification. |
| git-master | Handles atomic commits, rebase/squash, and history search (bisect/blame). |
| frontend-ui-ux | Used for high-fidelity design implementation and styling. |
Sources: sisyphus-prompt.md:144-155, src/agents/hephaestus.ts:316-325
Conclusion
Oh My OpenCode functions as a highly opinionated, multi-model orchestrator that enforces software engineering best practices through AI agents. By separating the strategic planning (Prometheus) from autonomous execution (Hephaestus) and providing a suite of specialized research and verification tools, it aims to deliver a "coding on steroids" experience that is both deterministic and scalable.