*Six 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.*
*Six 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.*
> **💡 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
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
|
|
Recommended Models: cliproxy/gemini-claude-opus-4-5-thinking openai/gpt-5.2-codex
|
|
MCPs: websearch
|
|
Skills: * (all)
|
|
|
Capabilities: 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 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
|
|
Recommended Models: cerebras/zai-glm-4.7 google/gemini-3-flash openai/gpt-5.1-codex-mini
|
|
| MCPs: none | |
| Skills: none | |
|
Capabilities: Regex search, AST pattern matching, file discovery, parallel exploration. Read-only: they chart the territory; others conquer it. |
|
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
|
|
Recommended Models: openai/gpt-5.2-codex cliproxy/gemini-3-pro-high
|
|
| MCPs: none | |
| Skills: none | |
|
Capabilities: Root cause analysis, architecture review, debugging guidance, tradeoff analysis. Read-only: Oracles advise; they don't intervene. |
|
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
|
|
Recommended Models: google/gemini-3-flash openai/gpt-5.1-codex-mini
|
|
MCPs: websearch context7 grep_app
|
|
| Skills: none | |
|
Capabilities: Documentation lookup, GitHub code search, library research, best practice retrieval. Read-only: they fetch wisdom; implementation is for others. |
|
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
|
|
Recommended Models: google/gemini-3-flash
|
|
| MCPs: none | |
Skills: playwright
|
|
|
Capabilities: Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. Visual excellence over code perfection - beauty is the priority. |
|
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
|
|
Recommended Models: cerebras/zai-glm-4.7 google/gemini-3-flash openai/gpt-5.1-codex-mini
|
|
| MCPs: none | |
| Skills: none | |
|
Capabilities: 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.
#### Quick Setup
1. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
```json
{
"tmux": {
"enabled": true,
"layout": "main-vertical",
"main_pane_size": 60
}
}
```
2. **Run OpenCode inside tmux**:
```bash
tmux
opencode --port 4096
```
Or use a custom port (must match `OPENCODE_PORT` env var):
```bash
tmux
export OPENCODE_PORT=5000
opencode --port 5000
```
This allows multiple OpenCode instances on different ports.
#### 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 |
---
### 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 |
> **Built-in LSP Servers:** OpenCode includes pre-configured LSP servers for 30+ languages (TypeScript, Python, Rust, Go, etc.). See the [official documentation](https://opencode.ai/docs/lsp/#built-in) for the full list and requirements.
---
### 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 |
---
### Formatters
OpenCode automatically formats files after they're written or edited using language-specific formatters.
> **Built-in Formatters:** Includes support for Prettier, Biome, gofmt, rustfmt, ruff, and 20+ others. See the [official documentation](https://opencode.ai/docs/formatters/#built-in) for the complete list.
---
## ⚙️ Configuration
### Files You Edit
| File | Purpose |
|------|---------|
| `~/.config/opencode/opencode.json` | OpenCode core settings |
| `~/.config/opencode/oh-my-opencode-slim.json` | Plugin settings (agents, tmux, MCPs) |
| `.opencode/oh-my-opencode-slim.json` | Project-local plugin overrides (optional) |
---
### Prompt Overriding
You can customize agent prompts by creating markdown files in `~/.config/opencode/oh-my-opencode-slim/`:
| File | Purpose |
|------|---------|
| `{agent}.md` | Replaces the default prompt entirely |
| `{agent}_append.md` | Appends to the default prompt |
**Example:**
```
~/.config/opencode/oh-my-opencode-slim/
├── orchestrator.md # Custom orchestrator prompt
├── orchestrator_append.md # Append to default orchestrator prompt
├── explorer.md
├── explorer_append.md
└── ...
```
**Usage:**
- Create `{agent}.md` to completely replace an agent's default prompt
- Create `{agent}_append.md` to add custom instructions to the default prompt
- Both files can exist simultaneously - the replacement takes precedence
- If neither file exists, the default prompt is used
This allows you to fine-tune agent behavior without modifying the source code.
---
### 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. See the [Presets](#️-presets) section for detailed configuration options.
#### Option Reference
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `preset` | string | - | Name of the preset to use (e.g., `"openai"`, `"cliproxy"`) |
| `presets` | object | - | Named preset configurations containing agent mappings |
| `presets.