📌 This is a fork of oh-my-opencode-slim by Alvin (@alvinunreal). Special thanks to the author for creating this useful plugin!

📦 Installation

Prerequisites

• Bun installed
• OpenCode installed

Quick Start

bunx oh-my-opencode-slim-f@latest install --default-model=YOUR_PROVIDER/YOUR_MODEL

Examples:

# With default OpenAI models
bunx oh-my-opencode-slim-f@latest install

# With your custom provider model
bunx oh-my-opencode-slim-f@latest install --default-model=antigravity/MiniMax-M2.5

# Non-interactive mode with tmux and skills
bunx oh-my-opencode-slim-f@latest install --no-tui --tmux=yes --skills=yes

# Force overwrite existing configuration
bunx oh-my-opencode-slim-f@latest install --reset

For Alternative Providers

The default configuration uses OpenAI. To use Kimi, GitHub Copilot, or ZAI Coding Plan, see Provider Configurations for step-by-step instructions and config examples.

JSON Schema

An official JSON Schema is included in the package for editor validation and autocomplete. Add a $schema reference to your config file:

{
  "$schema": "https://unpkg.com/oh-my-opencode-slim-f@latest/oh-my-opencode-slim-f.schema.json",
  // your config...
}

This enables autocomplete and inline validation in VS Code, Neovim, and other editors that support JSON Schema.

For LLM Agents

Paste this into any coding agent:

Install and configure by following the instructions here:
https://raw.githubusercontent.com/thuxeko/oh-my-opencode-slim-f/refs/heads/master/README.md

Detailed installation guide: docs/installation.md

✅ Verify Your Setup

After installation and authentication, verify all agents are configured and responding:

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

02. Explorer: The Eternal Wanderer

03. Oracle: The Guardian of Paths

Council: The Chorus of Minds

04. Librarian: The Weaver of Knowledge

05. Designer: The Guardian of Aesthetics

06. Fixer: The Last Builder

📚 Documentation

🚀 Getting Started

| Doc | Contents | |-----|----------| | Installation Guide | CLI flags, --reset, auth, troubleshooting | | Provider Configurations | OpenAI, Kimi, Copilot, ZAI, Fireworks AI — mixing providers, fallback chains |

✨ Features

| Feature | Doc | What it does | |---------|-----|--------------| | Council | council.md | Run N models in parallel, synthesize one answer (@council) | | Interview | interview.md | Browser-based Q&A flow for turning rough ideas into a live markdown spec | | Multiplexer Integration | multiplexer-integration.md | Watch agents work in real-time with auto-spawned panes (Tmux/Zellij) | | Cartography Skill | cartography.md | Auto-generate hierarchical codemaps for any codebase |

⚙️ Config & Reference

| Doc | Contents | |-----|----------| | Skills | simplify, agent-browser, cartography — assignment syntax | | MCPs | websearch, context7, grep_app — permissions per agent | | Tools | Background tasks, LSP, code search, formatters | | Configuration | Config files, prompt overriding, JSONC, full option reference |

Slim only intercepts apply_patch before native execution. It rewrites recoverable stale patches, canonizes safe tolerant matches against the real file when unicode/trim drift is the only mismatch, keeps the authored new_lines bytes intact, preserves existing file EOL/final-newline state for updates, validates malformed patches strictly before helper execution, uses a conservative bounded LCS fallback, supports sequential Update File hunks on the same path through accumulated helper state, and blocks apply_patch before the native tool runs if any patch path falls outside the allowed root/worktree. This rescue does not extend to edit or write.

💡 Author's Setup

| Doc | Contents | |-----|----------| | Author's Preset | The exact config the author runs daily — OpenAI + Fireworks AI + GitHub Copilot |

🏛️ Contributors

📄 License

MIT