onesuper

onesuper / tui-use

Public

tui-use gives agents access to the parts of the terminal that bash can't reach — every REPL, installer, and TUI app built for humans.

48
4
100% credibility
Found Apr 08, 2026 at 48 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

tui-use enables AI agents to interact with interactive terminal programs by capturing screen snapshots and sending keystrokes.

How It Works

1
💡 Discover tui-use

You hear about a handy tool that lets smart assistants take over interactive programs in your terminal, like code editors or databases.

2
📥 Get it set up

With one simple command, you add it to your computer so it's ready to use anytime.

3
🚀 Launch a session

You start a program like a Python chat or a file editor, and it opens up just like you would do yourself.

4
👀 Peek at the screen

You grab a clear picture of what's on the screen, seeing exactly where the cursor is and what's highlighted.

5
⌨️ Type and navigate

You send keystrokes, like arrows or Enter, to move around menus and fill in answers, feeling in full control.

6
🤖 Team up with AI

Your AI assistant reads the screen, decides what to type next, and keeps the conversation going seamlessly.

🎉 Master any terminal app

Now your AI handles REPLs, installers, and full-screen tools effortlessly, saving you time and hassle.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 48 to 48 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is tui-use?

tui-use is a TypeScript CLI that gives agents access to the parts of the terminal that bash can't reach—every REPL, installer, and TUI user interface app built for humans. Spawn any interactive program in a pseudo-terminal, grab clean text snapshots of the screen, send keystrokes like arrows or Ctrl+C, and detect highlights for selected menu items. It's like BrowserUse but for terminals, perfect for scripting what humans do in vim, htop, or npm wizards.

Why is it gaining traction?

Its snapshot model delivers full-screen renders without async streams or timing hacks, plus highlights spotting active options via inverse video—no text parsing needed. Rich key support covers F-keys to Ctrl combos, and commands like `tui-use start python`, `snapshot`, `type "foo\n"`, or `wait --text "prompt"` make agent loops dead simple. Early adopters love the Claude Code plugin for seamless integration.

Who should use this?

AI agent builders automating REPLs like Python/Node/psql, scaffolding tools such as create-react-app, or TUI apps like lazygit/fzf. Devs in Cursor/Claude/Gemini CLI scripting database CLIs, SSH sessions, or installers without APIs. Skip if you're on Windows—Unix PTY only.

Verdict

Grab it for agent prototypes (npm i -g tui-use); 48 stars and 1.0% credibility scream early days, but solid docs, CLI, and tests show promise. Maturity lags, so test your TUIs first.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.