Agent 的动静,
发到你想要的地方。
哪个编程 Agent 在工作中、哪个需要你、哪个已完成,Gnista 本来就知道。Webhook 把这些传出去:Slack、Discord 或 Microsoft Teams 里的一条消息、Home Assistant 或家庭里的一盏红灯、你自己日志里的一行。下面一个个说怎么设置,以及不用 Gnista 要做什么。
更新于
简短回答
在 Gnista 的设置 ▸ 通知 ▸ Webhook 里点“添加”,选 Slack、Discord、Microsoft Teams 或“Home Assistant 或其他”并粘贴 URL,或者选“快捷指令”再挑一个你的快捷指令。之后,你选的变化会从 Gnista 连接的每个 Agent 发到那里:Qwen Code、Claude Code、Codex、Gemini CLI、OpenCode 等等,不管在 Mac 上还是通过 SSH。
用 Gnista
- 下载 Gnista,打开,勾选你用的 Agent。
- 打开设置 ▸ 通知,找到标着“实验性”的 Webhook。
- 点“添加”并选择:要聊天消息就选 Slack、Discord 或 Microsoft Teams;要 Gnista JSON(给 Home Assistant 或你自己脚本用的一小段 JSON)就选“Home Assistant 或其他”;要用这段 JSON 运行你的快捷指令就选“快捷指令”。
- 粘贴 URL,或者选快捷指令。Gnista JSON 还可以设一个“密钥”,作为 Bearer 令牌发送。
- 在这一行的 ⋯ 菜单里选它的“事件”:“全部”“仅需要你”或“需要你和已完成的回合”。聊天默认是“仅需要你”,免得刷屏;Gnista JSON 和快捷指令默认是“全部”。
- 在同一个菜单里选“测试”。会发出一条示例,或者快捷指令运行一次,这一行会显示结果。每个 Webhook 都有自己的开关,不删也能暂停。
Slack
Slack 通过传入 Webhook(Incoming Webhook)往频道里发消息。在 api.slack.com/apps (在新标签页中打开) 打开你的 Slack 应用设置(没有就新建一个),进入 Incoming Webhooks 并打开,点 Add New Webhook to Workspace,选一个频道。URL 以 https://hooks.slack.com/services/ 开头。每个变化一行,措辞和 Mac 上的通知一样,用的是应用的语言:哪个 Agent、发生了什么、哪个项目、它在问什么。
Discord
在 Discord 里打开频道的“编辑频道” ▸ “整合” ▸ “Webhooks”,点“新 Webhook”,再点“复制 Webhook URL”。消息内容和 Slack 一样,而且不会提醒任何人:@everyone、@here 和其他提及都关掉了。
Microsoft Teams
Teams 通过“工作流”应用接收 Webhook;旧的 Office 365 连接器正在停用。在频道里打开 ⋯ ▸ 工作流,选模板“Send webhook alerts to a channel”,选好团队和频道,点“保存”。复制显示出来的 Webhook URL,在 Gnista 里作为 Microsoft Teams 添加。每个变化会以卡片送达,内容和 Slack 收到的那一行一样。
Mattermost 和 Rocket.Chat 接受 Slack 的格式:把它们的传入 Webhook URL 作为 Slack 添加即可。
Home Assistant
建一个用 Webhook 触发器 (在新标签页中打开)的自动化:允许 POST,ID 要难猜。在 Gnista 里用“Home Assistant 或其他”添加 Webhook,粘贴 http://homeassistant.local:8123/api/webhook/ 加上这个 ID。ID 本身就是密钥,所以 Gnista 的“密钥”留空。
这个自动化在 Agent 需要你时把灯变红,它继续往下走就关灯:
alias: Agent needs me
triggers:
- trigger: webhook
webhook_id: gnista-pick-something-long
allowed_methods: [POST]
local_only: true
actions:
- choose:
- conditions: "{{ trigger.json.event == 'needsYou' }}"
sequence:
- action: light.turn_on
target: { entity_id: light.desk }
data: { color_name: red }
- conditions: "{{ trigger.json.event in ['working', 'done', 'idle', 'ended'] }}"
sequence:
- action: light.turn_off
target: { entity_id: light.desk }同时跑好几个 Agent 时,以最后一次变化为准。想要“任何一个会话需要我”,就用一个辅助元素(helper)计数。
Apple 家庭
在 Mac 上,Gnista 没法直接控制 HomeKit:Apple 只让为 iPhone 和 iPad 打造的 App 控制家庭。快捷指令可以,所以 Gnista 运行一个快捷指令,把 Gnista JSON 作为输入。它在你的 Mac 上运行,所以 Mac 得保持唤醒。
在“快捷指令” App 里做一个这样的快捷指令:
- “从输入中获取字典”,然后对
event用“获取字典值”。 - “如果”值是
needsYou:用“控制家庭”或一个场景,把一盏灯打开并设成红色。 - “否则”:用“控制家庭”把这盏灯关掉。
- 在 Gnista 里点“添加” ▸ “快捷指令”,选中它。把“事件”保持为“全部”,这样 Agent 继续工作时灯会再关掉。
Google Home
Google Home 没有传入 Webhook,也没有能让 Mac 开关灯的公开 Web API。它的开发者 API,即 Home APIs,是给 Android 和 iPhone App 用的,它的自动化也不能由 Web 请求触发。
可行的办法是 Home Assistant (在新标签页中打开)。Google Home 里的大多数灯,比如 Matter、Philips Hue 和 Nest 设备,也能加进 Home Assistant,而且 Matter 设备可以同时连到两边。这样,上面的自动化原样就能用。
不想要服务器:IFTTT Webhooks (在新标签页中打开) 的触发器 Receive a web request with a JSON payload 能接收 Gnista JSON,而 IFTTT 上 Philips Hue、LIFX、Govee 等灯的服务可以改变灯的颜色。把触发器的 URL(https://maker.ifttt.com/trigger/ 后接你的事件名和密钥)在 Gnista 里用“Home Assistant 或其他”添加,并把“事件”设为“仅需要你”,这样只有 Agent 需要你时,Applet 才会运行。Webhooks 触发器需要付费的 IFTTT Pro。
你自己的脚本
Gnista JSON 每个变化一个小对象,用 POST 发送。一个请求运行命令的 Codex 会话是这样的:
{
"agent": { "id": "codex", "name": "Codex" },
"at": "2026-10-28T14:03:12Z",
"event": "needsYou",
"folder": "/Users/me/Git/shop",
"machine": null,
"message": "Codex wants to run `npm run build`",
"previous": "working",
"project": "shop",
"session": "019a…",
"version": 1
}event 是 working、needsYou、done、idle 或 ended,previous 是之前的状态。键和这些值是固定的英文,给脚本用;哪天改得会让脚本出错,version 就会加一。message 是给人看的文字,用的是应用的语言,所以别拿它做匹配:改用 event、agent.id、project 或 machine 过滤。设了密钥,请求会带上 Authorization: Bearer 和你的密钥。
不用 Gnista
- 每个 Agent 自己的 hook 都能往 URL 发:Claude Code 的
Notification和Stophook、Qwen Code 和 Gemini CLI 的 hooks,或 Codex 的notify程序,各自运行curl。能用,但每个 Agent 都得你自己写、自己维护,而且每个发出的数据格式都不一样。 - 没有 hook 的话,你只能在 Agent 的终端里,或者从它自己在 Mac 上的通知里知道。
须知
- Webhook 是“实验性”功能。
- 它只发送。要回应请求,用刘海或 Agent 的终端。
- 快捷指令在你的 Mac 上运行,以 Gnista JSON 为输入,30 秒后会被停止。“测试”会运行它一次,
event为test。 - 专注模式、锁屏,以及设为安静的会话、文件夹或 Agent,都不会挡住它:自动化通常什么都想要。想少收一些,就在接收端过滤。
- 不加密的
http://只能发到本地网络,比如homeassistant.local或局域网里的 IP 地址;其他地方要用https://。第一次发送时,macOS 可能会问是否允许 Gnista 查找本地网络上的设备。 - URL 和密钥存在你的钥匙串里。每个 Webhook 单独发送,超时 10 秒,不重试,所以慢的那个不会拖住别的。
- 离开 Mac 时想在手机上收到:设置 ▸ 通知 ▸ “发送到我的手机”,支持 Bark、ntfy、Pushover 和 Telegram。在 Mac 本身上:Qwen Code 通知和 Kimi 与 CodeBuddy 通知。
- 免费试用 7 天,之后 €19 一次买断。更多见 Qwen Code、Claude Code、Codex 和 Gemini CLI。
更多指南。
Qwen Code 通知,
就在 Mac 刘海里。Qwen Code 跑完了还是在等你,在 Mac 上哪儿都能知道。Claude Code 也一样。
Kimi Code 和 CodeBuddy,
通知进刘海。Kimi Code 或 CodeBuddy 在等你批准,不用盯着终端也知道;CodeBuddy 还能直接在刘海里批准。Codex 也一样。
批准 Qwen Code 的请求,
不用切窗口。在刘海里允许或拒绝一条命令,然后接着干你手上的事。
编程 Agent 的用量与额度,
心里有数。Claude Code 和 Codex 的 5 小时与每周额度,以及每个会话花了多少,就在会话下面。
Xcode 里的 Agent,
就在刘海里。Xcode 里的 Claude、Codex 或 Antigravity 需要你时,不用把 Xcode 放在前面也知道。
服务器上的 Agent,
在 Mac 上回应。服务器或另一台 Mac 上的 Claude Code、Codex 等什么时候需要你,在 Mac 上就知道,还能直接回应。
容器里的 Agent,
触手可及。devcontainer 或 Kubernetes pod 里的 Claude Code、Codex:它们的请求照样进刘海。