Strumenti

Gestisci gli strumenti che un LLM puo' usare.

Gli strumenti permettono all’LLM di eseguire azioni nel tuo codebase. OpenCode include un set di strumenti integrati, ma puoi estenderlo con strumenti personalizzati o con server MCP.

Di default, tutti gli strumenti sono abilitati e non richiedono permessi per essere eseguiti. Puoi controllare il comportamento degli strumenti tramite i permessi.

Configura

Usa il campo permission per controllare il comportamento degli strumenti. Puoi consentire, negare o richiedere approvazione per ciascuno.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny",
    "bash": "ask",
    "webfetch": "allow"
  }
}

Puoi anche usare wildcard per controllare piu’ strumenti insieme. Per esempio, per richiedere approvazione per tutti gli strumenti di un server MCP:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "mymcp_*": "ask"
  }
}

Scopri di piu’ su come configurare i permessi.

Integrati

Ecco tutti gli strumenti integrati disponibili in OpenCode.

bash

Esegui comandi di shell nel tuo ambiente di progetto.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": "allow"
  }
}

Questo strumento permette all’LLM di eseguire comandi da terminale come npm install, git status o qualunque altro comando di shell.

edit

Modifica file esistenti usando sostituzioni esatte di stringhe.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Questo strumento esegue modifiche precise ai file sostituendo corrispondenze di testo esatte. E’ il modo principale con cui l’LLM modifica il codice.

write

Crea nuovi file o sovrascrive quelli esistenti.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Usalo per consentire all’LLM di creare nuovi file. Sovrascrivera’ i file esistenti se sono gia’ presenti.

read

Leggi il contenuto dei file dal tuo codebase.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "read": "allow"
  }
}

Questo strumento legge i file e ne restituisce il contenuto. Supporta la lettura di intervalli di righe specifici per file grandi.

grep

Cerca nel contenuto dei file usando espressioni regolari.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "grep": "allow"
  }
}

Ricerca rapida nel contenuto su tutto il codebase. Supporta la sintassi completa delle regex e il filtro per pattern di file.

glob

Trova file tramite pattern matching.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "glob": "allow"
  }
}

Cerca file usando pattern glob come **/*.js o src/**/*.ts. Restituisce i percorsi corrispondenti ordinati per data di modifica.

list

Elenca file e directory in un percorso specifico.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "list": "allow"
  }
}

Questo strumento elenca il contenuto di una directory. Accetta pattern glob per filtrare i risultati.

lsp (experimental)

Interagisci con i server LSP configurati per ottenere funzionalita’ di code intelligence come definizioni, riferimenti, hover info e call hierarchy.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "lsp": "allow"
  }
}

Le operazioni supportate includono goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls e outgoingCalls.

Per configurare quali server LSP sono disponibili per il tuo progetto, vedi LSP Servers.

patch

Applica patch ai file.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Questo strumento applica file patch al tuo codebase. Utile per applicare diff e patch da varie fonti.

skill

Carica una skill (un file SKILL.md) e ne restituisce il contenuto nella conversazione.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": "allow"
  }
}

todowrite

Gestisci todo list durante le sessioni di coding.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todowrite": "allow"
  }
}

Crea e aggiorna liste di task per tracciare i progressi durante operazioni complesse. L’LLM lo usa per organizzare attivita’ multi-step.

todoread

Leggi le todo list esistenti.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todoread": "allow"
  }
}

Legge lo stato corrente della todo list. Usato dall’LLM per tenere traccia di quali task sono in sospeso o completati.

webfetch

Recupera contenuti dal web.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "webfetch": "allow"
  }
}

Permette all’LLM di recuperare e leggere pagine web. Utile per consultare documentazione o ricercare risorse online.

websearch

Cerca informazioni sul web.

Questo strumento e’ disponibile solo quando usi il provider OpenCode o quando la variabile d’ambiente OPENCODE_ENABLE_EXA e’ impostata a un valore truthy (ad esempio true o 1).

Per abilitarlo all’avvio di OpenCode:

OPENCODE_ENABLE_EXA=1 opencode

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "websearch": "allow"
  }
}

Esegue ricerche web usando Exa AI per trovare informazioni rilevanti online. Utile per ricercare argomenti, trovare eventi attuali o raccogliere informazioni oltre il cutoff dei dati di addestramento.

Non e’ richiesta alcuna API key: lo strumento si connette direttamente al servizio MCP ospitato da Exa AI senza autenticazione.

question

Fai domande all’utente durante l’esecuzione.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "question": "allow"
  }
}

Questo strumento permette all’LLM di porre domande all’utente durante un task. E’ utile per:

Raccogliere preferenze o requisiti dell’utente
Chiarire istruzioni ambigue
Ottenere decisioni sulle scelte di implementazione
Offrire opzioni su che direzione prendere

Ogni domanda include un header, il testo della domanda e una lista di opzioni. Gli utenti possono selezionare dalle opzioni fornite o digitare una risposta personalizzata. Quando ci sono piu’ domande, gli utenti possono navigare tra di esse prima di inviare tutte le risposte.

!node_modules/
!dist/
!build/

Per esempio, questo file .ignore permette a ripgrep di cercare dentro node_modules/, dist/ e build/ anche se sono elencate in .gitignore.