Forked from alvinunreal/oh-my-opencode-slim and independently maintained by SamWang32191. Issues for this fork should be filed at SamWang32191/oh-my-opencode-medium.

Migration from oh-my-opencode-slim

If you were using oh-my-opencode-slim:

1. Package name changed: Use oh-my-opencode-medium for installation
2. Reinstall the plugin: Re-run the installer with the new package name
3. Rename your config files:
   • ~/.config/opencode/oh-my-opencode-slim.json → ~/.config/opencode/oh-my-opencode-medium.json (or .jsonc)
   • ~/.config/opencode/oh-my-opencode-slim.jsonc → ~/.config/opencode/oh-my-opencode-medium.jsonc
   • .opencode/oh-my-opencode-slim.json → .opencode/oh-my-opencode-medium.json (or .jsonc)
   • Project-local prompt directories also need renaming

The installer no longer auto-reads old slim config files—manual renaming is required.

📦 Installation

Quick Start

bunx oh-my-opencode-medium@latest install

The installer generates an OpenAI configuration by default (using gpt-5.4 and gpt-5.4-mini). No provider questions asked.

For non-interactive mode:

bunx oh-my-opencode-medium@latest install --no-tui --tmux=no --skills=yes

To force overwrite of an existing configuration:

bunx oh-my-opencode-slim@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-medium@latest/oh-my-opencode-medium.schema.json",
  // your config...
}

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

Hash-Anchored Editing

The hashline workflow is enabled by default. Add this to your project config only if you want to disable it:

{
  "hashline_edit": false
}

When enabled, read output is rewritten to include stable LINE#ID anchors:

11#VK| function hello() {
22#XJ|   return 'world';
33#MB| }

Use the feature as a read -> edit -> re-read loop:

1. Run read and copy the current LINE#ID anchors.
2. Run edit using those anchors instead of reproducing surrounding text.
3. Re-run read and use the new anchors for the next change.

If the file changed after the last read, the edit is rejected and the tool returns fresh >>> LINE#ID recovery snippets so the agent can retry against the current file instead of applying a stale edit.

Skill Slash Commands

Discovered skills are converted into slash commands by default. Add this only if you want to keep installed skills available on disk without auto-registering their slash commands:

{
  "skill_slash_command_conversion": false
}

This disables only skill-backed slash command generation. Built-in commands such as /handoff and any commands you define directly in OpenCode config still stay registered.

For LLM Agents

Paste this into any coding agent:

Install and configure by following the instructions here:
https://raw.githubusercontent.com/SamWang32191/oh-my-opencode-medium/medium/README.md

Detailed installation guide: docs/installation.md

Additional guides:

• Provider Configurations - Config examples for all supported providers
• Tmux Integration - Real-time agent monitoring with tmux Quick Reference - Config, fallback behavior, skills, MCPs

Built-in command: use /handoff to generate a phase-1 continuation brief from the current conversation context plus git context when available. In this first iteration, it does not transfer session history or todo state (and it still works without git context).

✅ 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

04. Librarian: The Weaver of Knowledge

05. Designer: The Guardian of Aesthetics

06. Fixer: The Last Builder

📚 Documentation

• Quick Reference - Skills, MCPs, Tools, Configuration
• Provider Configurations - Config examples for OpenAI, Kimi, Copilot, ZAI
• Installation Guide - Detailed installation and troubleshooting
• Cartography Skill - Custom skill for repository mapping + codemap generation
• Tmux Integration - Real-time agent monitoring with tmux Quick Reference - Config, fallback behavior, skills, MCPs

📄 License

MIT