true-input

True-Input Driver

The orchestrator routed you here. Use these mechanics to execute your plan.

Drive a real terminal emulator, injecting keystrokes through the platform's native HID input path. This proves exactly what bytes the terminal emits -- no synthetic injection, no PTY distortion.

When to use

• Proving that a terminal really sends the sequence you expect (e.g., Ghostty's Shift+Enter)
• Recording demos that reflect actual terminal rendering
• Validating that Droid handles a keystroke correctly end-to-end in a specific terminal

If you don't need real terminal proof, use tuistory -- it's faster and more deterministic.

Platform support

Read the platform file for your target OS. Each contains prerequisites, core pattern, command reference, encoding reference, recording, troubleshooting, and recovery -- specific to that platform.

Key differences from tuistory

Known dead ends

• Xvfb + xdotool: bypasses real keyboard processing entirely
• uinput + Xvfb: Xvfb does not consume kernel input devices
• SSH for TUI testing: PTY layer distorts input encoding; use SSH only for deployment
• Raw asciinema rec: true-input records via wf-recorder (Wayland screen capture), not asciinema. Use tctl --record or tctl record start/stop. Calling asciinema rec directly has no access to the compositor and produces nothing useful.