Oh My OpenCode
The specialized orchestration layer for OpenCode. Batteries-included agents, hooks, and workflows that understand your build pipeline.
Why Oh My OpenCode?
A specialized orchestration layer that sits on top of OpenCode. Uses modular workflows with specialized agents that understand complex build pipelines and multi-repo structures.
🚀 Multi-Agent Orchestration
Modular workflow assigns specialized tasks to different agents working in parallel. One plans architecture, another writes code, another manages build integration.
Learn more →⚡ Batteries-Included
Everything you need is baked in. From agents to hooks, MCPs to LSP support - just install and go.
Explore features →🏗️ Build Pipeline Aware
Understands complex repo structures, build systems, and multi-folder setups. Handles Hugo/React hybrids, Vite configs, and custom build scripts automatically.
See real examples →🔧 Highly Configurable
Customize every aspect to fit your workflow. Agents, hooks, MCPs, LSP servers - all configurable.
Configure now →🤖 Powerful Agents
Meet Sisyphus and other specialized agents. Each designed for specific tasks and workflows.
Meet the agents →📚 Rich Documentation
Comprehensive guides, examples, and API documentation to help you get the most out of Oh My OpenCode.
Read docs →Quick Start
Get up and running in minutes. Install OpenCode first, then add the Oh My OpenCode plugin.
# First, install OpenCode
curl -fsSL https://opencode.ai/install | bash
# Then install Oh My OpenCode plugin
bunx oh-my-opencode install
# Or using npm
npm install -g oh-my-opencode
# Launch OpenCode in your project
opencodeStart Here: Popular Pages
New to Oh My OpenCode? These pages get you up to speed and send traffic to the right place.
📥 Installation
Full installation guide: OpenCode first, then Oh My OpenCode via bunx or npm. Verification, troubleshooting, and next steps.
Installation Guide →📘 OpenCode Tutorial
From zero to a working session: prerequisites, install steps, first project, configuration basics, and your first task.
Read Tutorial →❓ FAQ
Does it replace OpenCode? Config compatibility? OpenCode vs Cursor? Language support? All answered here.
FAQ →🎯 Use Cases
When to use Oh My OpenCode: monorepos, hybrid stacks, build pipelines, team workflows, and complex AI tasks.
Use Cases →⚖️ Oh My OpenCode vs OpenCode
What the plugin adds: comparison table, when to use plain OpenCode vs the orchestration layer.
Comparison →🧩 Best OpenCode Plugins
Where Oh My OpenCode fits among MCPs, LSP servers, and other OpenCode plugins and extensions.
Plugins Guide →Explore Our Features
Discover the powerful capabilities that make Oh My OpenCode the best agent harness
Intelligent Agents
Meet Sisyphus, Librarian, Explore, and Oracle - specialized agents designed for different development tasks. Each agent brings unique capabilities to enhance your workflow.
- Planner-Sisyphus (default)
- Code exploration
- Documentation management
- Question answering
Powerful Hooks
20+ built-in hooks that automate and enhance your workflow. From context management to session recovery, hooks keep everything running smoothly.
- 20+ built-in hooks
- Context window management
- Session recovery
- Task continuation
MCP Integration
Model Context Protocol integration for enhanced capabilities. Access up-to-date documentation and ultra-fast code search across millions of repositories.
- Context7 (enabled by default)
- grep.app integration
- Up-to-date documentation
- Ultra-fast code search
LSP Support
Full Language Server Protocol support with refactoring tools. Get code analysis, type checking, and powerful refactoring capabilities.
- Code analysis
- Refactoring tools
- Custom LSP servers
- Priority management
Experimental Features
Early access to cutting-edge capabilities. Preemptive compaction, aggressive truncation, auto-resume, and DCP for advanced users.
- Preemptive compaction
- Auto-resume sessions
- DCP for compaction
- Advanced truncation
Configuration
Highly configurable to fit your workflow. Customize agents, hooks, MCPs, LSP servers, and experimental features with simple JSON configuration.
- Simple JSON config
- Project-specific settings
- User-wide defaults
- Full customization
Additional Capabilities
Automatic recovery from errors and interruptions
Smart compaction and truncation to stay within limits
Work with Claude, GPT, Gemini, and 75+ providers through OpenCode
Automatic agent injection based on directory structure
Guides & Learning
Deep dives for developers evaluating OpenCode, Oh My OpenCode, and other AI coding tools
📘 OpenCode Tutorial
Step-by-step tutorial to install OpenCode, add Oh My OpenCode, and run your first AI coding session with Sisyphus.
Read tutorial →⚖️ OpenCode vs Cursor
Compare open source OpenCode + Oh My OpenCode with Cursor and similar IDE-focused tools.
View comparison →🧩 Best OpenCode Plugins
See where Oh My OpenCode fits among the best OpenCode plugins, MCPs, and LSP servers.
Browse plugins guide →⌨️ OpenCode CLI Commands
Common OpenCode CLI commands: opencode init, opencode --agent, version. How Oh My OpenCode works with the CLI.
CLI Reference →🔄 OpenCode Alternatives
Compare OpenCode with Cursor and other AI coding tools. When Oh My OpenCode fits.
Alternatives →Built on OpenCode
Oh My OpenCode extends the open source AI coding agent trusted by 650,000+ developers monthly
60K+ GitHub Stars
OpenCode has over 60,000 stars, 500 contributors, and 6,500+ commits. Oh My OpenCode brings specialized orchestration to this ecosystem.
75+ Model Providers
Connect any model from any provider through OpenCode, including Claude, GPT, Gemini, and 75+ LLM providers via Models.dev.
Privacy First
OpenCode doesn't store your code or context data. Oh My OpenCode maintains this privacy-first approach while adding powerful orchestration.
What Is Oh My OpenCode, Really?
Oh My OpenCode is a batteries‑included orchestration layer for OpenCode. Instead of being yet another generic AI coding tool, it wraps the official OpenCode runtime with opinionated agents, hooks, MCPs, and configuration so you get reliable multi‑agent workflows out of the box.
In practical terms, Oh My OpenCode turns OpenCode into a production‑ready agent harness. The plugin understands multi‑repo layouts, hybrid Hugo/React/Vite stacks, and custom build pipelines. It is designed for developers who don’t just want code completion, but an assistant that can touch Vite configs, Hugo templates, Node services, and CI scripts in a single guided flow.
If you already use OpenCode, adopting Oh My OpenCode is a small step in setup and a big step in stability. You keep the same models and the same CLI, but gain curated defaults: a planner agent that actually finishes tasks, context‑management hooks that prevent token blow‑ups, and MCP integrations for docs and code search that are wired in correctly from day one. You can install the plugin in minutes and customize it later through simple JSON configuration files.
When You Should Use Oh My OpenCode
- Complex repositories and pipelines – monorepos, hybrid static/SPA sites, or anything with multiple build steps and custom scripts.
- Limited time to babysit agents – you want guard‑railed workflows that recover from errors automatically and enforce task completion.
- Multi‑model setups – you already use Claude, GPT, Gemini or others through OpenCode and need sane orchestration on top.
- Team workflows – you want configuration that can be checked into the repo and shared across a team for consistent behavior.
- Exploring large or legacy codebases – you rely on agents, hooks, MCPs, and LSP support to understand unfamiliar projects safely.
Oh My OpenCode vs. Plain OpenCode
Out of the box, OpenCode gives you a powerful, model‑agnostic coding agent. Oh My OpenCode layers on opinionated defaults learned from real projects: which hooks to enable, how to configure LSP servers, how to wire MCPs, and how to structure agents around the realities of large codebases. You can think of it as a “distribution” of OpenCode: same core, but preconfigured for serious day‑to‑day work.
Frequently Asked Questions
Does Oh My OpenCode replace OpenCode?
No. Oh My OpenCode is a plugin that runs on top of OpenCode. You install OpenCode first, then add this plugin to orchestrate agents, hooks, MCPs, and LSP more intelligently. If you uninstall the plugin, your core OpenCode setup continues to work as before.
Will it work with my existing OpenCode configuration?
Yes. Oh My OpenCode respects existing opencode.json settings and extends them through its own
oh-my-opencode.json files. You can adopt it incrementally: start with defaults, then layer on project‑specific
configuration as your needs grow.
Is it only for TypeScript or JavaScript projects?
No. The orchestration layer is language‑agnostic. Through LSP and MCPs you can use it with TypeScript, Python, Rust, Go, and any other language supported by your configured language servers. The focus is on build pipelines and repo structure, not one language.
How is this different from IDE‑integrated AI features?
Most IDE features focus on inline completions. Oh My OpenCode focuses on project‑level workflows: multi‑file refactors, build pipeline changes, documentation updates, and cross‑repo edits coordinated by specialized agents and hooks.
Can I turn features off if they don’t match my workflow?
Yes. Every major capability—agents, hooks, MCPs, LSP servers, and experimental options—can be enabled or disabled via JSON configuration. You can keep the core orchestration benefits while trimming anything that doesn’t fit your team or environment.
Learn More
FAQ, use cases, and how Oh My OpenCode compares to plain OpenCode
❓ FAQ
Common questions about installation, configuration, agents, and compatibility. OpenCode plugin, Cursor comparison, troubleshooting.
Read FAQ →🎯 Use Cases
When to use Oh My OpenCode: monorepos, hybrid Hugo/React/Vite stacks, build pipelines, team workflows, and complex AI coding tasks.
View Use Cases →⚖️ Oh My OpenCode vs OpenCode
What's the difference? When to use the plugin. Comparison table, plain OpenCode vs orchestration layer.
See Comparison →Get Involved
Join our community and contribute
🌟 Star on GitHub
Show your support by starring the repository. Part of the growing OpenCode ecosystem with 60K+ stars.
Star Repository →🤝 Contribute
Got a better idea? PRs are welcome! Check out our contributing guidelines.
Contribute →