remorses/tuistory

解决的问题

Tuistory 允许 AI 代理与长期运行的终端进程（如开发服务器、REPL 和交互式 CLI）进行交互，而无需阻塞其执行。它解决了代理在启动服务器时挂起，或必须依赖盲目的 sleep 命令来猜测进程是否就绪的问题。

工作原理

Tuistory 将终端命令包装在由中继守护进程管理的命名后台会话中。这种架构允许人类和 AI 代理连接到同一会话。人类可以以交互方式附加到终端（类似于 tmux），而代理则使用 CLI 或程序化 API 来读取日志、等待特定文本模式（正则表达式）、拍摄屏幕快照，并向进程发送按键输入。

适用人群

• AI 代理开发者：需要运行和监控开发服务器或使用交互式终端工具的编码代理开发者
• TUI 开发者：需要自动化或测试的终端用户界面开发者
• 自动化工程师：希望以程序化方式控制 TTY 进程的用户

主要亮点

• 响应式等待：用 wait 和 wait-idle 命令替代盲目的 sleep，能即时响应终端输出。
• 共享状态：人类和代理可以共享同一终端会话，允许人类在代理启动的进程上介入并进行交互。
• 程序化控制：提供 TypeScript 库，功能类似“终端版 Playwright”，可精确控制 PTY。
• 可视化检查：支持将当前终端屏幕捕获为文本快照或 PNG 图像。
• CWD 和环境继承：将调用 shell 的完整环境和 PATH 传递给子进程。
• 幂等执行：通过重新连接到现有会话而非失败，避免“端口已被占用”错误。