pty-wrap

PTY wrapper for capturing terminal sessions via MQTT.

Installation

npm install -g pty-wrap

Usage

# Capture any command
pty-wrap <command> [args...]

# Examples
pty-wrap claude
pty-wrap bash
pty-wrap vim file.txt

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MQTT_URL | mqtt://localhost:1883 | MQTT broker URL | | MQTT_USERNAME | (empty) | MQTT authentication username | | MQTT_PASSWORD | (empty) | MQTT authentication password | | SESSION_ID | Auto-generated UUID | Custom session identifier |

How It Works

1. Spawns the target command in a PTY (pseudo-terminal)
2. Captures all input/output streams
3. Publishes to MQTT topic sessions/{SESSION_ID}/stream
4. Transparently proxies terminal I/O

Requirements

• Node.js >= 18.0.0
• MQTT broker (e.g., EMQX, Mosquitto)

License

MIT