Zum Inhalt springen
Home / Kit / Terminal
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.

Quickstart

# Get your token

$ curl https://your-terminal.hoody.com/token

> eyJhbG...

 

# Run your first command

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

 

# Share the URL — anyone can connect

https://proj-dev-terminal-1.server.containers.hoody.com

Home / Kit / Terminal / Features
So funktioniert es

Fünf Wege, Terminal zu nutzen

Terminal passt sich deiner Arbeitsweise an. Befehle per HTTP ausführen, Builds per WebSocket streamen, mit Kollegen kollaborieren.

terminal-1

Befehle über HTTP

Shell-Befehl an jede Terminal-Session POSTen. Strukturiertes JSON mit stdout, stderr, Exit-Code und Timing erhalten.

# vorher / nachher

- 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

> ]

Execute1/5
Home / Kit / Terminal / API
HTTP-API

Jeder Befehl ist ein API-Aufruf

POST einen Befehl, erhalte strukturiertes JSON mit stdout, stderr, Exit-Code und Timing-Metadaten zurück. Sync oder async.

Alle Endpoints anzeigen
terminal-api.sh

# 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

# }

Home / Kit / Terminal / more
Anwendungsfälle

Für echte Workflows gebaut

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

Remote-Entwicklung

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

AI-Agent-Orchestrierung

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

Team-Debugging

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

GUI-Anwendungen

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

CI/CD-Integration

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

Live-Monitoring

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

Home / Kit / Terminal / Endpoints
HTTP-API

19 Endpunkte, volle Kontrolle

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

Sitzungsverwaltung

7 endpoints

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

GET
/api/v1/terminal/sessionsAktive Sitzungen auflisten
POST
/api/v1/terminal/sessionsNeue Sitzung erstellen
DELETE
/api/v1/terminal/sessions/:idSitzung beenden
POST
/api/v1/terminal/sessions/:id/resizeTerminalgröße anpassen
POST
/api/v1/terminal/sessions/:id/writeIn Sitzung schreiben
GET
/api/v1/terminal/sessions/:id/statusSitzungsstatus
POST
/api/v1/terminal/sessions/:id/signalSignal an Sitzung senden

System & Meta

6 endpoints

curl .../system/resources → {cpu: 45%, mem: 8GB}

GET
/api/v1/system/resourcesCPU, Speicher, Festplatte, Netzwerk
GET
/api/v1/system/processesLaufende Prozesse
POST
/api/v1/system/process/signalSignal an PID senden
GET
/api/v1/system/envUmgebungsvariablen
GET
/api/v1/system/infoSysteminformationen
GET
/api/v1/terminal/rawRohe Ausgabe exportieren

Befehlsausführung

4 endpoints

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

POST
/api/v1/terminal/executeBefehl ausführen (sync/async)
GET
/api/v1/terminal/result/:idAsync-Ergebnis abfragen
GET
/api/v1/terminal/history/:idBefehlsverlauf
GET
/api/v1/terminal/screenshotAls PNG/JPEG/GIF aufzeichnen

Live-Streaming

2 endpoints

WS .../sessions/1/ws → real-time stdout frames

WS
/api/v1/terminal/sessions/:id/wsEchtzeit-Stream
GET
/api/v1/terminal/sessions/:id/bufferAusgabepuffer lesen
Home / Kit / Terminal / more
Fähigkeiten

Alles eingebaut

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

Persistente Sitzungen

Arbeitsverzeichnis, Umgebungsvariablen, Shell-Verlauf — alles ueberlebt Browser-Schliessungen und erneutes Verbinden.

Shell-Auswahl

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

tmux-Bridge

tmux-Sessions zwischen Web und SSH-Zugriff geteilt. terminal-3 im Browser mappt auf tmux-Session 3 über SSH.

Terminal-Screenshots

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

Session-Reset

Alle Prozesse beenden, Umgebung löschen, Arbeitsverzeichnis mit einem einzigen URL-Parameter zurücksetzen. Sauberes Blatt.

OpenAPI-Spec

Selbst-dokumentierendes API unter /api/v1/terminal/openapi.json. Typisierte Clients in jeder Sprache automatisch generieren.

Home / Kit / Terminal / Start

Bereit zum Erkunden?

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

Docs lesen