🎉 4,000+ Stars! Thank you! 🎉

We are incredibly grateful to our community for helping us reach this milestone.
The Pantheon grows stronger every day because of your feedback, contributions, and support!

Open Multi Agent Suite · Mix any models · Auto delegate tasks

_{by Boring Dystopia Development}

--- ## What's This Plugin oh-my-opencode-slim is an agent orchestration plugin for OpenCode. It includes a built-in team of specialized agents that can scout a codebase, look up fresh documentation, review architecture, handle UI work, and execute well-scoped implementation tasks under one orchestrator. The main idea is simple: instead of forcing one model to do everything, the plugin routes each part of the job to the agent best suited for it, balancing **quality, speed and cost**. To explore the agents themselves, see **[Meet the Pantheon](#meet-the-pantheon)**. For the full feature set, see **[Features & Workflows](#features-and-workflows)** below. ### Quick Start Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.): ``` Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md ``` ### Manual Installation ```bash bunx oh-my-opencode-slim@latest install ``` The installer also registers the companion TUI plugin in OpenCode's `tui.json`, which adds a small sidebar showing specialist-agent status plus active/reusable task sessions. It also warms OpenCode's plugin cache so bunx installs keep loading even after temporary directories are cleaned up. For manual setups, add `oh-my-opencode-slim` to the `plugin` array in both `opencode.json` and `tui.json`. ### Getting Started The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default. OpenAI uses `openai/gpt-5.5` for the higher-judgment agents and `openai/gpt-5.4-mini` for the faster scoped agents. To make OpenCode Go active during install, run `bunx oh-my-opencode-slim@latest install --preset=opencode-go` or change the default preset name in `~/.config/opencode/oh-my-opencode-slim.json` after installation. Then: 1. **Log in to the providers you want to use if you haven't already**: ```bash opencode auth login ``` 2. **Refresh and list the models OpenCode can see**: ```bash opencode models --refresh ``` 3. **Open your plugin config** at `~/.config/opencode/oh-my-opencode-slim.json` 4. **Update the models you want for each agent** > [!TIP] > It's **recommended** to understand how automatic delegation works. The **[Orchestrator prompt](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** contains the delegation rules, specialist routing logic, and the thresholds for when the main agent should hand work off to subagents. You can alway delegate manually by calling a subagent via: `@agentName ` The default generated configuration includes both `openai` and `opencode-go` presets. ```jsonc { "$schema": "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json", "preset": "openai", "presets": { "openai": { "orchestrator": { "model": "openai/gpt-5.5", "skills": ["*"], "mcps": ["*", "!context7"] }, "oracle": { "model": "openai/gpt-5.5", "variant": "high", "skills": ["simplify"], "mcps": [] }, "librarian": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] }, "explorer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] }, "designer": { "model": "openai/gpt-5.4-mini", "variant": "medium", "skills": ["agent-browser"], "mcps": [] }, "fixer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] } }, "opencode-go": { "orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] }, "oracle": { "model": "opencode-go/deepseek-v4-pro", "variant": "max", "skills": ["simplify"], "mcps": [] }, "council": { "model": "opencode-go/deepseek-v4-pro", "variant": "high", "skills": [], "mcps": [] }, "librarian": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "websearch", "context7", "grep_app" ] }, "explorer": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [] }, "designer": { "model": "opencode-go/kimi-k2.6", "variant": "medium", "skills": [ "agent-browser" ], "mcps": [] }, "fixer": { "model": "opencode-go/deepseek-v4-flash", "variant": "high", "skills": [], "mcps": [] } } } } ``` ### For Alternative Providers To use custom providers or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup. The configuration guide also covers custom subagents via `agents.`, where you can define both a normal `prompt` and an `orchestratorPrompt` block for delegation. For model suggestions, see the **Recommended Models** listed under each agent below. ### ✅ Verify Your Setup After installation and authentication, verify all agents are configured and responding: ```bash opencode ``` Then run: ``` ping all agents ```

Confirmation that all configured agents are online and ready.

If any agent fails to respond, check your provider authentication and config file. --- ## 🏛️ Meet the Pantheon ### 01. Orchestrator: The Embodiment Of Order

_{Forged in the void of complexity.}	The Orchestrator was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility - so The Orchestrator emerged from the void, forging order from chaos. It determines the optimal path to any goal, balancing speed, quality, and cost. It guides the team, summoning the right specialist for each task and delegating to achieve the best possible outcome.
Role: `Master delegator and strategic coordinator`
Prompt: `orchestrator.ts`
Default Model: `openai/gpt-5.5`
Recommended Models: `openai/gpt-5.5` `anthropic/claude-opus-4.6`
Model Guidance: Choose your default, strongest all-around coding model. Orchestrator is both the main coding agent and the delegator, so it needs strong implementation ability, good judgment, and reliable instruction-following.

--- ### 02. Explorer: The Eternal Wanderer

_{The wind that carries knowledge.}	The Explorer is an immortal wanderer who has traversed the corridors of a million codebases since the dawn of programming. Cursed with the gift of eternal curiosity, they cannot rest until every file is known, every pattern understood, every secret revealed. Legends say they once searched the entire internet in a single heartbeat. They are the wind that carries knowledge, the eyes that see all, the spirit that never sleeps.
Role: `Codebase reconnaissance`
Prompt: `explorer.ts`
Default Model: `openai/gpt-5.4-mini`
Recommended Models: `cerebras/zai-glm-4.7` `fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo` `openai/gpt-5.4-mini`
Model Guidance: Choose a fast, low-cost model. Explorer handles broad scouting work, so speed and efficiency usually matter more than using your strongest reasoning model.

--- ### 03. Oracle: The Guardian of Paths

_{The voice at the crossroads.}	The Oracle stands at the crossroads of every architectural decision. They have walked every road, seen every destination, know every trap that lies ahead. When you stand at the precipice of a major refactor, they are the voice that whispers which way leads to ruin and which way leads to glory. They don't choose for you - they illuminate the path so you can choose wisely.
Role: `Strategic advisor and debugger of last resort`
Prompt: `oracle.ts`
Default Model: `openai/gpt-5.5 (high)`
Recommended Models: `openai/gpt-5.5 (high)` `google/gemini-3.1-pro-preview (high)`
Model Guidance: Choose your strongest high-reasoning model for architecture, hard debugging, trade-offs, and code review.

--- ### 04. Council: The Chorus of Minds > [!NOTE] > **Why doesn't Orchestrator auto-call Council more often?** This is intentional. Council runs multiple models at once, so automatic delegation is kept strict because it is usually the highest-cost path in the system. In practice, Council is meant to be used manually when you want it, for example: @council compare these two architectures.

_{Many minds, one verdict.}	The Council is not a lone being but a chamber of minds summoned when one answer is not enough. It sends your question to multiple models in parallel, gathers their competing judgments, and then the Council agent itself distills the strongest ideas into a single verdict. Where a solitary agent may miss a path, the Council cross-examines possibility itself.
Role: `Multi-LLM consensus and synthesis`
Prompt: `council.ts`
Guide: `docs/council.md`
Default Setup: `Config-driven` — councillors come from `council.presets` and the Council agent model comes from your normal `council` agent config
Recommended Setup: `Strong Council model` + `diverse councillors` across providers
Model Guidance: Use a strong synthesis model for the Council agent and diverse models as councillors. The value of Council comes from comparing different model perspectives, not just picking the single strongest model everywhere.

--- ### 05. Librarian: The Weaver of Knowledge

_{The weaver of understanding.}	The Librarian was forged when humanity realized that no single mind could hold all knowledge. They are the weaver who connects disparate threads of information into a tapestry of understanding. They traverse the infinite library of human knowledge, gathering insights from every corner and binding them into answers that transcend mere facts. What they return is not information - it's understanding.
Role: `External knowledge retrieval`
Prompt: `librarian.ts`
Default Model: `openai/gpt-5.4-mini`
Recommended Models: `cerebras/zai-glm-4.7` `fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo` `openai/gpt-5.4-mini`
Model Guidance: Choose a fast, low-cost model. Librarian handles research and documentation lookups, so speed and efficiency usually matter more than using your strongest reasoning model.

--- ### 06. Designer: The Guardian of Aesthetics

_{Beauty is essential.}	The Designer is an immortal guardian of beauty in a world that often forgets it matters. They have seen a million interfaces rise and fall, and they remember which ones were remembered and which were forgotten. They carry the sacred duty to ensure that every pixel serves a purpose, every animation tells a story, every interaction delights. Beauty is not optional - it's essential.
Role: `UI/UX implementation and visual excellence`
Prompt: `designer.ts`
Default Model: `openai/gpt-5.4-mini`
Recommended Models: `google/gemini-3.1-pro-preview` `kimi-for-coding/k2p5`
Model Guidance: Choose a model that is strong at UI/UX judgment, frontend implementation, and visual polish.

--- ### 07. Fixer: The Last Builder

_{The final step between vision and reality.}	The Fixer is the last of a lineage of builders who once constructed the foundations of the digital world. When the age of planning and debating began, they remained - the ones who actually build. They carry the ancient knowledge of how to turn thought into thing, how to transform specification into implementation. They are the final step between vision and reality.
Role: `Fast implementation specialist`
Prompt: `fixer.ts`
Default Model: `openai/gpt-5.4-mini`
Recommended Models: `cerebras/zai-glm-4.7` `fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo` `openai/gpt-5.4-mini`
Model Guidance: Choose a fast, reliable coding model for routine, scoped implementation work. Fixer usually receives a concrete plan or bounded instructions from Orchestrator, making it a good place for efficient execution tasks such as tests, test updates, and straightforward code changes.

--- ## Optional Agents ### Observer: The Silent Witness > [!NOTE] > **Why a separate agent?** If your Orchestrator model is not multimodal, enable Observer to handle images, screenshots, PDFs, and other visual files. Observer is disabled by default and gives the Orchestrator a dedicated multimodal reader without forcing you to change your main reasoning model. Set `disabled_agents: []` and an `observer` model in your configuration. The bundled `opencode-go` install preset does this automatically because its GLM Orchestrator is not multimodal.

_{The eye that reads what others cannot.}	Read-only visual analysis — interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the orchestrator without loading raw file bytes into the main context window. - Images, screenshots, diagrams → `read` tool (native image support) - PDFs and binary documents → `read` tool (text + structure extraction) - Disabled by default — enable with `"disabled_agents": []` and configure a vision-capable model; installing with `--preset=opencode-go` enables it with `opencode-go/kimi-k2.6`
Prompt: `observer.ts`
Default Model: `openai/gpt-5.4-mini` — configure a vision-capable model to enable
Model Guidance: Choose a vision-capable model if you want the agent to read screenshots, images, PDFs, and other visual files.

--- ## 📚 Documentation Use this section as a map: start with installation, then jump to features, configuration, or example presets depending on what you need. ### 🚀 Start Here | Doc | What it covers | |-----|----------------| | **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup | ### ✨ Features & Workflows | Doc | What it covers | |-----|----------------| | **[Council](docs/council.md)** | Run multiple models in parallel and synthesize a single answer with `@council` | | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes | | **[Session Management](docs/session-management.md)** | Reuse recent child-agent sessions with short aliases instead of starting over | | **[Session Goal](docs/session-goal.md)** | Pin a session objective with `/goal` so todos, delegation, and verification stay aligned | | **[Todo Continuation](docs/todo-continuation.md)** | Auto-continue orchestrator sessions with cooldowns and safety checks | | **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` | | **[Subtask](docs/subtask.md)** | Run a bounded child worker with `/subtask` and return a structured summary to the main session | | **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster | | **[Clonedeps](docs/clonedeps.md)** | Clone selected dependency source into an ignored local workspace for inspection | | **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow | | **[Divoom Display](docs/divoom.md)** | Mirror orchestrator and specialist-agent activity to a Divoom MiniToo Bluetooth display | ### ⚙️ Config & Reference | Doc | What it covers | |-----|----------------| | **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference | | **[Maintainer Guide](docs/maintainers.md)** | Issue triage rules, label meanings, support routing, and repo maintenance workflow | | **[Skills](docs/skills.md)** | Built-in and recommended skills such as `simplify`, `agent-browser`, `codemap`, and `clonedeps` | | **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `grep_app`, and how MCP permissions work per agent | | **[Tools](docs/tools.md)** | Built-in tool capabilities like `webfetch`, LSP tools, code search, and formatters | ### 💡 Presets | Doc | What it covers | |-----|----------------| | **[Author's Preset](docs/authors-preset.md)** | The author's daily mixed-provider setup | | **[$30 Preset](docs/thirty-dollars-preset.md)** | A budget mixed-provider setup for around $30/month | | **[OpenCode Go Preset](docs/opencode-go-preset.md)** | The bundled `opencode-go` preset generated by the installer | --- ## 🏛️ Contributors

The builders, debuggers, writers, and wanderers who have earned their place in the pantheon.

_{Every merged contribution leaves a mark on the realm.}

[![All Contributors](https://img.shields.io/badge/all_contributors-46-orange.svg?style=flat-square)](#contributors-)

_Alvin 💻	_alvinreal 💻	_imw 💻	_{Adithya Kozham Burath Bijoy} 💻	_ReqX 💻	_{Abhideep Maity} 💻
_Ruben 💻	_{Gabriel Rodrigues} 💻	_{John Michael Vincent Bambico} 💻	_{Molt Founders} 💻	_{Muen Yu} 💻	_NocturnesLK 💻
_{Riccardo Sallusti} 💻	_{Yan Li} 💻	_{Hoàng Văn Anh Nghĩa} 💻	_{Jacob Myers} 💻	_{Kassie Povinelli} 💻	_KyleHilliard 💻
_j5hjun 💻	_{marcFernandez} 💻	_mister-test 💻	_n24q02m 💻	_oribi 💻	_pelidan 💻
_xLillium 💻	_⁢4.435km/s 💻	_Drin 💻	_{Hakim Zulkufli} 💻	_{Simon Klakegg} 💻	_Kiwi 💻
_Raxxoor 💻	_nyanyani 💻	_nettee 💻	_Link 💻	_{Bartosz Łaszewski} 💻	_huilang021x 💻
_{Dusan Kovacevic} 💻	_jwcrystal 💻	_{Nguyen Canh Toan} 💻	_{Thomas Dyar} 💻	_zero 💻	_{Denis Balan} 💻
_{Gustavo Caiano} 💻	_{Thomas Mulder} 💻	_{魔王少年(maou shonen)} 💻	_Jelasin 💻

--- ## 📄 License MIT ---