65 lines
2.3 KiB
Markdown
65 lines
2.3 KiB
Markdown
# iterm-workspace-ctl
|
||
|
||
完全掌控 iTerm2：查询窗口/tab/session 结构与内容，并做分屏、焦点、输入、改名、几何操作
|
||
|
||
以 Pi package（技能形态）发布。技能本体在 `skills/iterm-workspace-ctl/`。
|
||
|
||
- 平台：macOS
|
||
- 许可：GPL-3.0-or-later（全文见 [LICENSE](LICENSE)）
|
||
|
||
## 安装
|
||
|
||
```sh
|
||
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`。
|