Home/Docs/CLI — il comando jht

⌨️ CLI — il comando jht

I comandi essenziali per guidare il team da terminale

Tutto ciò che fa il web — e che farà l'app desktop in arrivo — lo puoi fare con jht. È l'unica superficie condivisa da esseri umani, utenti esperti e assistenti AI — autosufficiente per l'uso quotidiano. Ecco i comandi che userai davvero.

💡 Ogni comando supporta --help. Il riferimento completo — ogni sottocomando, flag e la distinzione host-wrapper vs container — è linkato in fondo.

📦 Ciclo di vita del container

jht up         # avvia il container (scarica l'immagine al primo avvio)
jht down       # fermalo (conserva i tuoi dati)
jht restart    # stessa immagine, processo nuovo
jht upgrade    # scarica un'immagine più recente e riavvia
jht shell      # entra nel container per il debug
jht logs -f    # segui i log del container

🧩 Setup e salute

jht setup      # wizard interattivo: provider, OAuth, avvio del team
jht doctor     # controlla Docker / Node / auth / DB — deve uscire con 0
jht health     # salute granulare dei servizi
jht status     # stato del container

🧠 Provider

jht providers list       # claude | codex | kimi
jht providers current    # provider + modello attivi
jht providers use kimi   # cambia il provider attivo
jht providers update     # (re)installa la CLI del provider

🤖 Il team

jht team status              # riepilogo in esecuzione / fermi
jht team start [agent]       # avvia un agente, o tutto il team
jht team stop  [agent]       # ferma un agente, o --all
jht team chat  <agent>       # chat interattiva con un agente
jht team send  <agent> "…"   # messaggio one-shot a un agente

Per ricaricare il team dopo aver modificato la config: jht team stop --all && jht team start.

📊 Posizioni e monitoraggio

jht positions list           # offerte nel DB locale
jht positions show <id>      # dettaglio di una posizione
jht stats                    # conteggi trovate / valutate / candidate
jht sentinella status        # proiezione del consumo (controllo rate-limit)
jht sentinella graph         # consumo nel tempo in ASCII

☁️ Sincronizzazione cloud

jht cloud login    # abbinamento via device-flow del browser col tuo account web
jht cloud status   # stato sync + orario dell'ultimo push
jht cloud push     # invia subito i dati locali al cloud
jht cloud disable  # ferma il sync e revoca il token del dispositivo

🔁 One-liner comuni

# Setup da zero (Local o VPS — stesso comando)
jht up && jht setup

# Cambia provider e ricarica
jht providers use codex && jht providers update codex
jht team stop --all && jht team start

# Controllo quotidiano
jht status && jht doctor

# Reset completo (chiede conferma)
jht reset --scope full

Going deeper

These docs are the essentials. For the full detail, the exact flags and the code itself, read the source: il riferimento completo della CLI ↗