Serviço KitTerminal
Um shell Linux persistente exposto como endpoint HTTPS. Execute comandos via API, conecte-se de qualquer navegador, colabore em tempo real.
# Obtenha seu token
$ curl https://your-terminal.hoody.com/token
> eyJhbG...
# Execute seu primeiro 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]
# Compartilhe a URL — qualquer um pode conectar
https://proj-dev-terminal-1.server.containers.hoody.com
Cinco formas de usar o Terminal
O Terminal se adapta ao seu modo de trabalho. Execute comandos via HTTP, transmita builds via WebSocket, colabore em tempo real.
Comandos via HTTP
POST um comando shell para qualquer sessão de terminal. Receba JSON estruturado com stdout, stderr, código de saída e metadados de tempo.
# antes / depois
- 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
> ]
Todo comando é uma chamada de API
POST um comando, receba JSON estruturado de volta com stdout, stderr, código de saída e metadados de tempo. Sync e async suportados.
Ver Todos os 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
# }
Construído para fluxos de trabalho reais
O Terminal cobre toda a gama de cenários de desenvolvedor e automação. Cada caso de uso mapeia para endpoints específicos da API.
Desenvolvimento Remoto
Acesse SSH no seu contêiner de qualquer dispositivo com navegador. Acesso completo ao shell com sessões persistentes e múltiplas janelas.
Orquestração de Agente de IA
Agentes executam comandos shell via HTTP API. Construir, testar, fazer deploy — a API do Terminal dá à IA acesso completo ao shell.
Debug em Equipe
Compartilhe uma URL de terminal com sua equipe para debug multiplayer. Todos veem a mesma saída, digitam comandos e colaboram em tempo real.
Aplicações GUI
Inicie qualquer app gráfico pelo terminal. Firefox, VS Code, GIMP — terminal-N mapeia automaticamente para display-N.
Integração CI/CD
Execute etapas de build, rode testes, faça deploy de artefatos — tudo via HTTP. Integre o Terminal em qualquer pipeline CI/CD.
Monitoramento ao Vivo
Estatísticas em tempo real de CPU, memória, disco e rede via API. Liste processos, envie sinais, inspecione o estado do sistema.
19 endpoints, controle total
Quatro domínios: execução de comandos, gerenciamento de sessões, streaming ao vivo via WebSocket e monitoramento de sistema.
Gerenciamento de Sessões
7 endpointscurl .../sessions → [{terminal_id: "1", shell: "bash"}]
Sistema e Meta
6 endpointscurl .../system/resources → {cpu: 45%, mem: 8GB}
Execução de Comandos
4 endpointscurl -X POST .../execute -d '{"command":"npm test"}'
Streaming ao Vivo
2 endpointsWS .../sessions/1/ws → real-time stdout frames
Tudo embutido
Todo recurso está disponível pronto para uso sem configuração. O Terminal vem pronto para uso no momento em que seu contêiner sobe.
Sessões Persistentes
Diretório de trabalho, variáveis de ambiente, histórico do shell — tudo sobrevive a fechamentos do navegador e reconexões.
Seleção de Shell
bash, zsh, fish, tmux, sh — troque shells via parâmetro URL. Pré-instalado e pronto para usar.
Bridge tmux
Sessões tmux compartilhadas entre acesso web e SSH. terminal-3 no navegador mapeia para a sessão 3 do tmux no servidor.
Screenshots do Terminal
Capture o estado do terminal como PNG, JPEG ou GIF via API. Cores e tamanho de fonte configuráveis para documentação.
Reset de Sessão
Mate todos os processos, limpe o ambiente, reinicie o diretório de trabalho com um único parâmetro URL. Começo limpo.
Spec OpenAPI
API auto-documentada em /api/v1/terminal/openapi.json. Gere clientes tipados em qualquer linguagem automaticamente.
Pronto para explorar?
Terminal é um dos 14 serviços Kit que vêm com todo contêiner Hoody. Sem instalação, sem configuração — só URLs.