用途：shell-use 从命令行控制真实终端，在后台守护进程持有的无头 PTY 中运行 shell（bash、zsh、fish、powershell、pwsh、cmd、xonsh、elvish、nushell）和 TUI 程序，并渲染为完整终端模拟器。每次调用连接、执行、退出，共享同一活动会话。
主要能力：会话与生命周期（open、run、sessions、close、daemon 系列）；检查（state、text、screenshot、cells、get）；输入（type、submit、press、keys、mouse 点击/移动/拖拽/滚动）；PTY 控制（resize、write、signal、kill）；等待（wait text/idle/command/exit/ready）；断言（expect text/exit-code/output/snapshot，退出码 0 通过、1 失败）；录制（get-recording 输出 asciinema v2 cast）、实时 monitor 监视，以及 agent-context、usage、skill 自文档命令。
使用方式：默认会话名 default，可用 --session 或 SHELL_USE_SESSION 指定；--json 输出机器可读结果；--verbose 在守护进程启动时记录 PTY 日志。典型流程为 open、submit、wait command、expect text、expect exit-code、close。也提供 Python（pip install shell-use）与 Node/Deno/Bun（npm install @microsoft/shell-use）异步客户端，方法镜像 CLI，需 shell-use 二进制在 PATH 中。
适用场景：智能体驱动终端、TUI 自动化测试、快照与颜色断言、会话录制回放。
限制：wait command、expect exit-code、get cwd 等依赖 shell 集成，powershell 的命令/输出文本为尽力而为，cmd 仅提示符；monitor 需交互式终端与已存在会话；Windows ConPTY 下 get output/command 偶有不稳定，网格类检查不受影响。其余细节暂未提供。