onesuper/tui-use

这是什么？

核心功能

• 01在 PTY 中运行任意程序，并通过无头 xterm 模拟器渲染输出。
• 02以纯文本形式提供屏幕快照，也可输出 JSON。
• 03等待屏幕稳定或等待指定文本出现后再继续。
• 04报告反色高亮区域，便于智能体识别当前选中项。
• 05通过后台守护进程在多次 CLI 调用之间保持会话。
• 06支持输入文本、粘贴、按键、滚动以及屏幕正则搜索。

适用场景

• 在不丢失内存状态的前提下，调试长时间运行的 Python 会话。
• 让智能体设置 GDB 或 pdb 断点并检查变量。
• 让 AI 编程智能体操作 vim、lazygit 等全屏工具。
• 进行交互式 REPL 会话，每一步依赖上一步的输出。

快速上手

1. 1

   从 npm 全局安装 CLI

   npm install -g tui-use
2. 2

   在 PTY 会话中启动一个程序

   tui-use start python3 examples/ask.py
3. 3

   等待屏幕稳定,然后输入内容并按回车

   tui-use wait
4. 4

   获取当前屏幕快照

   tui-use snapshot

使用前须知

• !屏幕输出会丢失颜色和大部分文本样式,只保留高亮、标题和全屏状态。
• !使用 Claude Code 或 Codex 插件前需要先单独安装 CLI。

标签

常见问题

tui-use 是什么？

一个命令行工具，让 AI 智能体能够操作 REPL、调试器和 TUI 等需要键盘交互的终端程序。 tui-use 是一个命令行工具，让 AI 智能体能够与需要人工键盘操作的程序交互。它在伪终端（PTY）中启动目标程序，通过无头 xterm 模拟器渲染输出，并把当前屏幕以纯文本形式提供出来。智能体可以发送按键、读取屏幕结果，再决定下一步操作。

tui-use 可以免费使用吗？用的什么许可证？

tui-use 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

tui-use 还在维护吗？

超过半年未提交。tui-use 最近一次提交是在 2026年4月11日。

tui-use 适合用来做什么？

在不丢失内存状态的前提下，调试长时间运行的 Python 会话。 让智能体设置 GDB 或 pdb 断点并检查变量。 让 AI 编程智能体操作 vim、lazygit 等全屏工具。 进行交互式 REPL 会话，每一步依赖上一步的输出。

tui-use 怎么安装和运行？

从 npm 全局安装 CLI: npm install -g tui-use 在 PTY 会话中启动一个程序: tui-use start python3 examples/ask.py 等待屏幕稳定,然后输入内容并按回车: tui-use wait 获取当前屏幕快照: tui-use snapshot

在哪里获取 tui-use？

源代码和安装说明在 GitHub 上：https://github.com/onesuper/tui-use