Referencia CLI

Para usuarios avanzados

La mayoría de usuarios nunca necesitan la CLI. El plugin del IDE lo hace todo automáticamente. Esta referencia es para automatización, scripts y escenarios de resolución de problemas.

---

Cuándo usar la CLI

Escenario	¿Por qué CLI?
El IDE no encuentra la JVM	Ejecutar galataj doctor
Servidores sin interfaz	No hay IDE disponible
Docker	Adjuntar manualmente
Depuración	Comprobar estado, logs

---

Comandos esenciales

galataj doctor

Diagnostica problemas del sistema. Ejecuta esto primero cuando algo no funcione.

galataj doctor

✓ CLI: v1.0.0
✓ Java: Found (17.0.1)
✓ Controller: Found
✓ Agent: Found
✓ Controller: Running
✓ Ports: Available

galataj status

Comprueba qué está en ejecución.

galataj status

Controller: Running (PID: 12345)
HTTP Port: 9877
TCP Port: 9876

Attached JVMs: 1
- abc123 (PID: 67890) - MyApp

galataj jvms

Lista las JVMs disponibles.

galataj jvms

Found 2 JVM(s):

1. com.example.MyApp
   ID: abc123
   PID: 12345

2. order-service
   ID: def456
   Environment: docker

galataj attach

Adjunta el profiler a una JVM.

# Por PID
galataj attach --pid 12345

# Por ID de JVM
galataj attach --jvm-id abc123

galataj detach

Detiene el profiling de una JVM.

galataj detach --jvm-id abc123

---

Gestión del controlador

# Iniciar controlador
galataj controller start

# Iniciar con puerto personalizado
galataj controller start --port 8888

# Detener controlador
galataj controller stop

---

Comandos de licencia

# Comprobar estado
galataj license status

# Activar licencia
galataj license login YOUR-LICENSE-KEY

# Abrir página de compra
galataj license purchase

# Validar licencia
galataj license validate

---

Salida JSON

La mayoría de comandos admiten --json para scripts:

galataj jvms --json
galataj status --json
galataj license status --json
galataj doctor --json

---

Códigos de salida

Código	Significado
0	Éxito
1	Error general
2	Controlador no en ejecución
3	JVM no encontrada
4	Error al adjuntar
5	Error de licencia