SuperAPI AI 工具集

hitch

智能体与模型

查看项目

更新于 10-16 09:30

技能介绍

用途:hitch 是一个供 AI 智能体查看和控制用户已打开共享终端会话的命令行工具,适合与用户在同一终端协作,处理长时间运行的任务,例如开发服务器(dev server)、监视器(watcher)、隧道(tunnel)和构建(build)。它以 no concrete task 激活时不应行动,仅作为参考知识记住。

主要能力:

  1. hitch context [TERMINAL]:应最先使用,显示紧凑的终端状态和近期有用输出。无参数显示当前项目所有终端;指定终端显示更详细信息;--all 显示包括项目外的所有终端。支持 --tail <n>(近期可见输出行,默认 20,指定终端默认 80)和 --head <n>(活动进程头部行,默认 5,指定终端默认 10)。
  2. hitch send-keys -t <terminal> [OPTIONS] <keys...>:向终端发送输入,类似 tmux send-keys。支持 Enter、Tab、Escape/Esc、Space、Backspace/BSpace、C-c、C-u 等按键。选项包括 --wait(finish、quiet:<duration>、time:<duration>、output)、--timeout <duration>(默认 30s)、--tail <n>、--force。注意选项必须写在按键之前。
  3. hitch capture -t <terminal> [OPTIONS]:镜像 tmux capture-pane 行为,仅在需要更多选项时使用,否则优先用 context <terminal>。支持 -p、-S、-E、-e 及兼容性 no-op 标志 -C、-J、-N、-T、-a、-q。

关键规则与限制:终端 id 为数字;用 C-c 打断用户进程前须确认用户要求或确有必要;不要向有运行中进程的终端发送 shell 命令(除非确实要与该进程交互,默认拒绝,需 --force);对运行中进程的终端发送的输入被当作 stdin,而非新的 shell 命令;不要用 hitch 运行短暂的工具调用;不要向长时间运行进程的终端发送 shell 命令;如需请求服务器,应在原生 shell、其他空闲终端或用户浏览器中发起,沙箱失败时不要回退到同一占用终端。

其他:无需预检查 CLI 是否安装,该技能自带。如遇错误或 bug,可指向 GitHub 仓库 https://github.com/maxktz/hitch 寻求反馈或帮助。