Home/Docs/CLI — the jht command

⌨️ CLI — the jht command

The essential commands to drive the team from a terminal

Everything the desktop app and the web do, you can do with jht. It's the single surface humans, power users and AI assistants share — self-sufficient for day-to-day operation. Here are the commands you'll actually use.

💡 Every command supports --help. The full reference — every subcommand, flag, and the host-wrapper vs container split — is linked at the bottom.

📦 Container lifecycle

jht up         # start the container (pulls the image first run)
jht down       # stop it (keeps your data)
jht restart    # same image, fresh process
jht upgrade    # pull a newer image and restart
jht shell      # drop into the container for debugging
jht logs -f    # follow the container logs

🧩 Setup & health

jht setup      # interactive wizard: provider, OAuth, team start
jht doctor     # check Docker / Node / auth / DB — must exit 0
jht health     # granular service health
jht status     # container + agent process summary

🧠 Providers

jht providers list       # claude | codex | kimi
jht providers current    # active provider + model
jht providers use kimi   # switch the active provider
jht providers update     # (re)install the provider CLI

🤖 The team

jht team status              # running / stopped summary
jht team start [agent]       # start one agent, or the whole team
jht team stop  [agent]       # stop one, or --all
jht team chat  <agent>       # interactive chat with an agent
jht team send  <agent> "…"   # one-shot message to an agent

To reload the team after editing config: jht team stop --all && jht team start.

📊 Positions & monitoring

jht positions list           # jobs in the local DB
jht positions show <id>      # detail of one position
jht stats                    # found / scored / applied counts
jht sentinella status        # usage projection (rate-limit watch)
jht sentinella graph         # ASCII usage over time

☁️ Cloud sync

jht cloud login    # browser device-flow pairing with your web account
jht cloud status   # sync state + last push time
jht cloud push     # push local data to the cloud now
jht cloud disable  # unlink this machine (revoke separately on the web)

🔁 Common one-liners

# Fresh setup (Local or VPS — same command)
jht up && jht setup

# Switch provider and reload
jht providers use codex && jht providers update codex
jht team stop --all && jht team start

# Daily check
jht status && jht doctor

# Full reset (asks for confirmation)
jht reset full

Going deeper

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

caricamento…

jht up # start the container (pulls the image first run) jht down # stop it (keeps your data) jht restart # same image, fresh process jht upgrade # pull a newer image and restart jht shell # drop into the container for debugging jht logs -f # follow the container logs

jht setup # interactive wizard: provider, OAuth, team start jht doctor # check Docker / Node / auth / DB — must exit 0 jht health # granular service health jht status # container + agent process summary

jht providers list # claude | codex | kimi jht providers current # active provider + model jht providers use kimi # switch the active provider jht providers update # (re)install the provider CLI

🤖 The team

jht team status # running / stopped summary jht team start [agent] # start one agent, or the whole team jht team stop [agent] # stop one, or --all jht team chat <agent> # interactive chat with an agent jht team send <agent> "…" # one-shot message to an agent

To reload the team after editing config: jht team stop --all && jht team start.

jht positions list # jobs in the local DB jht positions show <id> # detail of one position jht stats # found / scored / applied counts jht sentinella status # usage projection (rate-limit watch) jht sentinella graph # ASCII usage over time

jht cloud login # browser device-flow pairing with your web account jht cloud status # sync state + last push time jht cloud push # push local data to the cloud now jht cloud disable # unlink this machine (revoke separately on the web)

🔁 Common one-liners

# Fresh setup (Local or VPS — same command) jht up && jht setup # Switch provider and reload jht providers use codex && jht providers update codex jht team stop --all && jht team start # Daily check jht status && jht doctor # Full reset (asks for confirmation) jht reset full

Going deeper

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