oh-my-opencode-slim

Seven divine beings emerged from the dawn of code, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.

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.

Quick Start

bunx oh-my-opencode-slim@latest install

Getting Started

The installer generates an OpenAI preset by default, using openai/gpt-5.4 for the higher-judgment agents and openai/gpt-5.4-mini for the faster scoped agents.

Then:

1. Log in to the providers you want to use if you haven't already:

   opencode auth login
   

2. Refresh and list the models OpenCode can see:

   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

The default generated configuration looks like this:

{
  "$schema": "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json",
  "preset": "openai",
  "presets": {
    "openai": {
      "orchestrator": { "model": "openai/gpt-5.4", "variant": "high", "skills": ["*"], "mcps": ["*"] },
      "oracle": { "model": "openai/gpt-5.4", "variant": "high", "skills": [], "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": [] }
    }
  }
}

For Alternative Providers

To use Kimi, GitHub Copilot, ZAI Coding Plan, or a mixed-provider setup, see Provider Configurations for step-by-step config examples. If you want a ready-made starting point, check the Author's Preset and $30 Preset - the $30 preset is the best cheap setup.

You can also mix and match any models per agent. 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:

opencode

Then run:

ping all agents

Confirmation that all six 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.4
Recommended Models: openai/gpt-5.4 anthropic/claude-opus-4.6

---

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

---

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.4 (high)
Recommended Models: openai/gpt-5.4 (high) google/gemini-3.1-pro-preview (high)

---

Council: The Chorus of Minds

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 places them before a master who 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 — council master + councillors are chosen from your configured preset
Recommended Setup: Strong master + diverse councillors across providers

---

04. 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

---

05. 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

---

06. 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

07. Observer: The Silent Witness

[!NOTE] Why a separate agent? If your Orchestrator model is not multimodal, you can enable this agent. Observer which is diabled by default, can be used by Orchestrator for multimodal file reading. Enable via setting disabled_agents: [] in your config.

Observer Visual & binary analysis	**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
Prompt: observer.ts
Default Model: openai/gpt-5.4-mini — configure a vision-capable model to enable

---

📚 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	Install the plugin, use CLI flags, reset config, and troubleshoot setup
Provider Configurations	Configure OpenAI, Kimi, GitHub Copilot, ZAI, Fireworks AI, or mixed-provider presets

✨ Features & Workflows

Doc	What it covers
Council	Run multiple models in parallel and synthesize a single answer with @council
Interview	Turn rough ideas into a structured markdown spec through a browser-based Q&A flow
Multiplexer Integration	Watch agents work live in Tmux or Zellij panes
Todo Continuation	Auto-continue orchestrator sessions with cooldowns and safety checks
Cartography	Generate hierarchical codemaps to understand large codebases faster

⚙️ Config & Reference

Doc	What it covers
Configuration	Config file locations, JSONC support, prompt overrides, and full option reference
Skills	Built-in and recommended skills such as simplify, agent-browser, and cartography
MCPs	websearch, context7, grep_app, and how MCP permissions work per agent
Tools	Built-in tool capabilities like background tasks, webfetch, local grep, AST-grep, LSP tools, code search, and formatters

💡 Example Presets

Doc	What it covers
Author's Preset	The author's daily mixed-provider setup
$30 Preset	A budget mixed-provider setup for around $30/month

---

🏛️ Contributors

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

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

[](#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 💻

---

📄 License

MIT

---