Agent 的动静,
发到你想要的地方。

哪个编程 Agent 在工作中、哪个需要你、哪个已完成,Gnista 本来就知道。Webhook 把这些传出去:Slack、Discord 或 Microsoft Teams 里的一条消息、Home Assistant 或家庭里的一盏红灯、你自己日志里的一行。下面一个个说怎么设置,以及不用 Gnista 要做什么。

免费试用 7 天无需账号和银行卡 · 之后一次性 €19

更新于

简短回答

在 Gnista 的设置 ▸ 通知 ▸ Webhook 里点“添加”,选 Slack、Discord、Microsoft Teams 或“Home Assistant 或其他”并粘贴 URL,或者选“快捷指令”再挑一个你的快捷指令。之后,你选的变化会从 Gnista 连接的每个 Agent 发到那里:Qwen Code、Claude Code、Codex、Gemini CLI、OpenCode 等等,不管在 Mac 上还是通过 SSH。

用 Gnista

  1. 下载 Gnista,打开,勾选你用的 Agent。
  2. 打开设置 ▸ 通知,找到标着“实验性”的 Webhook。
  3. 点“添加”并选择:要聊天消息就选 Slack、Discord 或 Microsoft Teams;要 Gnista JSON(给 Home Assistant 或你自己脚本用的一小段 JSON)就选“Home Assistant 或其他”;要用这段 JSON 运行你的快捷指令就选“快捷指令”。
  4. 粘贴 URL,或者选快捷指令。Gnista JSON 还可以设一个“密钥”,作为 Bearer 令牌发送。
  5. 在这一行的 ⋯ 菜单里选它的“事件”:“全部”“仅需要你”或“需要你和已完成的回合”。聊天默认是“仅需要你”,免得刷屏;Gnista JSON 和快捷指令默认是“全部”。
  6. 在同一个菜单里选“测试”。会发出一条示例,或者快捷指令运行一次,这一行会显示结果。每个 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 里做一个这样的快捷指令:

  1. “从输入中获取字典”,然后对 event 用“获取字典值”。
  2. “如果”值是 needsYou:用“控制家庭”或一个场景,把一盏灯打开并设成红色。
  3. “否则”:用“控制家庭”把这盏灯关掉。
  4. 在 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 和 Stop hook、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。

更多指南。