Command Execution
Execute shell commands inside the container and retrieve the captured stdout, stderr, and exit code. Supports a synchronous execute path for one-shot commands and a streaming path for long-running output.
Hoody Terminal
Section titled “Hoody Terminal”The Hoody Terminal service provides programmatic access to the execution environment running inside each Hoody container. It exposes a single, container-scoped API surface that covers six operational concerns: running shell commands, managing interactive sessions, exposing a browser-accessible terminal, observing system resources and network ports, driving TUI applications, and staging files for drag-and-drop injection.
Every endpoint in this section is scoped to a specific container, identified by the host template {containerId}-containers.hoody.com. Requests are authenticated with a Hoody bearer token and are only valid against containers belonging to the authenticated project.
Sub-pages
Section titled “Sub-pages”Session Management
List, inspect, create, and terminate interactive terminal sessions. Each session can be connected over WebSocket to drive a long-lived shell or TUI process from a client.
Web UI & API Access
Open the in-browser terminal UI for a container, or retrieve the rendered OpenAPI specification for the Terminal API surface.
System Monitoring
Read CPU, memory, disk, and load metrics; inspect the running process list; and enumerate listening network ports to verify that services inside the container are reachable.
Terminal Automation
Drive TUI applications headlessly: capture a snapshot of the current screen, search for text, press keys, paste strings, and block until a condition on the screen is met.
File Drag-and-Drop
Stage one or more files into a session and deliver them to a TUI as a single drag-and-drop frame. Useful for transferring small assets into terminal applications that accept dropped content.