Zum Inhalt springen
HTTP-Befehls-API
WebSocket-Streaming
Mehrspieler-Sitzungen
50+ URL-Parameter
5 Shell-Umgebungen
Automatisches Display-Mapping
19 API-Endpunkte
Persistente Sitzungen
HTTP-Befehls-API
WebSocket-Streaming
Mehrspieler-Sitzungen
50+ URL-Parameter
5 Shell-Umgebungen
Automatisches Display-Mapping
19 API-Endpunkte
Persistente Sitzungen
HTTP-Befehls-API
WebSocket-Streaming
Mehrspieler-Sitzungen
50+ URL-Parameter
5 Shell-Umgebungen
Automatisches Display-Mapping
19 API-Endpunkte
Persistente Sitzungen
HTTP-Befehls-API
WebSocket-Streaming
Mehrspieler-Sitzungen
50+ URL-Parameter
5 Shell-Umgebungen
Automatisches Display-Mapping
19 API-Endpunkte
Persistente Sitzungen
TerminalKit-Dienst

Terminal

Eine persistente Linux-Shell, die als HTTPS-Endpunkt bereitgestellt wird. Befehle per API ausführen, aus jedem Browser verbinden, Ausgabe live streamen.

Dokumentation ansehen
Quickstart

# Get your 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" }

 

# Run your first command

$ 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 }

 

# Share the URL — anyone can connect

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

URL-Struktur

Die URL ist das Interface

Jedes Terminal hat eine vorhersehbare Adresse. Lies sie von links nach rechts und du weißt genau, mit welchem Service, welcher Instanz und welchem Container du sprichst.

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

Projekt

Deine Projekt-ID.

def456

Container

Die Container-ID.

terminal

Service

Welcher Kit-Service – terminal, files, display…

1

Instanz

Betreibe viele: terminal-1, terminal-2, terminal-3.

node-us-1

Server

Der Node, auf dem dein Container läuft.

Die URL ist das Interface. Keine Ports, keine Config, kein Netzwerk-Setup.

HTTP API

Jeder Befehl ist ein API-Call

Die Ausführung ist async. Schick einen Befehl ab, bekomm eine ID zurück und lies das Ergebnis – oder streame es live über WebSocket.

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

POST einen Befehl. Du bekommst sofort eine command_id und status: running.

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

Frage den result-Endpoint ab – für die kombinierte Ausgabe und den Exit-Code.

3Oder live streamen
WS /api/v1/terminal/ws?terminal_id=1
> build started…
> compiling 42 modules
> 24 passed, 0 failed

Öffne einen WebSocket für Terminal-Frames in Echtzeit.

Fähigkeiten

Alles eingebaut

Jedes Feature ist ohne Konfiguration sofort verfügbar. Terminal wird sofort einsatzbereit geliefert.

Web-Terminal

Ein vollwertiges Terminal im Browser

Öffne die URL auf jedem Gerät – Handy, Tablet, Laptop. Konfiguriere die Web-UI komplett über Query-Parameter: Shell, Schriftgröße, Read-only-Modus, Titel und Seitenpanels.

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

Shell-Auswahl

bash, zsh, fish, tmux, sh — Shell per URL-Parameter wechseln. Vorinstalliert und einsatzbereit.

Automation API

Sende Tastenanschläge, füge Text ein und warte, bis sich der Screen beruhigt – steuere interaktive Programme über HTTP.

Terminal-Screenshots

Terminal-Zustand als PNG, JPEG oder GIF per API aufnehmen. Konfigurierbare Farben und Schriftgröße für Dokumentation.

Live-Session-State

Arbeitsverzeichnis, Shell und History bleiben erhalten, solange die Session lebt – und überstehen Reconnects.

SSH zu jedem Server

Öffne eine Session als Remote-SSH-Verbindung – Host, User und Key als Parameter.

HTTP-API

19 Endpunkte, volle Kontrolle

Vier Domänen: Befehlsausführung, Sitzungsverwaltung, Live-Streaming via WebSocket und System-Monitoring.

Befehlsausführung

5 endpoints

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

POST
/api/v1/terminal/executeBefehl ausführen (sync/async)
GET
/api/v1/terminal/result/{command_id}Async-Ergebnis abfragen
POST
/api/v1/terminal/execute/{command_id}/abortBefehlsverlauf
POST
/api/v1/terminal/writeAls PNG/JPEG/GIF aufzeichnen
GET
/api/v1/terminal/history/{terminal_id}Aktive Sitzungen auflisten

Sitzungsverwaltung

6 endpoints

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

GET
/api/v1/terminal/sessionsNeue Sitzung erstellen
POST
/api/v1/terminal/createSitzung beenden
DELETE
/api/v1/terminal/{terminal_id}Terminalgröße anpassen
GET
/api/v1/terminal/rawIn Sitzung schreiben
GET
/api/v1/terminal/screenshotSitzungsstatus
GET
/api/v1/terminal/openapi.jsonSignal an Sitzung senden

Live-Streaming

4 endpoints

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

WS
/api/v1/terminal/wsEchtzeit-Stream
POST
/api/v1/terminal/pressAusgabepuffer lesen
POST
/api/v1/terminal/pasteCPU, Speicher, Festplatte, Netzwerk
POST
/api/v1/terminal/waitLaufende Prozesse

System & Meta

7 endpoints

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

GET
/api/v1/terminal/healthSignal an PID senden
GET
/api/v1/system/resourcesUmgebungsvariablen
GET
/api/v1/system/processesSysteminformationen
GET
/api/v1/system/processes/{pid}Rohe Ausgabe exportieren
GET
/api/v1/system/portsOffene Ports
POST
/api/v1/system/process/signalEin Signal an eine PID senden
GET
/api/v1/system/displaysAktive X11-Displays
Anwendungsfälle

Für echte Workflows gebaut

Terminal deckt die gesamte Bandbreite von Entwickler- und Automatisierungsszenarien ab.

  • 01

    Remote-Entwicklung

    GET /terminal/ws

    Von jedem Gerät mit einem Browser in deinen Container per SSH einloggen. Voller Shell-Zugriff mit persistenten Sessions.

  • 02

    AI-Agent-Orchestrierung

    POST /terminal/execute

    Agents führen Shell-Befehle per HTTP-API aus. Bauen, testen, deployen — die Terminal-API gibt AI-Agents vollständige Shell-Kontrolle.

  • 03

    Team-Debugging

    GET /terminal/sessions

    Terminal-URL mit deinem Team für Multiplayer-Debugging teilen. Alle sehen die gleiche Ausgabe, tippen Befehle.

  • 04

    GUI-Anwendungen

    ?display=N

    Jede grafische Anwendung vom Terminal starten. Firefox, VS Code, GIMP — terminal-N mappt automatisch auf display-N.

  • 05

    CI/CD-Integration

    GET /terminal/result/{id}

    Build-Schritte ausführen, Tests starten, Artefakte deployen — alles per HTTP. Terminal in jede CI-Pipeline integrieren.

  • 06

    Live-Monitoring

    GET /system/resources

    Echtzeit-CPU-, Speicher-, Festplatten- und Netzwerk-Stats per API. Laufende Prozesse auflisten, Signale senden.

Bereit zum Erkunden?

Terminal ist einer von 18 Kit-Services, die mit jedem Hoody-Container mitgeliefert werden. Keine Installation, keine Konfiguration.

Docs lesen