docs

Architecture

RalphTerm is a control plane around real terminal sessions.

Components

API server

Rust + axum exposes REST and WebSocket endpoints.

PTY runtime

portable-pty launches each agent inside a real terminal.

Session store

Tracks lifecycle, transcript, output events, and final status.

Signal detector

Converts terminal text into workflow-level state.

Runtime flow

client -> POST /v1/sessions
       -> RalphTerm spawns PTY
       -> official CLI runs inside PTY
       -> prompt is sent as terminal input
       -> output is streamed and stored
       -> signals update run status
       -> transcript and final artifacts are available

Design constraints