CLI

Opzioni e comandi della CLI di AicippY.

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

aicippy-code

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

aicippy-code run "Explain how closures work in JavaScript"

tui

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

aicippy-code [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 AicippY include anche i seguenti comandi.

agent

Gestisci gli agenti per AicippY.

aicippy-code agent [command]

attach

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

aicippy-code attach [url]

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

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

# In un altro terminale, collega la TUI al backend in esecuzione
aicippy-code 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: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Nome utente per l’autenticazione di base (predefinito: `AICIPPY_CODE_SERVER_USERNAME` o `aicippy-code`)

create

Crea un nuovo agente con configurazione personalizzata.

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

aicippy-code agent list

auth

Comando per gestire le credenziali e il login dei provider.

aicippy-code auth [command]

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

aicippy-code auth login

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

aicippy-code auth list

Oppure la versione corta.

aicippy-code auth ls

logout

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

aicippy-code auth logout

github

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

aicippy-code github [command]

install

Installa l’agente GitHub nel tuo repository.

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

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

aicippy-code mcp [command]

add

Aggiungi un server MCP alla tua configurazione.

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

aicippy-code mcp list

Oppure la versione corta.

aicippy-code mcp ls

auth

Autentica con un server MCP con OAuth abilitato.

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

aicippy-code mcp auth list

Oppure la versione corta.

aicippy-code mcp auth ls

logout

Rimuovi le credenziali OAuth per un server MCP.

aicippy-code mcp logout [name]

debug

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

aicippy-code mcp debug <name>

models

Elenca tutti i modelli disponibili dai provider configurati.

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

aicippy-code models anthropic

Flag

Flag	Descrizione
`--refresh`	Aggiorna la cache modelli da models.aicippy.com
`--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 AicippY.

aicippy-code models --refresh

run

Esegui aicippy-code in modalità non interattiva passando un prompt direttamente.

aicippy-code run [message..]

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

aicippy-code run Explain the use of context in Go

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

# Avvia un server headless in un terminale
aicippy-code serve

# In un altro terminale, esegui comandi che si collegano ad esso
aicippy-code 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 aicippy-code in esecuzione (es. http://localhost:4096)
`--password`	`-p`	Password per l’autenticazione di base (predefinita: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Nome utente per l’autenticazione di base (predefinito: `AICIPPY_CODE_SERVER_USERNAME` o `aicippy-code`)
`--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 AicippY headless per accesso via API. Vedi le server docs per l’interfaccia HTTP completa.

aicippy-code serve

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

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

aicippy-code session [command]

list

Elenca tutte le sessioni AicippY.

aicippy-code 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 AicippY.

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

aicippy-code 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 AicippY.

aicippy-code import <file>

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

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

web

Avvia un server AicippY headless con interfaccia web.

aicippy-code web

Avvia un server HTTP e apre un browser per accedere a AicippY tramite interfaccia web. Imposta AICIPPY_CODE_SERVER_PASSWORD per abilitare HTTP basic auth (username di default aicippy-code).

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

aicippy-code 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 AicippY e rimuove tutti i file correlati.

aicippy-code 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 aicippy-code all’ultima versione o a una versione specifica.

aicippy-code upgrade [target]

Per aggiornare all’ultima versione:

aicippy-code upgrade

Per aggiornare a una versione specifica:

aicippy-code upgrade v0.1.48

Flag

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

Flag globali

La CLI di aicippy-code 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

AicippY può essere configurato tramite variabili d’ambiente.

Variabile	Tipo	Descrizione
`AICIPPY_CODE_AUTO_SHARE`	boolean	Condivide automaticamente le sessioni
`AICIPPY_CODE_GIT_BASH_PATH`	string	Percorso all’eseguibile Git Bash su Windows
`AICIPPY_CODE_CONFIG`	string	Percorso al file di configurazione
`AICIPPY_CODE_TUI_CONFIG`	string	Percorso al file di configurazione TUI
`AICIPPY_CODE_CONFIG_DIR`	string	Percorso alla directory di configurazione
`AICIPPY_CODE_CONFIG_CONTENT`	string	Contenuto JSON di config inline
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	boolean	Disabilita i controlli automatici di aggiornamento
`AICIPPY_CODE_DISABLE_PRUNE`	boolean	Disabilita la potatura dei dati vecchi
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	boolean	Disabilita aggiornamenti automatici del titolo terminale
`AICIPPY_CODE_PERMISSION`	string	Config permessi JSON inline
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	boolean	Disabilita i plugin di default
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	boolean	Disabilita download automatico dei server LSP
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	boolean	Abilita modelli sperimentali
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	boolean	Disabilita compaction automatica del contesto
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	boolean	Disabilita lettura da `.claude` (prompt + skill)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Disabilita lettura di `~/.claude/CLAUDE.md`
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Disabilita caricamento di `.claude/skills`
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	boolean	Disabilita fetch dei modelli da fonti remote
`AICIPPY_CODE_FAKE_VCS`	string	Provider VCS finto per scopi di test
`AICIPPY_CODE_CLIENT`	string	Identificatore client (default `cli`)
`AICIPPY_CODE_ENABLE_EXA`	boolean	Abilita gli strumenti di web search Exa
`AICIPPY_CODE_SERVER_PASSWORD`	string	Abilita basic auth per `serve`/`web`
`AICIPPY_CODE_SERVER_USERNAME`	string	Sovrascrive lo username basic auth (default `aicippy-code`)
`AICIPPY_CODE_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
`AICIPPY_CODE_EXPERIMENTAL`	boolean	Abilita funzionalità sperimentali sotto il flag globale
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Abilita icon discovery
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Disabilita copy on select nella TUI
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Timeout di default per comandi bash in ms
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Massimo token di output per risposte LLM
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	boolean	Abilita file watcher per l’intera dir
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	boolean	Abilita formatter oxfmt
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	boolean	Abilita strumento LSP sperimentale
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Disabilita file watcher
`AICIPPY_CODE_EXPERIMENTAL_EXA`	boolean	Abilita funzionalità Exa sperimentali
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	boolean	Abilita TY LSP per i file python
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	boolean	Abilita plan mode
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	Abilita task subagent in background
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	boolean	Abilita sistema eventi sperimentale
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	boolean	Abilita percorso nativo di richiesta LLM
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	boolean	Abilita esecuzione parallela della ricerca web
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	boolean	Abilita subagent Scout
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	boolean	Abilita supporto workspace