Pular para o conteúdo
API de Comandos HTTP
Streaming por WebSocket
Sessões Multiplayer
50+ Parâmetros URL
5 Ambientes Shell
Mapeamento Automático de Display
19 Endpoints de API
Sessões Persistentes
API de Comandos HTTP
Streaming por WebSocket
Sessões Multiplayer
50+ Parâmetros URL
5 Ambientes Shell
Mapeamento Automático de Display
19 Endpoints de API
Sessões Persistentes
API de Comandos HTTP
Streaming por WebSocket
Sessões Multiplayer
50+ Parâmetros URL
5 Ambientes Shell
Mapeamento Automático de Display
19 Endpoints de API
Sessões Persistentes
API de Comandos HTTP
Streaming por WebSocket
Sessões Multiplayer
50+ Parâmetros URL
5 Ambientes Shell
Mapeamento Automático de Display
19 Endpoints de API
Sessões Persistentes
TerminalServiço Kit

Terminal

Um shell Linux persistente exposto como endpoint HTTPS. Execute comandos via API, conecte-se de qualquer navegador, colabore em tempo real.

Ver Documentação
Início Rápido

# Obtenha seu token

$ curl -X POST \

https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/execute \

-H "Authorization: Bearer $TOKEN" \

-d '{"command":"echo Hello from Hoody!"}'

> { "command_id": "42", "status": "running" }

 

# Execute seu primeiro comando

$ curl \

https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/result/42 \

-H "Authorization: Bearer $TOKEN"

> { "status": "completed", "output": "Hello from Hoody!", "exit_code": 0 }

 

# Compartilhe a URL — qualquer um pode conectar

https://abc123-def456-terminal-1.node-us-1.containers.hoody.com

Estrutura da URL

A URL é a interface

Todo terminal tem um endereço previsível. Leia da esquerda para a direita e você sabe exatamente com qual serviço, instância e contêiner está falando.

URL do serviço de terminal
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com
abc123

Projeto

O ID do seu projeto.

def456

Contêiner

O ID do contêiner.

terminal

Serviço

Qual serviço do Kit — terminal, files, display…

1

Instância

Rode vários: terminal-1, terminal-2, terminal-3.

node-us-1

Servidor

O nó onde seu contêiner roda.

A URL é a interface. Sem portas, sem config, sem configuração de rede.

HTTP API

Todo comando é uma chamada de API

A execução é assíncrona. Dispare um comando, receba um ID de volta e leia o resultado — ou faça stream ao vivo via WebSocket.

1Execute
POST /api/v1/terminal/execute
-d '{"command": "npm test"}'
{
"command_id": "42",
"status": "running"
}

Faça POST de um comando. Você recebe um command_id e status: running na hora.

2Leia o resultado
GET /api/v1/terminal/result/42
{
"command_id": "42",
"status": "completed",
"output": "24 passed, 0 failed",
"exit_code": 0
}

Faça polling no endpoint de resultado para obter a saída combinada e o exit code.

3Ou faça stream ao vivo
WS /api/v1/terminal/ws?terminal_id=1
> build started…
> compiling 42 modules
> 24 passed, 0 failed

Abra um WebSocket para receber os frames do terminal em tempo real.

Capacidades

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.

Terminal Web

Um terminal completo no navegador

Abra a URL em qualquer dispositivo — celular, tablet, laptop. Configure toda a UI web por query parameters: shell, tamanho da fonte, modo somente leitura, título e painéis laterais.

?shell=zsh?fontSize=16?readonly=true?title=Prod?panel=/docs

Seleção de Shell

bash, zsh, fish, tmux, sh — troque shells via parâmetro URL. Pré-instalado e pronto para usar.

API de Automação

Envie teclas, cole texto e aguarde a tela estabilizar — controle programas interativos via HTTP.

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.

Estado de Sessão Ao Vivo

Diretório de trabalho, shell e histórico são mantidos enquanto a sessão está ativa e sobrevivem a reconexões.

SSH para Qualquer Servidor

Abra uma sessão como conexão SSH remota — host, usuário e chave como parâmetros.

HTTP API

19 endpoints, controle total

Quatro domínios: execução de comandos, gerenciamento de sessões, streaming ao vivo via WebSocket e monitoramento de sistema.

Execução de Comandos

5 endpoints

curl -X POST .../terminal/execute -d '{"command":"npm test"}'

POST
/api/v1/terminal/executeExecute comando (sync/async)
GET
/api/v1/terminal/result/{command_id}Consultar resultado async
POST
/api/v1/terminal/execute/{command_id}/abortHistórico de comandos
POST
/api/v1/terminal/writeCapturar como PNG/JPEG/GIF
GET
/api/v1/terminal/history/{terminal_id}Listar sessões ativas

Gerenciamento de Sessões

6 endpoints

curl .../terminal/sessions → [{ "terminal_id": "1", "shell": "bash" }]

GET
/api/v1/terminal/sessionsCriar nova sessão
POST
/api/v1/terminal/createEncerrar sessão
DELETE
/api/v1/terminal/{terminal_id}Redimensionar terminal
GET
/api/v1/terminal/rawEscrever na sessão
GET
/api/v1/terminal/screenshotStatus da sessão
GET
/api/v1/terminal/openapi.jsonEnviar sinal à sessão

Streaming ao Vivo

4 endpoints

WS .../terminal/ws — real-time terminal frames

WS
/api/v1/terminal/wsStream em tempo real
POST
/api/v1/terminal/pressLer buffer de saída
POST
/api/v1/terminal/pasteCPU, memória, disco, rede
POST
/api/v1/terminal/waitProcessos em execução

Sistema e Meta

7 endpoints

curl .../system/resources → { "cpu": 45.2, "memory": { ... } }

GET
/api/v1/terminal/healthEnviar sinal para PID
GET
/api/v1/system/resourcesVariáveis de ambiente
GET
/api/v1/system/processesInformações do sistema
GET
/api/v1/system/processes/{pid}Exportar saída raw
GET
/api/v1/system/portsPortas em escuta
POST
/api/v1/system/process/signalEnvie um sinal para um PID
GET
/api/v1/system/displaysDisplays X11 ativos
Casos de Uso

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.

  • 01

    Desenvolvimento Remoto

    GET /terminal/ws

    Acesse SSH no seu contêiner de qualquer dispositivo com navegador. Acesso completo ao shell com sessões persistentes e múltiplas janelas.

  • 02

    Orquestração de Agente de IA

    POST /terminal/execute

    Agentes executam comandos shell via HTTP API. Construir, testar, fazer deploy — a API do Terminal dá à IA acesso completo ao shell.

  • 03

    Debug em Equipe

    GET /terminal/sessions

    Compartilhe uma URL de terminal com sua equipe para debug multiplayer. Todos veem a mesma saída, digitam comandos e colaboram em tempo real.

  • 04

    Aplicações GUI

    ?display=N

    Inicie qualquer app gráfico pelo terminal. Firefox, VS Code, GIMP — terminal-N mapeia automaticamente para display-N.

  • 05

    Integração CI/CD

    GET /terminal/result/{id}

    Execute etapas de build, rode testes, faça deploy de artefatos — tudo via HTTP. Integre o Terminal em qualquer pipeline CI/CD.

  • 06

    Monitoramento ao Vivo

    GET /system/resources

    Estatísticas em tempo real de CPU, memória, disco e rede via API. Liste processos, envie sinais, inspecione o estado do sistema.

Pronto para explorar?

Terminal é um dos 18 serviços Kit que vêm com todo contêiner Hoody. Sem instalação, sem configuração — só URLs.

Ler a Documentação