Skip to content
Get packs

Guide · Open source

How to use oh-my-opencode-slim: install, configure and run agents

Updated · written with AI from the project's own documentation and checked against our catalogue data

oh-my-opencode-slim is an agent orchestration plugin for OpenCode, an AI coding environment. It adds a set of specialized agents that scout a codebase, look up documentation, review architecture, handle UI work and carry out scoped implementation tasks under one Orchestrator. This guide covers installing the plugin, choosing models, and running background agents so you can split larger coding tasks across them.

oh-my-opencode-slimalvinunreal/oh-my-opencode-slim · ★ 10.1k · MIT

Quick start

  1. 1Install OpenCode. Make sure OpenCode is installed, since the plugin only runs inside it.
  2. 2Run the installer. Run bunx oh-my-opencode-slim@latest install, or use npx if Bun is not present.
  3. 3Log in to providers. Run opencode auth login and sign in to the providers you plan to use.
  4. 4Refresh models. Run opencode models --refresh to list the models OpenCode can see.
  5. 5Edit the plugin config. Open ~/.config/opencode/oh-my-opencode-slim.json and set the model for each agent.
  6. 6Watch agents in panes. Enable Multiplexer Integration to open each agent in its own terminal pane.

What you need before installing

The plugin only works inside OpenCode, so you need OpenCode installed first. The installer runs with Bun, or with Node.js through npx if Bun is not present.

  • OpenCode
  • Bun, or Node.js with npx

Install oh-my-opencode-slim with Bun or npx

Run the installer with Bun. If you don't have Bun, the published CLI is a Node-compatible bundle, so npx works too.

bunx oh-my-opencode-slim@latest install npx oh-my-opencode-slim@latest install

Connect providers and refresh models

The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default. Log in to the providers you want to use, then refresh the list of models OpenCode can see.

To make OpenCode Go active during install, pass the preset flag shown below, or change the default preset name in the plugin config after installation.

opencode auth login opencode models --refresh bunx oh-my-opencode-slim@latest install --preset=opencode-go

Edit the plugin config to choose models per agent

Open the plugin config at ~/.config/opencode/oh-my-opencode-slim.json and update the models you want for each agent. The defaults are only a starting point, and the README notes that model lineups go stale quickly, so plan to tune them for your own work.

You can customize agents globally or per project, add new agents, override prompts and rewrite the delegation rules in the Orchestrator.

  • Global config: ~/.config/opencode/oh-my-opencode-slim.json
  • Delegate manually at any time with @agentName <task>

Understand background delegation

The Orchestrator plans the work, hands pieces to specialist agents in the background, and combines their results. The Orchestrator prompt contains the scheduler rules, routing logic and thresholds for when work goes to background agents. Reading it helps you predict what the plugin will do.

Watch agents work in terminal panes

The README recommends enabling Multiplexer Integration. It opens each agent in a dedicated pane in Tmux, Zellij, Herdr, cmux, kitty, WezTerm or Orca, so you can watch specialists work while the Orchestrator keeps coordinating.

On OpenCode v2 hosts, panes work with the shared background service or an explicit --server. Standalone hosts cannot host panes, so use v2's native subagent surfaces instead.

What people use it for

  • Splitting a larger coding task so one agent scouts the codebase while another implements a scoped change
  • Mixing different AI models across agents within one OpenCode session
  • Looking up fresh documentation through a dedicated agent during implementation
  • Customizing Orchestrator routing rules for a specific project

Frequently asked questions

Is oh-my-opencode-slim free?

The project is released under the MIT licence, according to its listing. Model providers you connect may charge for usage, so check their pricing separately.

What do I need to install oh-my-opencode-slim?

You need OpenCode and either Bun or Node.js. The README says npx is supported if Bun is not present.

Does oh-my-opencode-slim work without OpenCode?

No. The plugin only works inside OpenCode, so it is not a standalone app.

How do I change which model each agent uses?

Open ~/.config/opencode/oh-my-opencode-slim.json and update the models for each agent. Run opencode models --refresh first so you can see the models available to you.

Why can't I see agents in panes?

Pane support needs Multiplexer Integration enabled. On OpenCode v2 hosts, panes require the shared background service or an explicit --server; --standalone hosts cannot host panes.

How does it compare to oh-my-opencode?

Both are listed as comparable projects. The README describes this plugin as lean and fine tuned, built around an Orchestrator that routes work to specialists and balances quality, speed and cost.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use oh-my-opencode-slim if you already work in OpenCode and want help splitting larger tasks across agents, or want to mix models and customize routing. Skip it if you don't use OpenCode, want a ready-made setup with no configuration, or need a standalone app.

Install options & downloads