*Transform your AI assistant into a manager capable of delegating complex tasks to specialized sub-agents, running searches in the background, and managing multi-step workflows with ease.*
*Transform your AI assistant into a manager capable of delegating complex tasks to specialized sub-agents, running searches in the background, and managing multi-step workflows with ease.*
> **💡 Tip: Models are fully customizable.** The installer sets sensible defaults, but you can assign *any* model to *any* agent. Edit `~/.config/opencode/oh-my-opencode-slim.json` to override models, adjust reasoning effort, or disable agents entirely. See [Configuration](#configuration) for details.
**Alternative: Ask any coding agent**
Paste this into Claude Code, AmpCode, Cursor, or any coding agent:
```
Install and configure by following the instructions here:
https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md
```
### For LLM Agents
1. **User Prompt**: "Refactor the auth logic and update the docs."
2. **Orchestrator**: Creates a TODO list.
3. **Delegation**:
- Launches an `@explorer` background task to find all auth-related files.
- Launches a `@librarian` task to check the latest documentation for the auth library used.
4. **Integration**: Once background results are ready, the Orchestrator delegates to `@fixer` to perform the refactor efficiently.
---
## Meet the Pantheon
> **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. They don't merely command armies; they fight alongside them. Every line of code passes through their hands before they decide which lesser deity deserves a piece of the puzzle.
**Role:** `Supreme executor, delegator, and overseer`
**Model:** `google/claude-opus-4-5-thinking`
**Prompt:** [src/agents/orchestrator.ts](src/agents/orchestrator.ts)
Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. *Shape reality directly - and assign realms to others when the universe grows too vast.*
> **The Explorer** moves through codebases like wind through trees - swift, silent, everywhere at once. When The Orchestrator whispers "find me the auth module," The Explorer has already returned with forty file paths and a map. They were born from the first `grep` command, evolved beyond it, and now see patterns mortals miss.
**Role:** `Codebase reconnaissance`
**Model:** `google/gemini-3-flash`
**Prompt:** [src/agents/explorer.ts](src/agents/explorer.ts)
Regex search, AST pattern matching, file discovery, parallel exploration. *Read-only: they chart the territory; others conquer it.*
> **The Oracle** does not code - they *know*. When bugs defy logic and architectures crumble, The Oracle gazes into the abyss of your codebase and speaks truth. They've seen a thousand systems rise and fall. They'll tell you which path leads to ruin, and which to production.
**Role:** `Strategic advisor and debugger of last resort`
**Model:** `openai/gpt-5.2-codex`
**Prompt:** [src/agents/oracle.ts](src/agents/oracle.ts)
Root cause analysis, architecture review, debugging guidance, tradeoff analysis. *Read-only: Oracles advise; they don't intervene.*
> **The Librarian** guards a library with no walls - every GitHub repo, every npm package, every StackOverflow answer ever written. Ask them "how does React handle concurrent rendering?" and they'll return with official docs, real-world examples, and a warning about the footgun you're about to step on.
**Role:** `External knowledge retrieval`
**Model:** `google/gemini-3-flash`
**Prompt:** [src/agents/librarian.ts](src/agents/librarian.ts)
Documentation lookup, GitHub code search, library research, best practice retrieval. *Read-only: they fetch wisdom; implementation is for others.*
> **The Designer** believes code should be beautiful - and so should everything it renders. Born from the frustration of a thousand ugly MVPs, they wield CSS like a brush and components like clay. Hand them a feature request; receive a masterpiece. They don't do "good enough."
**Role:** `UI/UX implementation and visual excellence`
**Model:** `google/gemini-3-flash`
**Prompt:** [src/agents/designer.ts](src/agents/designer.ts)
Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. *Visual excellence over code perfection - beauty is the priority.*
> **The Fixer** is the hands that build what others envision. While The Orchestrator plans and The Oracle advises, The Fixer executes. They receive complete context from research agents and clear task specifications, then implement with surgical precision. Fast, efficient, and focused - they don't think about what to build, they just build it.
**Role:** `Fast implementation specialist`
**Model:** `google/gemini-3-flash`
**Prompt:** [src/agents/fixer.ts](src/agents/fixer.ts)
Code implementation, refactoring, testing, verification. *Execute the plan - no research, no delegation, no planning.*
**Watch your agents work in real-time.** When the Orchestrator launches sub-agents or initiates background tasks, new tmux panes automatically spawn showing each agent's live progress. No more waiting in the dark.
#### Why This Matters
| Without Tmux Integration | With Tmux Integration |
|--------------------------|----------------------|
| Fire off a background task, wait anxiously | See the agent thinking, searching, coding |
| "Is it stuck or just slow?" | Watch tool calls happen in real-time |
| Results appear out of nowhere | Follow the journey from question to answer |
| Debug by guessing | Debug by observation |
#### What You Get
- **Live Visibility**: Each sub-agent gets its own pane showing real-time output
- **Auto-Layout**: Tmux automatically arranges panes using your preferred layout
- **Auto-Cleanup**: Panes close when agents finish, layout rebalances
- **Zero Overhead**: Works with OpenCode's built-in `task` tool AND our `background_task` tool
#### Quick Setup
1. **Enable the OpenCode HTTP server** in `opencode.json` (see [OpenCode Config](#opencode-config-opencodejson)).
2. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
3. **Run OpenCode inside tmux**:
```bash
tmux
opencode
```
#### Layout Options
| Layout | Description |
|--------|-------------|
| `main-vertical` | Your session on the left (60%), agents stacked on the right |
| `main-horizontal` | Your session on top (60%), agents stacked below |
| `tiled` | All panes in equal-sized grid |
| `even-horizontal` | All panes side by side |
| `even-vertical` | All panes stacked vertically |
*See the [Option Reference](#option-reference) for detailed configuration.*
---
### Quota Tool
For Antigravity users. You can trigger this at any time by asking the agent to **"check my quota"** or **"show status."**
| Tool | Description |
|------|-------------|
| `antigravity_quota` | Check API quota for all Antigravity accounts (compact view with progress bars) |
---
### Background Tasks
The plugin provides tools to manage asynchronous work:
| Tool | Description |
|------|-------------|
| `background_task` | Launch an agent in a new session (`sync=true` blocks, `sync=false` runs in background) |
| `background_output` | Fetch the result of a background task by ID |
| `background_cancel` | Abort running tasks |
---
### LSP Tools
Language Server Protocol integration for code intelligence:
| Tool | Description |
|------|-------------|
| `lsp_goto_definition` | Jump to symbol definition |
| `lsp_find_references` | Find all usages of a symbol across the workspace |
| `lsp_diagnostics` | Get errors/warnings from the language server |
| `lsp_rename` | Rename a symbol across all files |
---
### Code Search Tools
Fast code search and refactoring:
| Tool | Description |
|------|-------------|
| `grep` | Fast content search using ripgrep |
| `ast_grep_search` | AST-aware code pattern matching (25 languages) |
| `ast_grep_replace` | AST-aware code refactoring with dry-run support |
---
## 🧩 Skills
Skills are specialized capabilities that agents can use. Each agent has a default set of skills, which you can override in the agent config.
### Available Skills
| Skill | Description |
|-------|-------------|
| `yagni-enforcement` | Code complexity analysis and YAGNI enforcement |
| `playwright` | Browser automation via Playwright MCP |
### Default Skill Assignments
| Agent | Default Skills |
|-------|----------------|
| `orchestrator` | `*` (all skills) |
| `designer` | `playwright` |
| `oracle` | none |
| `librarian` | none |
| `explorer` | none |
| `fixer` | none |
### YAGNI Enforcement
**The Minimalist's sacred truth: every line of code is a liability.**
Use after major refactors or before finalizing PRs. Identifies unnecessary complexity, challenges premature abstractions, estimates LOC reduction, and enforces minimalism.
### Playwright Integration
**Browser automation for visual verification and testing.**
- **Browser Automation**: Full Playwright capabilities (browsing, clicking, typing, scraping).
- **Screenshots**: Capture visual state of any web page.
- **Sandboxed Output**: Screenshots saved to session subdirectory (check tool output for path).
### Customizing Agent Skills
Override skills per-agent in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson):
```json
{
"agents": {
"orchestrator": {
"skills": ["*"]
},
"designer": {
"skills": ["playwright"]
}
}
}
```
---
## MCP Servers
Built-in Model Context Protocol servers (enabled by default):
| MCP | Purpose | URL |
|-----|---------|-----|
| `websearch` | Real-time web search via Exa AI | `https://mcp.exa.ai/mcp` |
| `context7` | Official library documentation | `https://mcp.context7.com/mcp` |
| `grep_app` | GitHub code search via grep.app | `https://mcp.grep.app` |
### Disabling MCPs
You can disable specific MCP servers by adding them to the `disabled_mcps` array in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson).
---
## Configuration
### Files You Edit
| File | Purpose |
|------|---------|
| `~/.config/opencode/opencode.json` | OpenCode core settings (server port for tmux) |
| `~/.config/opencode/oh-my-opencode-slim.json` | Plugin settings (agents, tmux, MCPs) |
| `.opencode/oh-my-opencode-slim.json` | Project-local plugin overrides (optional) |
> **Platform paths:** On Windows, user config may also be at `%APPDATA%\opencode\`.
---
### Plugin Config (`oh-my-opencode-slim.json`)
The installer generates this file based on your providers. You can manually customize it to mix and match models.