Hoe commando's werken

Het enige dat je moet weten: OpenSpec heeft twee soorten commando's, en ze worden op twee verschillende plekken uitgevoerd.

• openspec ... commando's worden in je terminal uitgevoerd. (Voorbeeld: openspec init.)
• /opsx:... commando's worden in de chat van je AI-assistent uitgevoerd. (Voorbeeld: /opsx:propose.)

Als je ooit /opsx:propose in je terminal typt en er gebeurt niets, dan is dit de pagina die uitlegt waarom. Je praat tegen de verkeerde helft van OpenSpec. Slash-commando's zijn geen terminalcommando's. Het zijn instructies die je aan je AI-codingassistent geeft, in hetzelfde chatvenster waarin je normaal gesproken "voeg een login-formulier toe" zou typen.

Dit ene onderscheid is de meest voorkomende struikelblok voor nieuwe gebruikers, dus laten we het helder maken.

De twee helften

OpenSpec is één project dat twee hoeden draagt.

De CLI (terminalhelft). Een programma genaamd openspec dat je installeert en uitvoert vanaf je shell. Het stelt je project in, lijst wijzigingen op en valideert ze, toont een dashboard en archiveert voltooide werk. Je typt deze in iTerm, de VS Code-terminal, PowerShell, overal waar je git of npm zou uitvoeren.

openspec init        # stel OpenSpec in voor dit project
openspec list        # zie actieve wijzigingen
openspec view        # open het interactieve dashboard

De slash-commando's (chathelft). Korte commando's zoals /opsx:propose en /opsx:apply die je typt in je AI-assistent. Deze vertellen de AI om het OpenSpec-werkstroom te volgen: een concept opstellen, specificaties schrijven, bouwen vanuit de takenlijst, archiveren wanneer klaar. Je typt deze in Claude Code, Cursor, Devin Desktop, Copilot, of welke assistent je ook gebruikt.

/opsx:propose add-dark-mode    (getypt in je AI-chat)
/opsx:apply                    (getypt in je AI-chat)
/opsx:archive                  (getypt in je AI-chat)

Hier is het mentale model in één afbeelding:

        JOUW TERMINAL                         CHAT VAN JE AI-ASSISTENT
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   installeert   │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   commando's    │  /opsx:archive                │
   └──────────────────────┘    & vaardigheden   └──────────────────────────────┘
        voer openspec hier uit                       voer /opsx:* hier uit

Merk de pijl op. Het uitvoeren van openspec init in je terminal is wat de slash-commando's installeert in je AI-tool. De terminalhelft stelt de chathelft in. Daarna vindt het dagelijkse werk grotendeels plaats in de chat.

"Hoe start ik de interactieve modus?"

Er is geen aparte interactieve modus om te starten. Deze vraag komt veel voor, dus verdient hij een duidelijk antwoord.

Je gaat niet naar een speciale OpenSpec-modus. Je opent gewoon je AI-codingassistent zoals je altijd doet, en typt een slash-commando in de chat. Het slash-commando is hoe je "OpenSpec binnenkomt". Je assistent herkent het, laadt de bijbehorende OpenSpec-vaardigheid en begint met het volgen van de werkstroom.

Dus de echte instructies zijn:

1. Open je AI-codingassistent (Claude Code, Cursor, Devin Desktop, enzovoort) in je project.
2. Typ /opsx:propose in de chat, op dezelfde plek waar je elk ander verzoek typt.
3. Kijk naar de automatische aanvulling: als OpenSpec is geïnstalleerd, zie je /opsx:propose, /opsx:apply en vrienden verschijnen terwijl je de slash typt.

Dat is het. Geen modus om in/uit te schakelen, geen daemon om te starten, geen apart venster.

Eén ding dat echt interactief is, leeft in de terminal: openspec view. Het opent een dashboard voor het bladeren door je specificaties en wijzigingen. Maar dat is een viewer, niet het middel waarmee je proposeert en bouwt. Bouwen gebeurt via slash-commando's in de chat.

Waarom deze splitsing bestaat

Het is de moeite waard om te begrijpen, omdat het verklaart waarom OpenSpec werkt met meer dan 30 verschillende AI-tools.

De CLI is de motor. Hij kent de regels: hoe een wijzigingsmap eruitziet, welke artefacten afhankelijk zijn van elkaar, hoe je een delta-specificatie samenvoegt met je bron van waarheid. Het is overal hetzelfde.

De slash-commando's zijn het stuurwiel, en elke AI-tool heeft er een iets andere. Claude Code noemt ze commando's. Cursor en Devin Desktop hebben hun eigen formaten. Sommige tools noemen ze vaardigheden. Wanneer je openspec init uitvoert, genereert OpenSpec het juiste type bestand voor elke tool die je hebt geselecteerd, zodat dezelfde intentie van /opsx:propose werkt, ongeacht welke assistent je prefereert.

De kracht van dit ontwerp: je leert de werkstroom één keer en neemt hem mee tussen tools. Het nadeel: de exacte syntaxis van een commando kan licht verschillen tussen tools, wat het volgende sectie is.

Syntaxis van slash-commando's per tool

De intentie is overal identiek. De spelling volgt het bestand dat je tool laadt.

Commandobestand van je tool	Hoe je het typt	Voorbeeldtools
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
geen — alleen vaardigheden	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, gedeelde .agents
geen — Kimi Code	/skill:openspec-propose	Kimi Code
geen — Codex CLI	$openspec-propose	Codex

Devin is de enige tool die twee rijen beslaat. Devin Desktop leest .devin/workflows/, dus /opsx-propose werkt daar; Devin Local doet dit niet, dus gebruik op die agent de vaardigheid /openspec-propose in plaats daarvan. De vaardigheden die OpenSpec naar .devin/skills/ schrijft, werken op beide, vandaar dat ze elkaar refereren via de vaardigheidsnaam.

Elke tool is vermeld in Hoe aanroepen — die tabel is de gezaghebbende. Twee rijen zijn helemaal geen slash-commando's: Amazon Q laadt zijn bestanden in een promptbibliotheek die wordt aangeroepen met @, en de laatste drie rijen gebruiken de vaardigheidsnaam, wat niet de commando-id is (/opsx:apply is de vaardigheid openspec-apply-change).

Twijfel je? Lees dan de regel "Aan de slag" die openspec init printte: deze gebruikt al de vorm die je tools hebben geregistreerd. Ook een slash typen en kijken naar de automatische aanvulling werkt, voor de tools die überhaupt slash-commando's tonen.

Hoe de commando's daar terecht kwamen: vaardigheden en commando's

Wanneer je openspec init (of openspec update) uitvoert, schrijft OpenSpec kleine bestanden in je project zodat je AI-tool de werkstroom kan vinden. Afhankelijk van je tool en instellingen zijn dit vaardigheden, commando's, of beide.

• Vaardigheden leven op plekken zoals .claude/skills/openspec-*/SKILL.md. Ze zijn de opkomende cross-tool standaard: een map met instructies die je assistent automatisch detecteert.
• Commando's leven op plekken zoals .cursor/commands/opsx-<id>.md of .claude/commands/opsx/<id>.md — de lay-out is die van de tool, en die beslist hoe je het commando typt. Ze zijn de oudere per-tool slash-commandobestanden. Codex krijgt geen gegenereerde commandobestanden; gebruik .agents/skills/openspec-*.

Je hoeft niet te weten welke een je tool gebruikt. Je typt gewoon het slash-commando en het werkt. Maar het weten van het bestaan van deze bestanden helpt wanneer er iets misgaat: als je commando's verdwijnen, betekent dit meestal dat deze bestanden ontbreken of verouderd zijn, en openspec update regeneert ze.

Zie Ondersteunde Tools voor de exacte paden per tool, en Migratiegids voor hoe vaardigheden de oudere commando-alleen benadering vervingen.

Bevestigen dat het is geïnstalleerd

Snelle checks, snelste eerst:

1. Typ een slash in je AI-chat. Begin met het typen van /opsx en kijk naar suggesties voor automatische aanvulling. Als ze verschijnen, ben je klaar. Op een tool die alleen vaardigheden ondersteunt (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, of het gedeelde .agents-doel) zal /opsx nooit compleet worden, zelfs niet bij een gezonde installatie — probeer in plaats daarvan de vaardigheidsnaam uit de tabel hierboven.
2. Kijk naar de bestanden. Voor Claude Code, controleer of .claude/skills/ mappen bevat met openspec-*. Andere tools gebruiken hun eigen directories (Ondersteunde Tools somt ze op).
3. Voer setup opnieuw uit. Vanaf de root van je project, voer openspec update uit. Dit regeneert de vaardigheids- en commandobestanden voor de tools die je hebt geconfigureerd.
4. Herstart je assistent. Veel tools scannen op vaardigheden en commando's bij het opstarten, dus een nieuw venster kan de missende stap zijn.

Welke commando's heb ik eigenlijk?

Standaard installeert OpenSpec de core-set van slash-commando's:

• /opsx:explore: denk na over een idee met de AI voordat je je vastlegt aan een wijziging (een goede eerste stap als je twijfelt)
• /opsx:propose: maak een wijziging en schrijf alle planningsartefacten in één stap
• /opsx:apply: bouw de wijziging door de takenlijst af te werken
• /opsx:update: herzie de planningsartefacten van een wijziging en houd ze coherent
• /opsx:sync: merge de spec-updates van een wijziging in je hoofdspecificaties (meestal automatisch)
• /opsx:archive: voltooi een wijziging en archief deze

Een goede standaardritme: explore wanneer je uitzoekt wat je moet doen, gevolgd door propose, apply, archive. De gids Explore First legt uit waarom die openingsstap zich lonend maakt.

Er is ook een uitgebreide set voor mensen die fijnere controle willen (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). Je zet dit aan met openspec config profile, en past het toe met openspec update.

Nieuw bij alles? /opsx:onboard (in de uitgebreide set) leidt je langs een volledige wijziging op je eigen codebase, waarbij elke stap wordt toegelicht. Het is de vriendelijkst mogelijke introductie.

Voor details over wat elk commando doet, zie Commando's. Voor wanneer je welk commando moet gebruiken, zie Werkstromen.

Een schone eerste run

Samengevat, hier is de hele sequentie met elke stap gelabeld volgens waar deze plaatsvindt.

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (installeert slash-commando's in je AI-tool)

AI-CHAT      /opsx:explore
              (optioneel: denk eerst het idee na met de AI)

AI-CHAT      /opsx:propose add-dark-mode
              (AI stelt concept op, specificaties, ontwerp, taken)

AI-CHAT      /opsx:apply
              (AI bouwt het, vinkt taken af)

AI-CHAT      /opsx:archive
              (wijziging is gemerged in je specificaties en gearchiveerd)

Twee terminalstappen om in te stellen. Dan leef je in de chat. Dat is het ritme.

Gerelateerd

• Aan de slag: de volledige walkthrough voor de eerste wijziging
• Commando's: elk slash-commando in detail
• CLI: elk terminalcommando in detail
• Ondersteunde Tools: per-tool syntaxis en bestandlocaties
• FAQ: meer snelle antwoorden
• Probleemoplossing: fixes wanneer commando's niet verschijnen