CLI

Opzioni e comandi della CLI di HanuBees.

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

HanuBees

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

HanuBees run "Explain how closures work in JavaScript"

tui

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

HanuBees [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 HanuBees include anche i seguenti comandi.

agent

Gestisci gli agenti per HanuBees.

HanuBees agent [command]

attach

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

HanuBees attach [url]

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

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

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

create

Crea un nuovo agente con configurazione personalizzata.

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

HanuBees agent list

auth

Comando per gestire le credenziali e il login dei provider.

HanuBees auth [command]

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

HanuBees auth login

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

HanuBees auth list

Oppure la versione corta.

HanuBees auth ls

logout

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

HanuBees auth logout

github

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

HanuBees github [command]

install

Installa l’agente GitHub nel tuo repository.

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

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

HanuBees mcp [command]

add

Aggiungi un server MCP alla tua configurazione.

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

HanuBees mcp list

Oppure la versione corta.

HanuBees mcp ls

auth

Autentica con un server MCP con OAuth abilitato.

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

HanuBees mcp auth list

Oppure la versione corta.

HanuBees mcp auth ls

logout

Rimuovi le credenziali OAuth per un server MCP.

HanuBees mcp logout [name]

debug

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

HanuBees mcp debug <name>

models

Elenca tutti i modelli disponibili dai provider configurati.

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

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

HanuBees models --refresh

run

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

HanuBees run [message..]

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

HanuBees run Explain the use of context in Go

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

# Avvia un server headless in un terminale
HanuBees serve

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

HanuBees serve

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

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

HanuBees session [command]

list

Elenca tutte le sessioni HanuBees.

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

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

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

HanuBees import <file>

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

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

web

Avvia un server HanuBees headless con interfaccia web.

HanuBees web

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

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

HanuBees 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 HanuBees e rimuove tutti i file correlati.

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

HanuBees upgrade [target]

Per aggiornare all’ultima versione:

HanuBees upgrade

Per aggiornare a una versione specifica:

HanuBees upgrade v0.1.48

Flag

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

Flag globali

La CLI di HanuBees 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

HanuBees può essere configurato tramite variabili d’ambiente.

Variabile	Tipo	Descrizione
`HanuBees_AUTO_SHARE`	boolean	Condivide automaticamente le sessioni
`HanuBees_GIT_BASH_PATH`	string	Percorso all’eseguibile Git Bash su Windows
`HanuBees_CONFIG`	string	Percorso al file di configurazione
`HanuBees_TUI_CONFIG`	string	Percorso al file di configurazione TUI
`HanuBees_CONFIG_DIR`	string	Percorso alla directory di configurazione
`HanuBees_CONFIG_CONTENT`	string	Contenuto JSON di config inline
`HanuBees_DISABLE_AUTOUPDATE`	boolean	Disabilita i controlli automatici di aggiornamento
`HanuBees_DISABLE_PRUNE`	boolean	Disabilita la potatura dei dati vecchi
`HanuBees_DISABLE_TERMINAL_TITLE`	boolean	Disabilita aggiornamenti automatici del titolo terminale
`HanuBees_PERMISSION`	string	Config permessi JSON inline
`HanuBees_DISABLE_DEFAULT_PLUGINS`	boolean	Disabilita i plugin di default
`HanuBees_DISABLE_LSP_DOWNLOAD`	boolean	Disabilita download automatico dei server LSP
`HanuBees_ENABLE_EXPERIMENTAL_MODELS`	boolean	Abilita modelli sperimentali
`HanuBees_DISABLE_AUTOCOMPACT`	boolean	Disabilita compaction automatica del contesto
`HanuBees_DISABLE_CLAUDE_CODE`	boolean	Disabilita lettura da `.claude` (prompt + skill)
`HanuBees_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Disabilita lettura di `~/.claude/CLAUDE.md`
`HanuBees_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Disabilita caricamento di `.claude/skills`
`HanuBees_DISABLE_MODELS_FETCH`	boolean	Disabilita fetch dei modelli da fonti remote
`HanuBees_FAKE_VCS`	string	Provider VCS finto per scopi di test
`HanuBees_CLIENT`	string	Identificatore client (default `cli`)
`HanuBees_ENABLE_EXA`	boolean	Abilita gli strumenti di web search Exa
`HanuBees_SERVER_PASSWORD`	string	Abilita basic auth per `serve`/`web`
`HanuBees_SERVER_USERNAME`	string	Sovrascrive lo username basic auth (default `HanuBees`)
`HanuBees_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
`HanuBees_EXPERIMENTAL`	boolean	Abilita funzionalità sperimentali sotto il flag globale
`HanuBees_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Abilita icon discovery
`HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Disabilita copy on select nella TUI
`HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Timeout di default per comandi bash in ms
`HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Massimo token di output per risposte LLM
`HanuBees_EXPERIMENTAL_FILEWATCHER`	boolean	Abilita file watcher per l’intera dir
`HanuBees_EXPERIMENTAL_OXFMT`	boolean	Abilita formatter oxfmt
`HanuBees_EXPERIMENTAL_LSP_TOOL`	boolean	Abilita strumento LSP sperimentale
`HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Disabilita file watcher
`HanuBees_EXPERIMENTAL_EXA`	boolean	Abilita funzionalità Exa sperimentali
`HanuBees_EXPERIMENTAL_LSP_TY`	boolean	Abilita TY LSP per i file python
`HanuBees_EXPERIMENTAL_PLAN_MODE`	boolean	Abilita plan mode
`HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	Abilita task subagent in background
`HanuBees_EXPERIMENTAL_EVENT_SYSTEM`	boolean	Abilita sistema eventi sperimentale
`HanuBees_EXPERIMENTAL_NATIVE_LLM`	boolean	Abilita percorso nativo di richiesta LLM
`HanuBees_EXPERIMENTAL_PARALLEL`	boolean	Abilita esecuzione parallela della ricerca web
`HanuBees_EXPERIMENTAL_SCOUT`	boolean	Abilita subagent Scout
`HanuBees_EXPERIMENTAL_WORKSPACES`	boolean	Abilita supporto workspace