Servicio KitTerminal
Una shell Linux persistente expuesta como endpoint HTTPS. Ejecuta comandos vía API, conéctate desde cualquier navegador, transmite por WebSocket o accede directamente por SSH. Las sesiones persisten entre reconexiones.
# Obtén tu token
$ curl https://your-terminal.hoody.com/token
> eyJhbG...
# Ejecuta tu primer comando
$ curl -X POST .../api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '["command":"echo Hello from Hoody!","wait":true]'
> ["success":true,"stdout":"Hello from Hoody!\n","duration_ms":3]
# Comparte la URL — cualquiera puede conectarse
https://proj-dev-terminal-1.server.containers.hoody.com
Cinco formas de usar Terminal
Terminal se adapta a tu flujo de trabajo. Ejecuta comandos vía HTTP, transmite compilaciones por WebSocket, colabora en tiempo real, lanza apps gráficas o monitorea recursos del sistema, todo desde la misma URL.
Comandos por HTTP
Haz POST de un comando shell a cualquier sesión de terminal. Recibe JSON estructurado con stdout, stderr, código de salida y tiempo. Sin túnel SSH, sin librería cliente, solo HTTP.
# antes / después
- ssh user@server 'ls -la /app' 2>/dev/null
+ curl -X POST terminal.hoody.com/api/v1/terminal/execute -d '["command":"ls -la /app"]'
$ curl -X POST /api/v1/terminal/execute \
-d '["command": "npm test", "wait": true]'
> HTTP/1.1 200 OK
> [
> "success": true,
> "exit_code": 0,
> "stdout": "24 passed, 0 failed",
> "duration_ms": 12
> ]
Cada comando es una llamada a la API
Haz POST de un comando y recibe JSON estructurado con stdout, stderr, código de salida y metadatos de tiempo. Síncrono o asíncrono con polling.
Ver todos los endpoints# Execute a command via Terminal HTTP API
curl -X POST \
https://proj-dev-terminal-1.hoody.com/api/v1/terminal/execute \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"command": "ls -la /app",
"wait": true
}'
# Response:
# {
# "success": true,
# "exit_code": 0,
# "stdout": "total 48\ndrwxr-xr-x ...",
# "stderr": "",
# "duration_ms": 12
# }
Construido para flujos de trabajo reales
Terminal cubre toda la gama de escenarios de desarrollo y automatización. Cada caso de uso se mapea a endpoints de API específicos y parámetros de URL.
Desarrollo remoto
Accede por SSH a tu contenedor desde cualquier dispositivo con navegador. Acceso completo a shell con sesiones persistentes: retoma donde lo dejaste desde tu teléfono, tableta u otro equipo.
Orquestación de agentes de IA
Los agentes ejecutan comandos shell vía la API HTTP. Compilar, probar, desplegar: la API de Terminal da a los agentes de IA acceso estructurado a todo tu entorno de desarrollo.
Depuración en equipo
Comparte una URL de terminal con tu equipo para depuración multijugador. Todos ven el mismo resultado, escriben comandos y reciben colores de cursor únicos en tiempo real.
Aplicaciones gráficas
Lanza cualquier aplicación gráfica desde la terminal. Firefox, VS Code, GIMP: terminal-N se mapea automáticamente a display-N sin configuración de reenvío X11.
Integración CI/CD
Ejecuta pasos de compilación, pruebas y despliegue de artefactos, todo vía HTTP. Integra Terminal en cualquier pipeline de CI con simples llamadas curl y respuestas JSON estructuradas.
Monitoreo en vivo
Estadísticas de CPU, memoria, disco y red en tiempo real vía API. Lista procesos, envía señales, inspecciona puertos: visibilidad total del sistema mediante endpoints estructurados.
19 endpoints, control total
Cuatro dominios: ejecución de comandos, gestión de sesiones, streaming en vivo vía WebSocket y monitoreo del sistema. Cada endpoint devuelve JSON estructurado con autenticación bearer token.
Gestión de sesiones
7 endpointscurl .../sessions → [{terminal_id: "1", shell: "bash"}]
Sistema y meta
6 endpointscurl .../system/resources → {cpu: 45%, mem: 8GB}
Ejecución de comandos
4 endpointscurl -X POST .../execute -d '{"command":"npm test"}'
Streaming en vivo
2 endpointsWS .../sessions/1/ws → real-time stdout frames
Todo integrado
Cada función está disponible desde el primer momento sin ninguna configuración. Terminal viene lista para usar en el momento en que arranca tu contenedor.
Sesiones persistentes
Directorio de trabajo, variables de entorno, historial de shell: todo sobrevive cierres de navegador y reconexiones.
Selección de shell
bash, zsh, fish, tmux, sh: cambia de shell vía parámetro de URL. Preinstalados y listos para usar.
Puente tmux
Sesiones tmux compartidas entre acceso web y SSH. terminal-3 en el navegador se mapea a sesión tmux 3 por SSH.
Capturas de terminal
Captura el estado de la terminal como PNG, JPEG o GIF vía API. Colores y tamaño de fuente configurables para documentación.
Reinicio de sesión
Mata todos los procesos, limpia el entorno y restablece el directorio de trabajo con un solo parámetro de URL. Tabla rasa al instante.
Spec OpenAPI
API autodocumentada en /api/v1/terminal/openapi.json. Genera clientes tipados en cualquier lenguaje automáticamente.
¿Listo para explorar?
Terminal es uno de los 14 servicios Kit que vienen con cada contenedor Hoody. Sin instalación, sin configuración: explora los docs o navega la referencia de la API arriba.