iterm-workspace-ctl

完全掌控 iTerm2：查询窗口/tab/session 结构与内容，并做分屏、焦点、输入、改名、几何操作

以 Pi package（技能形态）发布。技能本体在 skills/iterm-workspace-ctl/。

• 平台：macOS
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/iterm-workspace-ctl.git@v0.1.3

装完 pi-skill list 能看到 iterm-workspace-ctl，pi-skill iterm-workspace-ctl check 会告诉还缺什么。

先准备什么

• 用系统已有的东西即可，没有额外依赖。

常用命令

命令	说明
info	总览：窗口/tab/session 结构
tree	树状结构
ids	列出 id
where	当前焦点位置
cur	当前 session
focus	切焦点
split	分屏
cols	多栏布局
resize	调尺寸
fullscreen	全屏/取消
send	向 session 发送文本
key	发送按键
capture	读屏幕内容
profiles	列出 profile
scrollback	读/改 iTerm2 各 profile 的回滚缓冲（unlimited 或行数）
tab-list	列出 tab
tab-new	新建 tab
tab-select	切 tab
tab-close	关 tab
win-list	列出窗口
win-new	新建窗口
title	改标题
sleep	等待
id	取窗格 session id（跨调用前先锚定）
split-id	按 session id 分屏
focus-id	按 session id 聚焦
send-id	按 session id 发送文本并回车
send-raw-id	按 session id 发送文本（不回车）
key-id	按 session id 发送按键
capture-id	按 session id 读屏幕内容
wait	轮询窗格直到出现指定字样
wait-id	按 session id 轮询直到出现指定字样
close-id	按 session id 关闭窗格
wait-idle	等目标空闲（命令回提示符 / TUI 屏幕静止），可选随后发送单行文本（前台阻塞）
idle-state	一次性读目标忙闲：job/prompt/屏幕指纹
send-when-idle	后台守候：目标空闲后把它发进去并回车；start/status/logs/stop（台账与 liveness 在 status 的 as_of）
batch	从 stdin 一次连接顺序执行多条命令

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。