El comando joppa

joppa controla la app en ejecución. Hace lo mismo que la ventana, desde una terminal o un script.

Instalar

Ajustes › Línea de comandos › Instalar joppa. Joppa crea un enlace al comando incluido en la app, en /usr/local/bin si es posible o, si no, en ~/.local/bin. Si esa carpeta no está en tu PATH, los Ajustes te dan la línea que debes añadir a ~/.zshrc.

joppa version

Los comandos

joppa                         # la app a pantalla completa en la terminal (TUI)
joppa status                  # proxy, CA, proyectos y dominios, servicios
joppa services                # los servicios y su estado
joppa start postgres          # inicia un servicio
joppa stop redis              # detiene un servicio
joppa logs postgres -n 200 -f # el registro, en continuo con -f
joppa dbs postgres            # las bases de datos y sus URL de conexión
joppa proxy start             # o stop
joppa open                    # muestra la ventana de Joppa
joppa mcp                     # el servidor MCP (ver más abajo)

Comando	Alias	Función
joppa o joppa tui		Abre el TUI
joppa status	st	Proxy, CA, proyectos, dominios y su salud, servicios
joppa services	svc	Los servicios y su estado
joppa start <service>		Inicia un servicio
joppa stop <service>		Detiene un servicio
joppa logs <service>	log	El registro: -n / --lines N (100 por defecto), -f / --follow
joppa dbs <service>	databases	Las bases de datos de un servidor y sus URL
joppa proxy start|stop		Inicia o detiene el proxy
joppa open		Muestra la ventana
joppa mcp		Inicia el servidor MCP en stdio
joppa help, joppa version		Ayuda y versión

Indicar un servicio

Puedes referirte a un servicio como quieras: postgres, pg17, "PostgreSQL 17", su puerto 5432 o su identificador.

Las opciones

Opción	Efecto
--json, -j	Salida JSON, para los scripts (en todos los comandos)
--launch	Inicia Joppa si no está en marcha, sin preguntar
--theme nuit|jour|auto	Tema del TUI
--no-motion	Desactiva las animaciones (o JOPPA_NO_MOTION=1)
-h, -v	Ayuda, versión

En un script

# Iniciar Joppa si hace falta y luego arrancar PostgreSQL antes de los tests
joppa start postgres --launch
joppa services --json | jq .

Códigos de salida

Código	Significado
0	Éxito
1	Error
2	Comando u opción incorrectos
3	Joppa no está en marcha

Cómo funciona

La app escribe en su carpeta de configuración un archivo control.json (un puerto y un token, legible solo por ti). El comando lo usa para hablar con la API local de la app. Si Joppa no está en marcha, joppa lo dice y propone iniciarlo.