CLI

La CLI di CodeTutor, per impostazione predefinita, avvia la TUI quando viene eseguita senza argomenti.

opencode

Ma accetta anche i comandi documentati in questa pagina. Questo ti permette di interagire con CodeTutor in modo programmatico.

codetutor run "Explain how closures work in JavaScript"

---

tui

Avvia l’interfaccia testuale di CodeTutor (interfaccia utente da terminale).

opencode [project]

Flag

Flag	Breve	Descrizione
--continue	-c	Continua l’ultima sessione
--session	-s	ID sessione da continuare
--fork		Duplica la sessione quando continui (usa con --continue o --session)
--prompt		Prompt da usare
--model	-m	Modello nel formato provider/model
--agent		Agente da usare
--port		Porta su cui mettersi in ascolto
--hostname		Hostname su cui mettersi in ascolto

---

Comandi

La CLI di CodeTutor include anche i seguenti comandi.

---

agent

Gestisci gli agenti per CodeTutor.

codetutor agent [command]

---

attach

Collega un terminale a un backend server di CodeTutor già in esecuzione avviato tramite i comandi serve o web.

codetutor attach [url]

Questo consente di usare la TUI con un backend CodeTutor remoto. Per esempio:

# Start the backend server for web/mobile access
codetutor web --port 4096 --hostname 0.0.0.0

# In un altro terminale, collega la TUI al backend in esecuzione
codetutor attach http://10.20.30.40:4096

Flag

Flag	Breve	Descrizione
--dir		Working directory in cui avviare la TUI
--continue	-c	Continua l’ultima sessione
--session	-s	ID sessione da continuare
--fork		Crea un fork della sessione durante la continuazione (usa con --continue o --session)
--password	-p	Password per l’autenticazione di base (predefinita: CODETUTOR_SERVER_PASSWORD)
--username	-u	Nome utente per l’autenticazione di base (predefinito: CODETUTOR_SERVER_USERNAME o codetutor)

---

create

Crea un nuovo agente con configurazione personalizzata.

codetutor agent create

Questo comando ti guida nella creazione di un nuovo agente con un system prompt personalizzato e configurazione degli strumenti.

---

list

Elenca tutti gli agenti disponibili.

codetutor agent list

---

auth

Comando per gestire le credenziali e il login dei provider.

codetutor auth [command]

---

login

CodeTutor si basa sull’elenco provider di Models.dev, quindi puoi usare codetutor auth login per configurare le API key per qualunque provider tu voglia usare. Le credenziali vengono salvate in ~/.local/share/opencode/auth.json.

codetutor auth login

Quando CodeTutor si avvia, carica i provider dal file delle credenziali e, se presenti, anche eventuali key definite nell’ambiente o in un file .env nel progetto.

---

list

Elenca tutti i provider autenticati come salvati nel file delle credenziali.

codetutor auth list

Oppure la versione corta.

codetutor auth ls

---

logout

Esegue il logout da un provider rimuovendolo dal file delle credenziali.

codetutor auth logout

---

github

Gestisci l’agente GitHub per l’automazione dei repository.

codetutor github [command]

---

install

Installa l’agente GitHub nel tuo repository.

codetutor github install

Questo configura il workflow GitHub Actions necessario e ti guida nel processo di configurazione. Scopri di più.

---

run

Esegui l’agente GitHub. Tipicamente usato in GitHub Actions.

codetutor github run

Flag

Flag	Descrizione
--event	Evento GitHub mock per cui eseguire l’agente
--token	GitHub personal access token

---

mcp

Gestisci i server Model Context Protocol.

codetutor mcp [command]

---

add

Aggiungi un server MCP alla tua configurazione.

codetutor mcp add

Questo comando ti guida nell’aggiunta di un server MCP locale o remoto.

---

list

Elenca tutti i server MCP configurati e il loro stato di connessione.

codetutor mcp list

Oppure la versione corta.

codetutor mcp ls

---

auth

Autentica con un server MCP con OAuth abilitato.

codetutor mcp auth [name]

Se non fornisci un nome server, ti verrà chiesto di selezionare tra i server OAuth-capable disponibili.

Puoi anche elencare i server OAuth-capable e il loro stato di autenticazione.

codetutor mcp auth list

Oppure la versione corta.

codetutor mcp auth ls

---

logout

Rimuovi le credenziali OAuth per un server MCP.

codetutor mcp logout [name]

---

debug

Esegui debug di problemi di connessione OAuth per un server MCP.

codetutor mcp debug <name>

---

models

Elenca tutti i modelli disponibili dai provider configurati.

codetutor models [provider]

Questo comando mostra tutti i modelli disponibili tra i provider configurati nel formato provider/model.

È utile per capire l’esatto nome del modello da usare nella config.

Puoi anche passare opzionalmente un ID provider per filtrare i modelli a quel provider.

codetutor models anthropic

Flag

Flag	Descrizione
--refresh	Aggiorna la cache modelli da models.dev
--verbose	Output più verboso (include metadati come i costi)

Usa --refresh per aggiornare l’elenco modelli in cache. È utile quando nuovi modelli vengono aggiunti a un provider e vuoi vederli in CodeTutor.

codetutor models --refresh

---

run

Esegui codetutor in modalità non interattiva passando un prompt direttamente.

codetutor run [message..]

È utile per scripting, automazione o quando vuoi una risposta rapida senza avviare la TUI completa. Per esempio:

codetutor run Explain the use of context in Go

Puoi anche collegarti a una istanza codetutor serve già in esecuzione per evitare i cold boot dei server MCP ad ogni esecuzione:

# Avvia un server headless in un terminale
codetutor serve

# In un altro terminale, esegui comandi che si collegano ad esso
codetutor run --attach http://localhost:4096 "Explain async/await in JavaScript"

Flag

Flag	Breve	Descrizione
--command		Il comando da eseguire; usa message per gli argomenti
--continue	-c	Continua l’ultima sessione
--session	-s	ID sessione da continuare
--fork		Duplica la sessione quando continui (usa con --continue o --session)
--share		Condividi la sessione
--model	-m	Modello nel formato provider/model
--agent		Agente da usare
--file	-f	File da allegare al messaggio
--format		Formato: default (formattato) o json (eventi JSON grezzi)
--title		Titolo sessione (usa prompt troncato se non viene fornito un valore)
--attach		Attach a un server codetutor in esecuzione (es. http://localhost:4096)
--password	-p	Password per l’autenticazione di base (predefinita: CODETUTOR_SERVER_PASSWORD)
--username	-u	Nome utente per l’autenticazione di base (predefinito: CODETUTOR_SERVER_USERNAME o codetutor)
--dir		Directory di esecuzione, o percorso sul server remoto durante il collegamento
--variant		Variante del modello (sforzo di ragionamento specifico del provider)
--thinking		Mostra blocchi di pensiero
--port		Porta per il server locale (di default una porta casuale)

---

serve

Avvia un server CodeTutor headless per accesso via API. Vedi le server docs per l’interfaccia HTTP completa.

codetutor serve

Avvia un server HTTP che espone accesso API alle funzionalità di codetutor senza la TUI. Imposta CODETUTOR_SERVER_PASSWORD per abilitare HTTP basic auth (username di default codetutor).

Flag

Flag	Descrizione
--port	Porta su cui mettersi in ascolto
--hostname	Hostname su cui mettersi in ascolto
--mdns	Abilita discovery mDNS
--cors	Origin browser addizionali per consentire CORS

---

session

Gestisci le sessioni CodeTutor.

codetutor session [command]

---

list

Elenca tutte le sessioni CodeTutor.

codetutor session list

Flag

Flag	Breve	Descrizione
--max-count	-n	Limita alle N sessioni più recenti
--format		Formato output: table o json (table)

---

stats

Mostra statistiche di utilizzo token e costo per le sessioni CodeTutor.

codetutor stats

Flag

Flag	Descrizione
--days	Mostra statistiche per gli ultimi N giorni (all time)
--tools	Numero di strumenti da mostrare (all)
--models	Mostra breakdown di utilizzo modelli (nascosto di default). Passa un numero per top N
--project	Filtra per progetto (tutti i progetti; stringa vuota: progetto corrente)

---

export

Esporta i dati di sessione come JSON.

codetutor export [sessionID]

Se non fornisci un ID sessione, ti verrà chiesto di selezionare tra le sessioni disponibili.

---

import

Importa i dati di sessione da un file JSON o da un URL di condivisione CodeTutor.

codetutor import <file>

Puoi importare da un file locale o da un URL di condivisione CodeTutor.

codetutor import session.json
codetutor import https://opncd.ai/s/abc123

---

web

Avvia un server CodeTutor headless con interfaccia web.

codetutor web

Avvia un server HTTP e apre un browser per accedere a CodeTutor tramite interfaccia web. Imposta CODETUTOR_SERVER_PASSWORD per abilitare HTTP basic auth (username di default codetutor).

Flag

Flag	Descrizione
--port	Porta su cui mettersi in ascolto
--hostname	Hostname su cui mettersi in ascolto
--mdns	Abilita discovery mDNS
--cors	Origin browser addizionali per consentire CORS

---

acp

Avvia un server ACP (Agent Client Protocol).

codetutor acp

Questo comando avvia un server ACP che comunica via stdin/stdout usando nd-JSON.

Flag

Flag	Descrizione
--cwd	Directory di lavoro
--port	Porta su cui mettersi in ascolto
--hostname	Hostname su cui mettersi in ascolto

---

uninstall

Disinstalla CodeTutor e rimuove tutti i file correlati.

codetutor uninstall

Flag

Flag	Breve	Descrizione
--keep-config	-c	Mantieni i file di configurazione
--keep-data	-d	Mantieni dati di sessione e snapshot
--dry-run		Mostra cosa verrebbe rimosso senza rimuovere
--force	-f	Salta le richieste di conferma

---

upgrade

Aggiorna codetutor all’ultima versione o a una versione specifica.

codetutor upgrade [target]

Per aggiornare all’ultima versione:

codetutor upgrade

Per aggiornare a una versione specifica:

codetutor upgrade v0.1.48

Flag

Flag	Breve	Descrizione
--method	-m	Metodo di installazione usato: curl, npm, pnpm, bun, brew

---

Flag globali

La CLI di codetutor accetta i seguenti flag globali.

Flag	Breve	Descrizione
--help	-h	Mostra l’help
--version	-v	Stampa il numero di versione
--print-logs		Stampa i log su stderr
--log-level		Livello log (DEBUG, INFO, WARN, ERROR)

---

Variabili d’ambiente

CodeTutor può essere configurato tramite variabili d’ambiente.

Variabile	Tipo	Descrizione
CODETUTOR_AUTO_SHARE	boolean	Condivide automaticamente le sessioni
CODETUTOR_GIT_BASH_PATH	string	Percorso all’eseguibile Git Bash su Windows
CODETUTOR_CONFIG	string	Percorso al file di configurazione
CODETUTOR_TUI_CONFIG	string	Percorso al file di configurazione TUI
CODETUTOR_CONFIG_DIR	string	Percorso alla directory di configurazione
CODETUTOR_CONFIG_CONTENT	string	Contenuto JSON di config inline
CODETUTOR_DISABLE_AUTOUPDATE	boolean	Disabilita i controlli automatici di aggiornamento
CODETUTOR_DISABLE_PRUNE	boolean	Disabilita la potatura dei dati vecchi
CODETUTOR_DISABLE_TERMINAL_TITLE	boolean	Disabilita aggiornamenti automatici del titolo terminale
CODETUTOR_PERMISSION	string	Config permessi JSON inline
CODETUTOR_DISABLE_DEFAULT_PLUGINS	boolean	Disabilita i plugin di default
CODETUTOR_DISABLE_LSP_DOWNLOAD	boolean	Disabilita download automatico dei server LSP
CODETUTOR_ENABLE_EXPERIMENTAL_MODELS	boolean	Abilita modelli sperimentali
CODETUTOR_DISABLE_AUTOCOMPACT	boolean	Disabilita compaction automatica del contesto
CODETUTOR_DISABLE_CLAUDE_CODE	boolean	Disabilita lettura da .claude (prompt + skill)
CODETUTOR_DISABLE_CLAUDE_CODE_PROMPT	boolean	Disabilita lettura di ~/.claude/CLAUDE.md
CODETUTOR_DISABLE_CLAUDE_CODE_SKILLS	boolean	Disabilita caricamento di .claude/skills
CODETUTOR_DISABLE_MODELS_FETCH	boolean	Disabilita fetch dei modelli da fonti remote
CODETUTOR_FAKE_VCS	string	Provider VCS finto per scopi di test
CODETUTOR_CLIENT	string	Identificatore client (default cli)
CODETUTOR_ENABLE_EXA	boolean	Abilita gli strumenti di web search Exa
CODETUTOR_SERVER_PASSWORD	string	Abilita basic auth per serve/web
CODETUTOR_SERVER_USERNAME	string	Sovrascrive lo username basic auth (default codetutor)
CODETUTOR_MODELS_URL	string	URL personalizzato per recuperare la configurazione modelli

---

Sperimentale

Queste variabili d’ambiente abilitano funzionalità sperimentali che potrebbero cambiare o essere rimosse.

Variabile	Tipo	Descrizione
CODETUTOR_EXPERIMENTAL	boolean	Abilita funzionalità sperimentali sotto il flag globale
CODETUTOR_EXPERIMENTAL_ICON_DISCOVERY	boolean	Abilita icon discovery
CODETUTOR_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolean	Disabilita copy on select nella TUI
CODETUTOR_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	Timeout di default per comandi bash in ms
CODETUTOR_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	Massimo token di output per risposte LLM
CODETUTOR_EXPERIMENTAL_FILEWATCHER	boolean	Abilita file watcher per l’intera dir
CODETUTOR_EXPERIMENTAL_OXFMT	boolean	Abilita formatter oxfmt
CODETUTOR_EXPERIMENTAL_LSP_TOOL	boolean	Abilita strumento LSP sperimentale
CODETUTOR_EXPERIMENTAL_DISABLE_FILEWATCHER	boolean	Disabilita file watcher
CODETUTOR_EXPERIMENTAL_EXA	boolean	Abilita funzionalità Exa sperimentali
CODETUTOR_EXPERIMENTAL_LSP_TY	boolean	Abilita TY LSP per i file python
CODETUTOR_EXPERIMENTAL_PLAN_MODE	boolean	Abilita plan mode
CODETUTOR_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolean	Abilita task subagent in background
CODETUTOR_EXPERIMENTAL_EVENT_SYSTEM	boolean	Abilita sistema eventi sperimentale
CODETUTOR_EXPERIMENTAL_NATIVE_LLM	boolean	Abilita percorso nativo di richiesta LLM
CODETUTOR_EXPERIMENTAL_PARALLEL	boolean	Abilita esecuzione parallela della ricerca web
CODETUTOR_EXPERIMENTAL_SCOUT	boolean	Abilita subagent Scout
CODETUTOR_EXPERIMENTAL_WORKSPACES	boolean	Abilita supporto workspace