Agent Skills
返回列表
💻

iTerm2 控制

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 的用户