Hopp til innholdet
V1-dokumentasjon
Lag kommandofiler

Kommandoer

Egendefinerte kommandoer lar deg spesifisere en ledetekst du vil kjøre når kommandoen utføres i TUI.

Terminal
/my-command

Egendefinerte kommandoer kommer i tillegg til de innebygde kommandoene som /init, /undo, /redo, /help. Finn ut mer.


Lag nedmerkingsfiler i commands/-katalogen for å definere egendefinerte kommandoer.

Opprett .opencode/commands/test.md:

.opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-sonnet-5-5
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

Frontmatter definerer kommandoegenskaper. Innholdet blir malen.

Bruk kommandoen ved å skrive / etterfulgt av kommandonavnet.

Terminal
"/test"

Du kan legge til egendefinerte kommandoer gjennom OpenCode-konfigurasjonen eller ved å lage markdown-filer i katalogen commands/.


Bruk alternativet command i OpenCode config:

opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    // This becomes the name of the command
    "test": {
      // This is the prompt that will be sent to the LLM
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
      // This is shown as the description in the TUI
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-sonnet-5-5"
    }
  }
}

Nå kan du kjøre denne kommandoen i TUI:

Terminal
/test

Du kan også definere kommandoer ved å bruke markdown-filer. Plasser dem i:

  • Globalt: ~/.config/opencode/commands/
  • Per prosjekt: .opencode/commands/
~/.config/opencode/commands/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-sonnet-5-5
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

Markdown-filnavnet blir kommandonavnet. For eksempel lar test.md deg kjøre:

Terminal
/test

Ledetekstene for de egendefinerte kommandoene støtter flere spesielle plassholdere og syntaks.


Send argumenter til kommandoer ved å bruke plassholderen $ARGUMENTS.

.opencode/commands/component.md
---
description: Create a new component
---

Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.

Kjør kommandoen med argumenter:

Terminal
/component Button

Og $ARGUMENTS vil bli erstattet med Button.

Du kan også få tilgang til individuelle argumenter ved å bruke posisjonelle parametere:

  • $1 - Første argument
  • $2 - Andre argument
  • $3 - Tredje argument
  • Og så videre…

For eksempel:

.opencode/commands/create-file.md
---
description: Create a new file with content
---

Create a file named $1 in the directory $2
with the following content: $3

Kjør kommandoen:

Terminal
/create-file config.json src "{ \"key\": \"value\" }"

Dette erstatter:

  • $1 med config.json
  • $2 med src
  • $3 med { "key": "value" }

Bruk !command for å injisere shell-kommando-utdata i ledeteksten.

For eksempel, for å lage en egendefinert kommando som analyserer testdekning:

.opencode/commands/analyze-coverage.md
---
description: Analyze test coverage
---

Here are the current test results:
!`npm test`

Based on these results, suggest improvements to increase coverage.

Eller for å se gjennom nylige endringer:

.opencode/commands/review-changes.md
---
description: Review recent changes
---

Recent git commits:
!`git log --oneline -10`

Review these changes and suggest any improvements.

Kommandoer kjøres i prosjektets rotkatalog og utdataene deres blir en del av ledeteksten.


Inkluder filer i kommandoen din ved å bruke @ etterfulgt av filnavnet.

.opencode/commands/review-component.md
---
description: Review component
---

Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

Filinnholdet blir automatisk inkludert i ledeteksten.


La oss se på konfigurasjonsalternativene i detalj.


Alternativet template definerer ledeteksten som vil bli sendt til LLM når kommandoen utføres.

opencode.json
{
  "command": {
    "test": {
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
    }
  }
}

Dette er et obligatorisk konfigurasjonsalternativ.


Bruk alternativet description for å gi en kort beskrivelse av hva kommandoen gjør.

opencode.json
{
  "command": {
    "test": {
      "description": "Run tests with coverage"
    }
  }
}

Dette vises som beskrivelsen i TUI når du skriver inn kommandoen.


Bruk agent-konfigurasjonen for å spesifisere hvilken agent som skal utføre denne kommandoen. Hvis dette er en subagent, vil kommandoen utløse en subagent påkalling som standard. For å deaktivere denne virkemåten, sett subtask til false.

opencode.json
{
  "command": {
    "review": {
      "agent": "plan"
    }
  }
}

Denne kommandoen vil veilede deg gjennom å lage en ny agent med en tilpasset systemmelding og verktøykonfigurasjon.


Bruk subtask for å tvinge kommandoen til å utløse en subagent påkalling. Dette er nyttig hvis du vil at kommandoen ikke skal forurense din primære kontekst og vil tvinge agenten til å fungere som en underagent, selv om mode er satt til primary på agent konfigurasjonen.

opencode.json
{
  "command": {
    "analyze": {
      "subtask": true
    }
  }
}

Dette er et valgfritt konfigurasjonsalternativ.


Bruk model-konfigurasjonen for å overstyre standardmodellen for denne kommandoen.

opencode.json
{
  "command": {
    "analyze": {
      "model": "anthropic/claude-sonnet-5-5"
    }
  }
}

Dette er et valgfritt konfigurasjonsalternativ.


OpenCode inkluderer flere innebygde kommandoer som /init, /undo, /redo, /help; finn ut mer.

Hvis du definerer en egendefinert kommando med samme navn, vil den overstyre den innebygde kommandoen.