TUI-use

Let AI agents take control of interactive terminal programs

TUI-use is an open-source library that gives AI agents the ability to interact with traditional interactive terminal (TUI) applications — think vim, htop, ssh sessions, database CLIs, and legacy text-based UIs that were never designed for programmatic control. Instead of requiring a GUI or a REST API, TUI-use interprets terminal output as structured state and sends synthetic keystrokes back, enabling agents to "see" and "drive" any TUI application as if they were a human at a keyboard. The project was born from a real pain point: AI coding agents can call bash commands and write files, but they fail badly the moment a tool opens an interactive prompt waiting for user input. TUI-use solves this by building a state machine layer over PTY (pseudo-terminal) interfaces, letting agents read the current screen buffer, detect interactive prompts, and respond intelligently. It ships with adapters for common TUI patterns and a clean API that works with any LLM tool-use framework. The Show HN post attracted genuine interest from the ops and DevOps community — many existing workflows depend on tools that expose only an interactive terminal interface. TUI-use fills a real gap in the "AI agents that control computers" space by handling the long tail of CLI programs that have no API, no GUI, and no intention of ever getting one.

Panel Reviews

The Builder

Developer Perspective

Ship

“This is the missing piece for automating legacy ops workflows. Half my toolchain is interactive TUI apps that choke every agent pipeline — TUI-use just quietly solves that. The PTY state machine approach is clever and the API is clean.”

The Skeptic

Reality Check

Skip

“Screen-scraping terminal output to infer state is fragile — any change in terminal colors, locale, or version will break your parser. This works fine for demos but I'd want to see battle-hardened error recovery before running it against anything production-critical.”

The Futurist

Big Picture

Ship

“The real unlock here is making 40 years of terminal software suddenly agentic without a single line change from the original developers. TUI-use could quietly become the bridge that lets AI agents inherit the entire unix toolchain ecosystem.”

The Creator

Content & Design

Ship

“Not my usual domain but I can see this saving hours for anyone managing servers — having an agent that can actually ssh in and navigate interactive prompts without getting stuck is genuinely useful. The demo videos make it look surprisingly smooth.”