pty-serv

Spawns a command in a node-pty pseudo-terminal and exposes an HTTP endpoint to interact with it at runtime.

Usage

Run a shell, then send a command from another process:

# Terminal 1 – start the PTY server
npx pty-serv -s /tmp/pty-serv-0.sock -- bash

# Terminal 2 – interact with it
curl --unix-socket /tmp/pty-serv-0.sock 'http://[::]/write' --data $'echo hello\r'

CLI Options

| Flag | Description | |------|-------------| | -s, --socket <path> | Unix socket path to listen on | | -p, --port <number> | TCP port to listen on | | -h, --hostname <string> | Hostname for TCP listener (default: all interfaces) | | -o, --options <json> | JSON options forwarded to node-pty |

HTTP Endpoint

POST /write

Write raw data to the PTY's stdin. The request body is streamed directly to the PTY.

curl 'http://[::]/write' -d $'ls\r'

POST /resize

Resize the PTY window.

curl 'http://[::]/resize' -d '{"cols":220,"rows":50}'

POST /kill

Send a signal to the PTY process.

curl 'http://[::]/kill' -d '{"signal":"SIGTERM"}'

POST /clear

Clear the PTY screen buffer.

curl 'http://[::]/clear' -X POST

POST /pause / POST /resume

Pause or resume data flow from the PTY.

curl 'http://[::]/pause' -X POST
curl 'http://[::]/resume' -X POST