Programmatically interact with and test terminal user interface applications using a real terminal emulator.
Sponsored
Tui-test-ghost is a Zig-native testing toolkit built on Ghostty's robust terminal emulation core, providing a realistic environment for programmatic interaction with terminal applications. It enables AI agents and automated scripts to spawn, drive, and assert against Text-based User Interface (TUI) applications, such as those built with Bubble Tea, entirely without a graphical display. This empowers developers to create comprehensive, repeatable test suites for command-line interfaces and interactive terminal programs, ensuring their reliability and expected behavior.
Key Features
01Real terminal emulation using Ghostty's VT parser for accurate screen state.
02PTY-based execution ensures authentic program behavior within a pseudo-terminal.
03Detailed cell-level inspection of character, style, and color attributes.
040 GitHub stars
05Flexible wait conditions to poll for specific text, screen stability, or cursor position.
06Record and replay functionality for capturing and re-running automated test sessions.
Use Cases
01Developing AI agents that programmatically interact with terminal programs without a display.
02Creating golden file snapshots for regression testing of TUI outputs and visual consistency.
03Automated testing of interactive command-line interface (CLI) and TUI applications.
