Was deine Agents tun,
dort, wo du es willst.

Gnista weiß schon, wann jeder deiner Coding-Agents arbeitet, dich braucht oder fertig ist. Webhooks geben das weiter: eine Nachricht in Slack, Discord oder Microsoft Teams, eine rote Lampe in Home Assistant oder Home, eine Zeile in deinem eigenen Protokoll. So richtest du jedes davon ein, und so geht es ohne Gnista.

7 Tage gratis testenKein Konto, keine Karte · danach einmalig 19 €

Aktualisiert am

Die kurze Antwort

Klick in Gnista unter Einstellungen ▸ Mitteilungen ▸ Webhooks auf „Hinzufügen“, wähl Slack, Discord, Microsoft Teams oder „Home Assistant oder anderes“ und füg die URL ein, oder wähl „Kurzbefehl“ und einen deiner Kurzbefehle. Ab dann gehen die Änderungen, die du wählst, von jedem Agent dorthin, den Gnista verbindet: Claude Code, Codex, Gemini CLI, OpenCode und die anderen, auf deinem Mac oder per SSH.

Mit Gnista

  1. Lade Gnista, öffne es und hak deine Agents an.
  2. Öffne Einstellungen ▸ Mitteilungen und such „Webhooks“, markiert mit „Experimentell“.
  3. Klick auf „Hinzufügen“ und wähl: Slack, Discord oder Microsoft Teams für eine Chatnachricht, „Home Assistant oder anderes“ für Gnista JSON, ein kleines JSON für Home Assistant oder dein eigenes Skript, oder „Kurzbefehl“, um einen deiner Kurzbefehle mit diesem JSON auszuführen.
  4. Füg die URL ein oder wähl den Kurzbefehl. Für Gnista JSON kannst du auch ein „Geheimnis“ setzen; es geht als Bearer-Token mit.
  5. Wähl im ⋯-Menü der Zeile ihre „Ereignisse“: „Alles“, „Nur braucht dich“ oder „Braucht dich und beendete Durchgänge“. Chats starten mit „Nur braucht dich“, damit kein Kanal überläuft; Gnista JSON und Kurzbefehle starten mit „Alles“.
  6. Wähl im selben Menü „Testen“. Ein Beispiel geht raus oder der Kurzbefehl läuft einmal, und die Zeile sagt, wie es lief. Jeder Webhook hat seinen eigenen Schalter, um ihn zu pausieren, ohne ihn zu entfernen.

Slack

Slack postet über einen eingehenden Webhook in einen Kanal. Öffne in den Einstellungen deiner Slack-App unter api.slack.com/apps (öffnet in einem neuen Tab) (leg eine App an, wenn du keine hast) „Incoming Webhooks“, schalte sie ein, klick auf „Add New Webhook to Workspace“ und wähl einen Kanal. Die URL beginnt mit https://hooks.slack.com/services/. Jede Änderung wird eine Zeile, formuliert wie die Mitteilung am Mac und in der Sprache der App: der Agent, was passiert ist, das Projekt und was er fragt.

Discord

Öffne in Discord beim Kanal „Kanal bearbeiten ▸ Integrationen ▸ Webhooks“, klick auf „Neuer Webhook“ und dann auf „Webhook-URL kopieren“. Die Nachrichten lesen sich wie in Slack und pingen nie jemanden: @everyone, @here und andere Erwähnungen sind abgeschaltet.

Microsoft Teams

Teams nimmt Webhooks über seine App Workflows an; die alten Office-365-Connectors werden eingestellt. Öffne beim Kanal ⋯ ▸ Workflows, wähl die Vorlage „Send webhook alerts to a channel“, dann Team und Kanal, und klick auf „Speichern“. Kopier die Webhook-URL, die dann erscheint, und füg sie in Gnista als Microsoft Teams hinzu. Jede Änderung kommt als Karte mit derselben Zeile, die Slack bekommt.

Mattermost und Rocket.Chat verstehen das Format von Slack: Füg die URL ihres eingehenden Webhooks als Slack hinzu.

Home Assistant

Leg eine Automation mit einem Webhook-Auslöser (öffnet in einem neuen Tab) an: POST erlaubt, und eine ID, die schwer zu erraten ist. Füg in Gnista mit „Home Assistant oder anderes“ einen Webhook hinzu und trag http://homeassistant.local:8123/api/webhook/ gefolgt von dieser ID ein. Die ID ist das Geheimnis, lass das „Geheimnis“ in Gnista also leer.

Diese Automation färbt eine Lampe rot, solange ein Agent dich braucht, und schaltet sie aus, sobald es weitergeht:

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 }

Laufen mehrere Agents gleichzeitig, gewinnt die letzte Änderung. Für „irgendeine Sitzung braucht mich“ zählst du in einem Helfer mit.

Apple Home

Auf dem Mac kann Gnista HomeKit nicht direkt steuern: Apple lässt Home nur Apps für iPhone und iPad. Ein Kurzbefehl kann es, also führt Gnista einen aus, mit Gnista JSON als Eingabe. Er läuft auf deinem Mac, der Mac muss also wach sein.

Leg in der App Kurzbefehle einen Kurzbefehl an, der das tut:

  1. „Wörterbuch aus Eingabe abrufen“, dann „Wörterbuchwert abrufen“ für event.
  2. „Wenn“ der Wert needsYou ist: „Zuhause steuern“ oder eine Szene, um ein Licht rot einzuschalten.
  3. „Sonst“: „Zuhause steuern“, um dieses Licht auszuschalten.
  4. Klick in Gnista auf „Hinzufügen“ ▸ „Kurzbefehl“ und wähl ihn aus. Lass „Ereignisse“ auf „Alles“, damit das Licht wieder ausgeht, sobald der Agent weitermacht.

Google Home

Google Home hat keinen eingehenden Webhook und keine öffentliche Web-API, mit der ein Mac ein Licht schalten könnte. Seine Entwickler-APIs, die Home APIs, sind für Apps auf Android und iPhone, und seine Automationen können nicht mit einer Webanfrage starten.

Was geht: Home Assistant (öffnet in einem neuen Tab). Die meisten Lichter in Google Home, etwa Matter-, Philips-Hue- und Nest-Geräte, lassen sich auch in Home Assistant einbinden, und ein Matter-Gerät kann mit beiden gleichzeitig verbunden sein. Dann funktioniert die Automation oben, wie sie ist.

Ohne Server: Der Auslöser Receive a web request with a JSON payload von IFTTTs Webhooks (öffnet in einem neuen Tab) nimmt Gnista JSON an, und IFTTTs Dienste für Philips Hue, LIFX, Govee und andere Lichter können die Farbe eines Lichts ändern. Füg die URL des Auslösers, https://maker.ifttt.com/trigger/ mit deinem Ereignisnamen und Schlüssel, in Gnista mit „Home Assistant oder anderes“ hinzu und stell „Ereignisse“ auf „Nur braucht dich“, damit das Applet nur läuft, wenn ein Agent dich braucht. Die Webhooks-Auslöser brauchen IFTTT Pro, einen bezahlten Plan.

Dein eigenes Skript

Gnista JSON ist ein kleines Objekt pro Änderung, als POST. Eine Codex-Sitzung, die einen Befehl ausführen will, sieht so aus:

{
  "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 ist working, needsYou, done, idle oder ended, und previous der Zustand davor. Schlüssel und Werte sind festes Englisch, für Skripte, und version steigt, falls sie sich je so ändern, dass Skripte brechen. message ist Text für Menschen, in der Sprache der App, also prüf nicht darauf: filtere stattdessen nach event, agent.id, project oder machine. Ist ein Geheimnis gesetzt, trägt die Anfrage Authorization: Bearer und dein Geheimnis.

Ohne Gnista

  • Die eigenen Hooks jedes Agents können an eine URL posten: Claude Codes Hooks Notification und Stop, die Hooks von Gemini CLI und Qwen Code oder Codex’ Programm unter notify, jeweils mit curl. Das funktioniert, aber du schreibst und pflegst sie für jeden Agent, und jeder schickt seine Daten in eigener Form.
  • Ohne Hooks erfährst du es im Terminal des Agents oder über seine eigenen Mitteilungen am Mac.

Gut zu wissen

  • Webhooks sind „Experimentell“.
  • Sie senden nur. Eine Anfrage beantwortest du in der Notch oder im Terminal des Agents.
  • Ein Kurzbefehl läuft auf deinem Mac mit Gnista JSON als Eingabe und wird nach 30 Sekunden gestoppt. „Testen“ führt ihn einmal aus, mit event auf test.
  • Ein Fokus, ein gesperrter Bildschirm und stummgeschaltete Sitzungen, Ordner oder Agents halten sie nicht auf: Eine Automation will meist alles. Filtere beim Empfänger, wenn du weniger willst.
  • Einfaches http:// geht nur ins lokale Netzwerk, etwa an homeassistant.local oder eine IP-Adresse dort; überall sonst braucht es https://. Beim ersten Mal fragt macOS vielleicht, ob Gnista Geräte im lokalen Netzwerk finden darf.
  • URLs und Geheimnisse liegen in deinem Schlüsselbund. Jeder Webhook wird für sich gesendet, mit 10 Sekunden Zeitlimit und ohne Wiederholung, sodass ein langsamer nie die anderen aufhält.
  • Fürs Telefon, wenn du nicht am Mac bist: Einstellungen ▸ Mitteilungen ▸ „An mein Telefon senden“, mit Bark, ntfy, Pushover oder Telegram. Am Mac selbst: Claude-Code-Benachrichtigungen und Codex-Benachrichtigungen.
  • Sieben Tage gratis, dann einmalig 19 €. Mehr zu Claude Code, Codex, Gemini CLI und OpenCode.

Mehr Anleitungen.