Oh My Opencode QuickStart voor OpenCode: Installeren, configureren, uitvoeren

Installeer Oh My Opencode en schip sneller uit.

Inhoud

Oh My Opencode maakt van OpenCode een multi-agent codeerhulpmiddel: een orchestrator delegeert werk aan specialistische agenten die parallel draaien.

oh my opencode agenten met laptops en gpu

Het kortste denkmodel dat je nodig hebt: installeer de plugin en gebruik vervolgens het trefwoord ultrawork (of ulw) wanneer je uitvoering met volledige kracht van meerdere agenten nodig hebt.

Deze startersgids behandelt installatie en configuratie op dag één. Zodra je operationeel bent:

Voor de bredere AI-codeer-toolchain, zie het overzicht van AI-developertools. Als je de voorkeur geeft aan een sandboxed, browsergeschikte alternatief voor OpenCode, dan neemt OpenHands een andere architecturale aanpak voor agent-based coderen.

Waarom Oh My Opencode bestaat

OpenCode is een open source AI-codeeragent die draait als een terminal-UI en niet-interactieve CLI-uitvoeringen voor scripting en automatisering behandelt.

Oh My Opencode verhoogt dat plafond aanzienlijk. Het voegt een volledige orchestratielaag toe die is gebouwd rond de “Sisyphus”-agent, samenwerking tussen meerdere specialisten en hechtere toolintegratie. Het resultaat is een systeem waarin complexe ingenieursopdrachten — het soort waar je normaal gesproken meerdere prompts voor moet oppassen — in één workflow worden gepland, gedelegeerd en geverifieerd.

Twee concepten komen constant naar voren, dus sla deze vast voordat je iets anders doet:

  • Ultrawork-modus: een trefwoord-geactiveerde workflow-switch. Het toevoegen van ultrawork of ulw aan je prompt activeert parallelle achtergronduitvoering, LSP-integratie, contextbeheer en automatische taakdecompositie — het is niet slechts een stijlkeuze.
  • Specialistische agenten: benoemde rollen zoals @oracle voor architectuur en @librarian voor onderzoek en documentatie. Je kunt ze expliciet aanroepen of de orchestrator laten routeren naar hen automatisch.

Dit artikel gebruikt Oh My Opencode, oh-my-opencode en Oh My OpenCode uitwisselbaar — ze verwijzen allemaal naar dezelfde plugin in het OpenCode-ecosysteem.

Vereisten en terminologie

Je hebt eerst OpenCode geïnstalleerd en werkend nodig. Zie onze OpenCode Quickstart om te leren hoe je het installeert, configureert en start.

Standaard start opencode de terminal-UI wanneer het zonder argumenten wordt uitgevoerd, en je kunt ook opencode run ... gebruiken voor niet-interactieve uitvoering.

Oh My Opencode vereist ten minste één geconfigureerde provider. OpenCode laadt providers vanaf credentials, omgevingsvariabelen of een project .env. De snelste manier om dit op te lossen:

opencode auth login
opencode auth list

Credentials worden opgeslagen in ~/.local/share/opencode/auth.json.

Een naamgevingsspecifiek dat het waard is om van tevoren te weten: de upstream GitHub-repository wordt nu gebrand als oh-my-openagent (“voorgaande oh-my-opencode”), maar de plugin- en pakketnaam in configuraties is nog steeds oh-my-opencode. Beide namen circuleren in community-posts — ze zijn hetzelfde.

Installatie Quickstart

Er zijn meerdere routes (CLI-installer, handmatige repo-clone, of “laat een agent het installeren”). De juiste keuze hangt af van of je een herhaalbare installer-flow wilt of volledige handmatige controle.

Als je Bun geïnstalleerd hebt, is bunx het equivalent van npx van Bun, ontworpen om npm-pakketten snel uit te voeren zonder een aparte globale installatiestap.

Om bunx op Linux te installeren:

curl -fsSL https://bun.com/install | bash

Automatische installatie met OpenCode

Je kunt een prompt in OpenCode uitvoeren en deze zal de OmO automatisch installeren.

Installeer en configureer oh-my-opencode door de instructies hier te volgen:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Het zal je enkele vragen stellen over je LLM-abonnementen en Oh My Opencode registreren in de OpenCode-plugins.

Handmatige route: voer de Oh My Opencode-installer uit met bunx of npx

Interactieve installer die vragen stelt over je providers en automatisch een “optimale” configuratie genereert, evenals een niet-interactieve modus voor automatisering en agenten.

Interactieve installatie:

bunx oh-my-opencode install
# of als je de voorkeur geeft aan npm-tooling
npx oh-my-opencode install

Niet-interactieve installatie (handig voor provisioning-scripts, CI-images of “agent-installaties”):

bunx oh-my-opencode install --no-tui \
  --claude=<yes|no|max20> \
  --openai=<yes|no> \
  --gemini=<yes|no> \
  --copilot=<yes|no>

Wat de installer doet, op hoog niveau:

  • registreert de plugin in de OpenCode-configuratie
  • genereert modeltoewijzingen op basis van providerbeschikbaarheid en fallback-regels
  • schrijft oh-my-opencode-configuratie naast de OpenCode-configuratiebestanden

Handmatige route: clone de repo en voer het installatiescript uit

Er is ook een “menselijke” handmatige flow: clone de repo, installeer afhankelijkheden en voer vervolgens een installatiescript uit dat je OpenCode-configuratielocatie detecteert, een back-up maakt en instellingen samenvoegt.

git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode
cd ~/.oh-my-opencode
npm install
npm run install

Als het script je OpenCode-configuratie niet automatisch kan vinden, stel de configuratie-pad-omgevingsvariabele expliciet in voordat je de installer opnieuw uitvoert.

Snelle verificatielijst

Na installatie, valideer drie dingen:

  • je Oh My Opencode-configuratiebestand bestaat op een erkende locatie
  • specialistische agenten kunnen worden aangeroepen
  • de ultrawork-trefwoordtrigger werkt zoals verwacht

Voorbeelden om te kopiëren:

# Toon het plugin-configuratiebestand (probeer de locatie die bij jouw setup hoort)
cat .opencode/oh-my-opencode.json
cat ~/.config/opencode/oh-my-opencode.json

# Snelle agententest
opencode run "Gebruik @oracle om de architectuur van het huidige project te analyseren"

# Snelle ultrawork-trigger test
opencode run "ulw list alle configuratiebestanden in dit project"

Als alle drie slagen, ben je echt klaar — niet alleen geïnstalleerd.

Configuratie en afstemming

Waar configuratie leeft en hoe prioriteit werkt

Oh My Opencode zoekt naar configuratiebestanden in een prioriteitsvolgorde, waarbij projectniveau-configuratie prioriteit heeft boven gebruikersniveau-configuratie. De gedocumenteerde zoekvolgorde is:

  • .opencode/oh-my-opencode.json (projectniveau, hoogste prioriteit)
  • ~/.config/opencode/oh-my-opencode.json (gebruikersniveau op macOS en Linux)
  • %APPDATA%\opencode\oh-my-opencode.json (gebruikersniveau op Windows)

OpenCode zelf ondersteunt ook meerdere configuratiebronnen en voegt deze samen in plaats van ze te vervangen, waarbij latere bronnen eerder bronnen alleen overschrijven wanneer sleutels conflicteren. Dit is belangrijk omdat je doorgaans een stabiele globale baseline wilt plus per-repo overschrijvingen.

JSONC-ondersteuning voor gezonde configuraties

Zowel OpenCode als Oh My Opencode ondersteunen JSONC, wat betekent dat je opmerkingen en komma’s achteraan in configuratiebestanden kunt houden zonder dat parsing faalt. Dit is vooral handig voor het documenteren waarom bepaalde limieten of modellen zijn gekozen.

Het “ultrawork”-trefwoord en wat het mogelijk maakt

ultrawork (of ulw) is de modusswitch die je het meest zult gebruiken. Voeg het toe aan je taakbeschrijving en het systeem activeert parallelle achtergronduitvoering, LSP-integratie, contextbeheer en automatische taakdecompositie. Het is geen hint voor het model — het is een harde trigger die verandert hoe de hele run is gestructureerd.

Concurrentie en achtergrondtaken

Oh My Opencode exposeert concurrentiecontroles voor achtergronduitvoering via sisyphus.max_concurrent_tasks.

Jag niet op hoge concurrentie hier. Elk providerplan heeft een plafond — Claude Max20 stopt bijvoorbeeld bij 3 parallelle taken — en het duwen daarbeyond levert onstabiele voltooiingen en lastig te debuggen time-outs op. Begin conservatief en verhoog alleen na schone runs.

Een minimale concurrentie-configuratie ziet er zo uit:

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

Een concurrentie van 2 is een veilig startpunt voor de meeste plannen.

Modelrouting per agent en per categorie

Oh My Opencode is gebouwd rond het idee dat verschillende taken profiteren van verschillende modellen, dus de configuratie ondersteunt:

  • modelselectie per agent, varianten en prompt-uitbreidingen
  • op categorie gebaseerde routing voor “snelle” versus “diepe” werk
  • fallback-modellen wanneer je voorkeursprovider niet beschikbaar is

De diepduik in gespecialiseerde agenten behandelt het volledige modelroutingsysteem in detail — inclusief waarom bepaalde agenten niet naar de verkeerde modelfamilie mogen worden geschakeld, de volledige fallback-ketens en hoe je modellen veilig kunt overschrijven voor self-hosted setups.

Modelresolutie is gelaagd: je expliciete overschrijving wint, dan provider fallback, dan systeemdefault. De fallback- keten begint met je native providers en kan zakken naar alternatieven zoals GitHub Copilot als niets anders beschikbaar is — wat betekent dat een misconfigureerde agent onwaarschijnlijk is om stil te falen; het zal gewoon een zwakker model gebruiken.

Een praktische startconfiguratie die je kunt aanpassen (JSONC aanbevolen):

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",

  // Houd concurrentie conservatief totdat je vertrouwen hebt in je providerlimieten
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  },

  // Agenten afstemming
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.7,
      "prompt_append": "Bied beknopte afwegingen en een duidelijke aanbeveling"
    },
    "librarian": {
      "enabled": true,
      "model": "google/gemini-3.1-pro"
    }
  },

  // Categoriërouting voor snelle queries versus dieper werk
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },
    "visual-engineering": { "model": "google/gemini-3.1-pro" }
  }
}

Het $schema-veld is het behouden waard — het ontgrendelt autocomplete in de meeste editors en vangt typefouten in agentennamen voordat je een run verspilt aan een gebroken configuratie.

MCP-integratie en hooks

Oh My Opencode ondersteunt MCP (Model Context Protocol) servers via een configuratieblok waarin je het servercommando, argumenten en omgevingsvariabelen definieert.

In de praktijk is het eenvoudigere pad om MCP’s direct te beheren via OpenCode met behulp van de opencode mcp-commandogroep — het behandelt toevoegen, lissen en OAuth-authenticatie zonder dat je handmatig configuratiebestanden hoeft aan te raken.

Workflowvoorbeelden die je kunt kopiëren

De twee voorbeeden hieronder zijn intentioneel “echte repo” gevormd: ze laten zien hoe je orchestratie activeert, hoe je specialistische agenten richt en hoe je resultaten verifieerbaar houdt.

Voorbeeld: Architectuurreview met Oracle en een repo-map

Gebruik dit als je een nieuwe codebase binnenkomt of een service overneemt en een snelle, actieerbare visie op de architectuur nodig hebt. Oracle is een read-only specialist — het kan geen wijzigingen maken, alleen adviseren.

Voer het uit vanuit je projectroot:

opencode

OpenCode start standaard zijn terminal-UI wanneer het zonder argumenten wordt gelanceerd.

Vraag vervolgens Oracle om een architectuuranalyse en een concreet refactor- of modulariseringsplan te produceren:

Gebruik @oracle om de architectuur van deze repository te analyseren.
Identificeer de belangrijkste bounded contexts, belangrijke afhankelijkheidsranden en de componenten met het hoogste risico.
Eindig met een refactorplan dat in kleine PR's kan worden uitgevoerd.

Voor logging of scripting, sla de TUI volledig over en gebruik opencode run:

opencode run "Gebruik @oracle om de architectuur van deze repository te analyseren en een gefaseerd refactorplan voor te stellen"

opencode run geeft de prompt direct door en stopt wanneer het klaar is — precies wat je wilt voor CI-stappen of automatisering-pipelines.

Voorbeeld: Volledige implementatie van een functie met ultrawork-orchestratie

Gebruik dit als je een functie nodig die meerdere bestanden of lagen raakt, of als je achtergrondtaken en specialistische agenten automatisch wilt inschakelen.

Begin met een ultrawork-prompt:

opencode run "ultrawork implementeer een nieuwe /health-endpoint met readiness- en liveness-checks, voeg tests toe, update documentatie en verifieer dat het lokaal draait"

Het ultrawork-trefwoord activeert alle geconfigureerde specialistische agenten, parallelisme van achtergrondtaken en diepere tooling in één keer. Je hebt geen aparte prompts nodig voor plannen, implementeren en testen.

Wanneer je ultrawork gebruikt, kun je het gedrag van specialisten nog steeds expliciet sturen. Bijvoorbeeld, je kunt eerst de architectuurontwerp forceren:

opencode run "ultrawork vraag @oracle om eerst het endpoint-contract en afhankelijkheden te ontwerpen, en implementeer vervolgens met minimale wijzigingen en voeg tests toe"

Het combineren van ultrawork met expliciete agentvermeldingen zoals @oracle is het zoetste punt: je krijgt volledige orchestratie maar behoudt nog steeds controle over welke specialist de kritieke ontwerpbepalingen behandelt.

Een ding dat je goed moet krijgen voor grotere ultrawork-taken: houd concurrentie binnen je providerlimieten. Begin bij 2, voer enkele taken schone uit en beslis dan of je wilt verhogen. Het duwen voorbij het plafond van je plan maakt dingen niet sneller — het maakt ze onbetrouwbaar.

Probleemoplossing en beste praktijken

Ultrawork-trefwoord activeert niet

Als ulw of ultrawork wordt genegeerd, behandel het als een signaal om plugin-laden en versie-compatibiliteit te controleren. Er is ten minste één gemelde regressie geweest waarbij trefwoorddetectie de verwachte ultrawork-mode-prompt niet injecteerde, met onderzoek dat wijst op de dedicated trefwoord-detector-hook.

In de praktijk zijn de snelste oplossingen:

  • bevestig dat de plugin is geregistreerd en configuratiebestanden aanwezig zijn (zie de verificatielijst eerder)
  • upgrade OpenCode of de plugin als je op een versie bent die bekend staat voor regressie in trefwoorddetectie

Installatiescript kan je OpenCode-configuratie niet vinden

Verifieer dat OpenCode is geïnstalleerd (opencode --version), stel vervolgens een expliciete configuratie-pad-omgevingsvariabele in voordat je de installer opnieuw uitvoert.

Te veel achtergrondtaken of throttling-problemen

Als je rate-limieten, time-outs of onstabiele voltooiingen raakt, is de oplossing altijd hetzelfde: verklein concurrentie en voer opnieuw uit. Het jagen op hoger parallelisme terwijl je provider je al throttle, is een verloren strijd.

Wanneer je ultrawork niet moet gebruiken

Ultrawork is krachtig, maar het is niet gratis — elke parallelle agent kost tokens en telt mee tegen je rate-limieten. Bewaar het voor grote refactors, full-stack functiewerk en complexe multi-step taken. Voor een kleine single-file-wijziging of een snelle vraag is een simpele prompt sneller en goedkoper.

Een solide vuistregel:

  • gebruik normale prompts voor kleine wijzigingen en straightforward vragen
  • gebruik ultrawork wanneer je wilt dat het systeem decomponeert, delegeert, uitvoert en verifieert over de repo

Compliance-opmerking over providertermen

Sommige community-discussie rondom dit ecosysteem raakt providerbeperkingen en voorwaarden, met name rondom third-party OAuth en compatibiliteitslagen. Dit zijn echte beperkingen — bekijk de voorwaarden van je provider voordat je geautomatiseerde of parallelle workflows op schaal uitvoert, en neem niet aan dat een werkende integratie een toegestane is.

Klaar om dieper te gaan? De diepduik in gespecialiseerde agenten legt de rol van elke agent, modelvereisten en self-hosting-opties uit. Voor eerlijke prestatiegegevens en community-gemelde facturatielopers, zie het Oh My Opencode-ervaringsartikel.