La commande joppa

joppa pilote l’app qui tourne. Elle fait la même chose que la fenêtre, depuis un terminal ou un script.

Installer

Réglages › Ligne de commande › Installer joppa. Joppa crée un lien vers la commande livrée dans l’app, dans /usr/local/bin si possible, sinon dans ~/.local/bin. Si ce dossier n’est pas dans votre PATH, les Réglages donnent la ligne à ajouter à ~/.zshrc.

joppa version

Les commandes

joppa                         # l'app en plein écran dans le terminal (TUI)
joppa status                  # proxy, CA, projets et domaines, services
joppa services                # les services et leur état
joppa start postgres          # démarre un service
joppa stop redis              # arrête un service
joppa logs postgres -n 200 -f # le journal, en continu avec -f
joppa dbs postgres            # les bases et leurs URL de connexion
joppa proxy start             # ou stop
joppa open                    # affiche la fenêtre de Joppa
joppa mcp                     # le serveur MCP (voir plus bas)

Commande	Alias	Rôle
joppa ou joppa tui		Ouvre le TUI
joppa status	st	Proxy, CA, projets, domaines et leur santé, services
joppa services	svc	Les services et leur état
joppa start <service>		Démarre un service
joppa stop <service>		Arrête un service
joppa logs <service>	log	Le journal : -n / --lines N (100 par défaut), -f / --follow
joppa dbs <service>	databases	Les bases d’un serveur et leurs URL
joppa proxy start|stop		Démarre ou arrête le proxy
joppa open		Affiche la fenêtre
joppa mcp		Lance le serveur MCP sur stdio
joppa help, joppa version		Aide et version

Désigner un service

Un service se désigne comme vous voulez : postgres, pg17, "PostgreSQL 17", son port 5432 ou son identifiant.

Les options

Option	Effet
--json, -j	Sortie JSON, pour les scripts (sur toutes les commandes)
--launch	Lance Joppa s’il ne tourne pas, sans demander
--theme nuit|jour|auto	Thème du TUI
--no-motion	Coupe les animations (ou JOPPA_NO_MOTION=1)
-h, -v	Aide, version

Dans un script

# Lancer Joppa si besoin, puis démarrer PostgreSQL avant les tests
joppa start postgres --launch
joppa services --json | jq .

Codes de sortie

Code	Signification
0	Succès
1	Erreur
2	Mauvaise commande ou option
3	Joppa n’est pas lancé

Comment ça marche

L’app écrit dans son dossier de config un fichier control.json (un port et un jeton, lisible par vous seul). La commande s’en sert pour parler à l’API locale de l’app. Si Joppa ne tourne pas, joppa le dit et propose de le lancer.