iTerm2 控制
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @yunheng/yunheng-iterm2-control。
技能介绍
要解决什么问题
助手的 Bash/shell 工具跑在沙箱或不可见环境里,用户说「在 iTerm2 里跑一下」「让我看到终端输出」时,输出不会出现在自己正在用的 iTerm2 里。长驻的 dev server、构建监听、需要肉眼盯着或现场演示的命令,也不适合塞进助手会话里刷日志。
本技能通过 macOS 自带的 osascript 调用 iTerm2 的 AppleScript 字典,在用户可见的窗口、标签或分屏里执行命令,必要时把当前会话的 scrollback 落到临时文件供助手读取——与「助手自己的 shell」是两套通道。
核心能力怎么工作
捆绑脚本 iterm2_ctl.sh 提供子命令:launch 保证 iTerm2 已启动;send 在当前会话写命令;tab / window / split-v / split-h 在新布局里执行;run 在发送后固定等待若干秒再 capture;capture 把当前会话全文写入 /tmp/iterm2_capture.*.txt 并打印路径(不走 stdout,避免大段日志占满上下文)。
向脚本传 COMMAND 时应用单引号包裹,避免 $、反引号、! 在传到 AppleScript 前被外层 shell 展开。发送类操作需一次性授予 macOS 自动化(Automation) 权限,否则会出现 -10004 权限违例;只读 capture 在无该权限时仍可能可用。
边界与注意点
run按固定秒数等待,不会等到 shell 提示符;慢任务应加大秒数或send后由用户确认再capture。- 未经用户明确同意,不要用本技能在真实可见终端上执行破坏性命令。
- 没有已打开窗口时,
send/capture/split-*会自动建窗,属于预期行为。 - 命令字符串经
escape_as处理双引号;若仍异常,尽量用单引号写内部字符串,减少内嵌"。
使用场景
- 用户要求在某条构建或测试命令必须在 iTerm2 里执行,以便当场看到报错栈和彩色输出
- 需要为 webpack/vite 监听或 Rails 服务单独开一个标签,进程一直留在可见终端而不混进助手日志
- 演示或结对时要把 npm run dev 投屏到观众能看到的 iTerm2 窗口或分屏
- 助手已 send 命令后,用户确认跑完,再 capture 当前会话 scrollback 回填到对话里分析
适合人员
- 本地用 iTerm2 跑前后端与脚本、又希望助手把命令发到自己屏幕上的 macOS 工程师
- 需要把长时间构建/监听进程固定在独立标签里、避免和对话上下文搅在一起的独立开发者
- 做录屏或现场 demo、要求命令必须在可见 iTerm2 执行的讲师或布道师
- 通过 Cursor/IDE 集成助手驱动物理终端、并愿意在系统设置里一次性开 Automation 的用户