oh-my-opencode-slim

## 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**. The Orchestrator plans the work graph, dispatches specialists as background tasks, and reconciles their results before continuing. ### ✨ Highlights - **[Seven specialized agents](#meet-the-pantheon)** - Orchestrator, Explorer, Oracle, Council, Librarian, Designer, and Fixer. Each part of the job goes to the agent best suited for it - mix any models across any providers. - **[Background orchestration](docs/background-orchestration.md)** - the Orchestrator dispatches specialists as background tasks, tracks them, and reconciles results before continuing - parallel work by default. - **[Bundled skills](#skills)** - prompt-based workflows like `deepwork`, `codemap`, `verification-planning`, and `reflect`, assigned per agent. - **[Council](docs/council.md)** - run multiple models in parallel on the same question and synthesize a single answer with `@council`. - **[Companion](docs/companion.md)** - an optional floating desktop window showing which agents are active, including parallel background specialists. - **[Multiplexer integration](docs/multiplexer-integration.md)** - watch agents work live in Tmux, Zellij, Herdr, cmux, or kitty panes. - **[Preset switching](docs/preset-switching.md)** - swap the whole team's models at runtime with `/preset`. - **[Code intelligence tools](docs/tools.md)** - LSP tools, AST-aware search across 25 languages, and built-in MCPs for docs and GitHub code search. - **[Fully customizable](docs/configuration.md)** - custom agents, prompt overrides, per-agent skill/MCP permissions, and [project-local customization](docs/project-local-customization.md). ### What Users Say > “Task management went from 5/10 to 8-9/10 easily. The Orchestrator sends > Fixers and Explorers, and I can still talk and plan with the Orchestrator in > the same session. The experience feels way smoother now.” > > \- `vipor_idk` > “I ditched all my harnesses for this beta version of omo-slim and don't look > back or miss anything. Great work and IMHO all in the right direction.” > > \- `stephanschielke` > “I love omo-slim, and can't imagine running opencode without it. I love that I > can create a Frankenstein of models... Makes the setup such a beast.” > > \- `Capital-One3039` > “It has significantly improved my workflow... Now, it is working very > smoothly, and I love it.” > > \- `xenstar1` ### 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 published CLI is a Node-compatible bundle, so `npx` works too if you don't have Bun installed: ```bash npx oh-my-opencode-slim@latest install ``` ### Run from Master Use this if you want the latest code, easier bug fixes, or a local setup for development and contributions: ```bash git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim cd ~/repos/oh-my-opencode-slim bun install bun run build bun dist/cli/index.js install ``` The installer adds the local repo path to the `plugin` array in `~/.config/opencode/opencode.json`, so OpenCode loads the plugin from that folder. To update later: ```bash cd ~/repos/oh-my-opencode-slim git pull bun install bun run build ``` ### Getting Started The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default. > [!TIP] > Tune the models and agents for your own workflow. The defaults are only a > starting point; the plugin is designed for deep flexibility and customization. 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 background orchestration works. The **[Orchestrator prompt](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** contains the scheduler rules, specialist routing logic, and thresholds for when work should be assigned to background agents. You can always delegate manually by calling a subagent via: `@agentName ` > [!TIP] > Because background agents are now the default workflow, it is **highly recommended** to enable and configure **[Multiplexer Integration](docs/multiplexer-integration.md)**. It automatically opens each agent in a dedicated Tmux, Zellij, Herdr, cmux, or kitty pane, so you can watch specialists work live while the Orchestrator continues coordinating the session. The default generated configuration includes both `openai` and `opencode-go` presets. ``` … ``` ### Preset Docs Consider presets as guidelines as they are often outdated. - **[OpenAI Preset](docs/openai-preset.md)** — the default generated preset; runs all agents on OpenAI models. - **[OpenCode Go Preset](docs/opencode-go-preset.md)** — runs the agents on OpenCode Go models; enables the Observer agent for visual analysis since its orchestrator model isn't multimodal. - **[Author's Preset](docs/authors-preset.md)** — the exact config the author runs day to day, with third-party skills. - **[$30 Preset](docs/thirty-dollars-preset.md)** — a mixed-provider setup built around Codex Plus and GitHub Copilot Pro for about $30/month. - **[OpenCode Zen Free Preset](docs/opencode-zen-free-preset.md)** — every agent runs on an opencode free model; no usage cost. ### For Alternative Providers To use custom providers or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. ### ✅ Verify Your Setup After installation and authentication, verify all agents are configured and responding: ```bash opencode ``` Then run: ``` ping all agents ``` 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.6-terra (medium)
Recommended Models: claude-fable-5 claude-opus-4-8 glm-5.2 gpt-5.6-terra mimo-v2.5 minimax-m3 qwen3.7-plus
Model Guidance: Choose your strongest planning and judgment model. Orchestrator is the workflow manager: it plans, schedules background specialists, reconciles results, and verifies outcomes, so it needs reliable instruction-following and high-level technical judgment more than raw worker throughput.

--- ### 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.6-luna
Recommended Models: deepseek-v4-flash gpt-5.3-codex
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.6-sol (high)
Recommended Models: claude-fable-5 claude-opus-4-8 deepseek-v4-pro glm-5.2 gpt-5.6-sol qwen3.7-max
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