Vai al contenuto
Creazione file di comando

Comandi

I comandi personalizzati ti permettono di definire un prompt da eseguire quando quel comando viene lanciato nella TUI.

Terminale
/my-command

I comandi personalizzati si aggiungono a quelli integrati come /init, /undo, /redo, /help. Scopri di piu.

Crea file markdown nella directory commands/ per definire comandi personalizzati.

Crea .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.

Il frontmatter definisce le proprieta del comando. Il contenuto diventa il template.

Usa il comando digitando / seguito dal nome del comando.

Terminale
"/test"

Puoi aggiungere comandi personalizzati tramite la config di OpenCode o creando file markdown nella directory commands/.

Usa l’opzione command nella config di OpenCode:

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"
    }
  }
}

Ora puoi eseguire questo comando nella TUI:

Terminale
/test

Puoi anche definire comandi usando file markdown. Mettili in:

  • Globale: ~/.config/opencode/commands/
  • Per progetto: .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.

Il nome del file markdown diventa il nome del comando. Per esempio, test.md ti permette di eseguire:

Terminale
/test

I prompt dei comandi personalizzati supportano diversi placeholder e sintassi speciali.

Passa argomenti ai comandi usando il placeholder $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.

Esegui il comando con argomenti:

Terminale
/component Button

E $ARGUMENTS verra sostituito con Button.

Puoi anche accedere ai singoli argomenti usando parametri posizionali:

  • $1 - Primo argomento
  • $2 - Secondo argomento
  • $3 - Terzo argomento
  • E cosi via…

Per esempio:

.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

Esegui il comando:

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

Questo sostituisce:

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

Usa !command per inserire nel prompt l’output di un comando shell.

Per esempio, per creare un comando personalizzato che analizzi la copertura dei test:

.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.

Oppure per rivedere modifiche recenti:

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

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

Review these changes and suggest any improvements.

I comandi vengono eseguiti nella root del progetto e il loro output diventa parte del prompt.

Includi file nel comando usando @ seguito dal nome del file.

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

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

Il contenuto del file viene incluso automaticamente nel prompt.

Vediamo le opzioni di configurazione nel dettaglio.

L’opzione template definisce il prompt che verra inviato all’LLM quando il comando viene eseguito.

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."
    }
  }
}

Questa e un’opzione di config obbligatoria.

Usa l’opzione description per fornire una breve descrizione di cosa fa il comando.

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

Questo viene mostrato come descrizione nella TUI quando digiti il comando.

Usa la config agent per specificare opzionalmente quale agente deve eseguire il comando. Se e un subagent, il comando attiva per default l’invocazione di un subagent. Per disabilitare questo comportamento, imposta subtask a false.

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

Questa e un’opzione di config opzionale. Se non specificata, usa l’agente corrente.

Usa il booleano subtask per forzare il comando ad attivare l’invocazione di un subagent. E utile se vuoi evitare che il comando inquini il contesto principale e forza l’agente ad agire come subagent, anche se mode e impostato su primary nella configurazione dell’agente.

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

Questa e un’opzione di config opzionale.

Usa la config model per sovrascrivere il modello predefinito per questo comando.

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

Questa e un’opzione di config opzionale.

opencode include diversi comandi integrati come /init, /undo, /redo, /help; scopri di piu.

Se definisci un comando personalizzato con lo stesso nome, sovrascrivera il comando integrato.