Author here, I built this because my agents could not use TUI or interactive CLI software. Think puppeteer for TUIs.
If you've ever asked Claude Code, codex, opencode, etc... to make logical commits from a bunch of changes you might have seen them struggle with moving files around, deleting files when a simple `git add -p` would have let them work through the changes interactivly. ht (the binary name) allows them to spawn their own terminal and drive it similar to puppeteer, sending keys, viewing a snapshot of the terminal and making a decision.
Some other use cases are also solved from CI/CD to making nice demos (it can export images or the format used by asciicast for making videos of the session.
It's powered by libghostty so it has support for all the stuff a modern terminal can do (full color, mouse clicks, etc...) and I've had a lot of fun letting claude run wild and even play games like nethack.
Happy to answer questions, and of course let me know if you run into any issues!
