自动化
编程智能体
在 Hyla 中运行的智能体可以像你一样使用 hyla 命令:在下方窗格里启动开发服务器、把评审交给另一个智能体、等待测试跑完,并在受阻时告诉你。
安装技能
hyla skill setup
这会安装两样东西:
- 一个技能,教智能体使用命令行。Claude Code 从
~/.claude/skills/hyla读取;Codex、OpenCode 等智能体从~/.agents/skills/hyla读取。 - 一个钩子,在智能体开始会话时运行。它告诉智能体自己位于哪个 Hyla 会话和窗格,省得它花时间去查;如果会话还没有名字,就让智能体按任务给它命名,例如
fix-login-redirect,不用你动手。它还会把智能体自己的会话告诉 Hyla,这样 hylad 重启后(比如电脑重启之后),智能体就能接上之前的对话。
对于你已安装的智能体,钩子会放在各自查找钩子的位置:
| 智能体 | 钩子位置 |
|---|---|
| Claude Code | ~/.claude/settings.json 中的 SessionStart 钩子 |
| Codex | ~/.codex/hooks.json 中的 SessionStart 钩子 |
| Pi | 扩展 ~/.pi/agent/extensions/hyla.ts |
| OpenCode | 插件 ~/.config/opencode/plugins/hyla |
如果 CLAUDE_CONFIG_DIR、CODEX_HOME、PI_CODING_AGENT_DIR 或 XDG_CONFIG_HOME 改变了智能体文件的位置,Hyla 会跟着走,并且不会改动各设置文件里的其他内容。
对 飞书 会话,Claude Code 还会得到一个 Stop 钩子。每轮结束时,钩子把智能体的最后一条消息写到机器人交给该窗格的文件里。机器人回复这条消息,而不是终端画面里的内容。重新运行 hyla skill setup 即可启用。其他智能体仍使用终端文本。
传入 --agent 并指定 claude、codex、pi 或 opencode,可以只为一个智能体安装。只需安装一次:技能是指向 Hyla 自己那份副本的链接,会随 Hyla 更新而更新;Pi 和 OpenCode 的插件,Hyla 也会保持为最新。hyla skill status 会告诉你各部分是否为最新。
hyla skill status # 已安装什么,是否为最新
hyla skill show # 打印技能内容
hyla skill remove # 卸载技能和钩子
钩子只对安装之后启动的智能体会话生效,而且智能体可能会先征求你的同意:
- Claude Code 只在你信任的文件夹中运行钩子。
- Codex 会请你批准新钩子:用
/hooks批准 Hyla 的钩子。 - OpenCode 在其后台服务启动时加载插件:趁没有会话在忙时,运行一次
opencode service restart。
OpenCode 在后台服务而非窗格中运行智能体的命令,所以这些命令拿不到 HYLA_SESSION 和 HYLA_PANE。Hyla 会改为把窗格告诉智能体,由它显式指定为目标。出于同样的原因,OpenCode 智能体执行的 hyla report 无法到达它的窗格。
在 Hyla 之外,钩子什么也不做。
智能体能做什么
在身边运行任务:
hyla split --down -- npm run dev
hyla new -n review -- claude
操控它并读取结果:
hyla prompt review "review the changes in src/auth"
hyla wait tests --for idle,error --timeout 10m
hyla read tests -n 60
在旁边跑测试,并读取失败信息:
pane=$(hyla split --down -- go test ./...)
hyla wait "$pane" --exit || hyla read "$pane" -n 80
告诉你进展如何:
hyla report working "Migrating the database" --progress 40
hyla report blocked "Approve the production deploy?"
hyla report done "Deployed to staging"
blocked 报告会把会话变为等待中并通知你,所以智能体只应在离开你就无法继续时使用它。
远程控制
开启远程控制后(默认开启,位于设置 › 智能体),智能体还能操控应用本身:用 hyla focus 显示某个会话,或用 hyla do 执行菜单操作。设置 remote-control = false 可将其关闭,让智能体只能操作自己的会话。
环境变量
每个窗格都会获得:
| 变量 | 值 |
|---|---|
HYLA_SESSION |
窗格所在会话的 id |
HYLA_PANE |
窗格的 id |
检查 $HYLA_PANE 即可判断脚本是否运行在 Hyla 中。