Riferimento
Comandi CLI
Tutto ciò che puoi lanciare da terminale con opencode.
Ogni comando accetta --help per l'elenco completo dei flag.
Sintassi
opencode <sottocomando> [flag] [directory]
Flag principali
| Flag | Significato |
|---|---|
--standalone | Usa un server privato invece del servizio condiviso. |
--server <url> | Collegati a un server specifico. |
--auto | Approva automaticamente i permessi non esplicitamente negati. |
--continue, -c | Continua l'ultima sessione. |
--session, -s <id> | Continua una sessione specifica, o creala se non esiste. |
--prompt <testo> | Prompt iniziale. |
Flag globali
| Flag | Significato |
|---|---|
--help, -h | Mostra l'aiuto. |
--version, -v | Mostra la versione. |
--wizard | Avvia la modalità guidata per un comando. |
--completions <shell> | Stampa lo script di completamento: bash, zsh, fish, powershell, sh, pwsh. |
--log-level <livello> | all, trace, debug, info, warn, error, fatal, none. |
--print-logs | Stampa i log su stderr (i log del server richiedono --standalone). |
Sottocomandi
| Comando | Cosa fa |
|---|---|
opencode | Apre la TUI nella cartella corrente (o in quella indicata). |
run | Esegue un prompt e stampa la risposta, senza TUI. |
mini | Interfaccia interattiva minimale. |
serve | Avvia il server API e web V2. |
pair | Stampa link monouso per collegare browser o app. |
session | Gestisce le sessioni. |
auth | Gestisce integrazioni e credenziali. |
models | Elenca i modelli disponibili. |
mcp | Gestisce i server MCP. |
plugin | Gestisce i plugin. |
stats | Statistiche d'uso condivisibili. |
service | Gestisce il server in background. |
reload | Ricarica la configurazione. |
api | Chiama l'API del server in esecuzione. |
acp | Avvia un server Agent Client Protocol. |
debug | Strumenti di diagnostica. |
upgrade, update | Aggiorna OpenCode. |
uninstall | Disinstalla OpenCode, conservando dati e configurazione. |
run
Invia un messaggio e stampa la risposta. Pensato per script e CI.
opencode run "Spiega questo repository"
opencode run --model anthropic/claude-sonnet-5-5 "Rifattorizza parseToken"
opencode run --continue "Ora gestisci il caso scaduto"
opencode run --agent build "Correggi il test che fallisce"
opencode run --format json "Elenca i commenti TODO"
opencode run --file src/server.ts --file src/client.ts "Cerca bug"
| Flag | Significato |
|---|---|
--continue, -c | Continua l'ultima sessione. |
--session, -s | Continua una sessione specifica. |
--fork | Esegue un fork della sessione prima di continuare. |
--model, -m | Modello nel formato provider/modello#variante. |
--agent | Agente da usare. |
--format | default o json. |
--file, -f | Allega un file al messaggio. |
--title | Titolo della sessione. |
--thinking | Mostra i blocchi di ragionamento. |
--auto | Approva i permessi non esplicitamente negati. |
mini
opencode mini
opencode mini --continue
opencode mini --model anthropic/claude-sonnet-5-5 --prompt "Riassumi il repository"
opencode mini --session ses_4f2a1c
Flag: --continue, --session, --fork,
--replay, --replay-limit, --model,
--agent, --prompt.
session
opencode session list
opencode session list --max-count 20 --format json
opencode session delete ses_9c1b08
opencode session export ses_4f2a1c
opencode session export ses_4f2a1c --sanitize
opencode session import session.json
opencode session import session.json --directory ~/code/progetto
auth
opencode auth list
opencode auth list --format json
opencode auth login anthropic
opencode auth login anthropic --method key
opencode auth logout anthropic work
opencode auth switch anthropic work
opencode auth export anthropic > credentials.json
opencode auth import credentials.json
auth export include i segreti. Tratta il file come una
password.
models
opencode models
mcp
opencode mcp list
opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add everything --global -- npx -y @modelcontextprotocol/server-everything
opencode mcp add everything --env LOG_LEVEL=debug -- npx -y @modelcontextprotocol/server-everything
opencode mcp add context7 --url https://mcp.context7.com/mcp --header CONTEXT7_API_KEY=secret
opencode mcp auth sentry
opencode mcp logout sentry
plugin
opencode plugin list
opencode plugin list --builtin
opencode plugin add @esempio/opencode-tui
opencode plugin check
opencode plugin update
opencode plugin remove @esempio/opencode-tui
stats
opencode stats
opencode stats --days 7
opencode stats --models
opencode stats --cost
opencode stats --json
opencode stats --project .
Altri flag: --year, --all, --tools,
--full, --limit.
serve
opencode serve
opencode serve --hostname 0.0.0.0 --port 4096
opencode serve --cors https://app.example.com
pair
opencode pair
opencode pair --url https://dev.example.com
opencode pair --remote
opencode pair --remote --yes
--remote espone il server a Internet tramite OpenTunnel. La
prima volta chiede conferma.
service
opencode service start
opencode service restart
opencode service status
opencode service stop
opencode service get hostname
opencode service set hostname 0.0.0.0
opencode service set cors https://app.example.com
opencode service set env OPENCODE_LOG_LEVEL DEBUG
opencode service unset hostname
reload
opencode reload
Ricarica la configurazione senza riavviare il server. Le sessioni in corso continuano con i nuovi servizi al confine del passo successivo.
api
opencode api GET /api/session
opencode api session.list --param limit=10
opencode api session.create --data '{"title": "Nuova sessione"}'
opencode api GET /api/session -H "accept: application/json"
Flag: --data/-d, --header/-H,
--param key=value. Accetta anche --standalone e
--server.
acp
opencode acp
opencode acp --login
debug
opencode debug agents
opencode debug config
opencode debug heap-dump
opencode debug heap-dump --directory ./snapshots
opencode debug paths
opencode debug paths db
upgrade
opencode upgrade
opencode upgrade 2.0.21
opencode upgrade 2.0.21 --method bun
Metodi: curl, npm, pnpm,
bun, yarn, vp, brew,
winget.
uninstall
opencode uninstall --dry-run
opencode uninstall
opencode uninstall --force