CLI — Ghosty desde la terminal

ghosty es el CLI oficial de Ghosty Studio. Sirve para lo mismo que el panel —configurar, probar y platicar con tus agentes— pero desde la terminal, y está hecho para que tu agente de código (Claude Code, Codex, Cursor) también lo use.

Instalar

Necesitas Node 22 o más nuevo.

Entrar

ghosty login

Se abre tu navegador, entras con tu cuenta de Ghosty (Google, Apple o correo) y listo: la terminal queda con sesión. Si ya tenías sesión abierta en ghosty.studio, no tienes que hacer nada más que abrir la liga.

• Si el navegador no se abre solo, la terminal imprime la liga para que la copies.
• La sesión se renueva sola; dura 90 días sin uso antes de pedirte entrar de nuevo.
• Si corres un comando sin sesión, el login arranca solo.
• ¿Estás por SSH o en otra máquina? ghosty login --device te da una liga y un código para autorizar desde tu teléfono (por SSH lo hace solo).
• ghosty whoami te dice con qué cuenta estás; ghosty logout cierra la sesión y la revoca.
• ghosty usage te dice tu plan y cuánto llevas usado esta semana y este mes.

Que tu agente de código lo haga por ti

Pídele a Claude Code «entra a Ghosty con el CLI». Él corre ghosty login, te pasa la liga en el chat, tú la abres y él sigue solo. Detalle en CLI para agentes de código.

Primeros pasos

ghosty agents ls                          # tus agentesghosty try <agent-id> "hola, ¿quién eres?"  # un turno de pruebaghosty chat <agent-id>                    # conversación en vivo

Todos los comandos, con ejemplos, en la referencia de comandos. Si tu producto le quiere dar un agente a cada uno de sus clientes, mira Partners.

Dónde se guarda la sesión

En ~/.config/ghosty/config.json, con permisos sólo para tu usuario (o en $XDG_CONFIG_HOME/ghosty/ si defines esa variable). Para apuntar a otro servidor usa la variable GHOSTY_URL.

¿Dos cuentas en la misma máquina, la tuya y la de un cliente? Usa perfiles: cada uno guarda su sesión aparte, en config.<nombre>.json.

ghosty --profile cliente loginghosty --profile cliente agents lsexport GHOSTY_PROFILE=cliente             # o para toda la terminal

Con NO_COLOR definida, el CLI no usa colores ni enseña el banner.