SuperAPI AI 工具集

warpctrl

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

warpctrl 是捆绑在 Warp 应用中的本地控制模式,并非独立二进制;它由正在运行的 Warp 进程提供,命令名与包装器路径按当前 Warp 渠道注入。用途是通过命令行检查和操作本机已运行的 Warp 应用本身,例如创建标签页、拆分窗格、在输入区预填文本、打开界面面板或设置、聚焦窗口。

主要能力按意图分组:surface 处理打开或切换命名界面目标(自然语言名称转为 kebab 形式,如 Warp Drive 转为 warp-drive);window、tab、pane、session 分别管理对应对象;input 用于暂存或检查编辑器输入;file 用于在 Warp 中打开文件;theme、appearance、setting、keybinding 处理主题与配置;仅在无专用分组时使用通用 action 目录。

使用方式:先确认命令可用,通常执行 command -v warpctrl;若不可用,检查 {{warpctrl_wrapper_path}} 是否存在且可执行,或经由确认后创建指向该路径的 /usr/local/bin/warpctrl 符号链接(ln -sf "{{warpctrl_wrapper_path}}" "/usr/local/bin/warpctrl"),必要时通过 osascript 提权,不直接索取密码。随后用 instance list 发现同渠道实例,通过 warpctrl help 或 <group> help 发现确切语法,并用 app active、window/tab/pane/session list 查看目标。可加 --output-format json 输出结构化结果。目标选择器支持 --instance、--pid、--window、--tab、--pane、--session 等。

限制与安全:命令须串行执行,不可并行;输入暂存命令不会提交或运行内容;关闭操作仅在用户明确要求时调用;不得臆造命令;只作用于同一用户的本地运行实例,不支持远程或云实例,各渠道仅管理本渠道实例;Windows 上本地控制发布受限。启用还取决于 Settings > Scripting 开关,公开渠道默认关闭。若 instance list 为空,需确认同渠道应用在运行且脚本功能已启用。