Ce que font vos agents,
là où vous le voulez.

Gnista sait déjà quand chacun de vos agents de code travaille, vous attend ou a terminé. Les webhooks transmettent cela : un message dans Slack, Discord ou Microsoft Teams, une lampe rouge dans Home Assistant ou Maison, une ligne dans votre propre journal. Voici comment configurer chacun, et ce qu’il faut faire sans Gnista.

7 jours d’essai gratuitSans compte ni carte · puis 19 € une fois

Mis à jour le

En deux mots

Dans Réglages ▸ Notifications ▸ Webhooks de Gnista, cliquez sur Ajouter, choisissez Slack, Discord, Microsoft Teams ou Home Assistant ou autre et collez l’URL, ou choisissez Raccourci et l’un de vos raccourcis. Dès lors, les changements que vous choisissez y partent depuis chaque agent que Gnista connecte : Claude Code, Codex, Gemini CLI, OpenCode et les autres, sur votre Mac ou via SSH.

Avec Gnista

  1. Téléchargez Gnista, ouvrez-le et cochez vos agents.
  2. Ouvrez Réglages ▸ Notifications et trouvez Webhooks, marqué Expérimental.
  3. Cliquez sur Ajouter et choisissez : Slack, Discord ou Microsoft Teams pour un message, Home Assistant ou autre pour Gnista JSON, un petit JSON pour Home Assistant ou votre propre script, ou Raccourci pour lancer l’un de vos raccourcis avec ce JSON.
  4. Collez l’URL, ou choisissez le raccourci. Pour Gnista JSON, vous pouvez aussi définir un Secret, envoyé comme jeton Bearer.
  5. Dans le menu ⋯ de la ligne, choisissez ses Événements : Tout, Vous attend uniquement ou Vous attend et tours terminés. Les messageries commencent par Vous attend uniquement, pour ne pas inonder un salon ; Gnista JSON et les raccourcis commencent par Tout.
  6. Choisissez Tester dans le même menu. Un exemple part, ou le raccourci s’exécute une fois, et la ligne indique comment ça s’est passé. Chaque webhook a son propre interrupteur, pour le mettre en pause sans le supprimer.

Slack

Slack publie dans un canal grâce à un webhook entrant. Dans les réglages de votre app Slack, sur api.slack.com/apps (s’ouvre dans un nouvel onglet) (créez une app si vous n’en avez pas), ouvrez Incoming Webhooks, activez-les, cliquez sur Add New Webhook to Workspace et choisissez un canal. L’URL commence par https://hooks.slack.com/services/. Chaque changement devient une ligne, rédigée comme la notification du Mac et dans la langue de l’app : l’agent, ce qui s’est passé, le projet, et ce qu’il demande.

Discord

Dans Discord, ouvrez Modifier le salon ▸ Intégrations ▸ Webhooks, cliquez sur Nouveau webhook, puis sur Copier l’URL du webhook. Les messages se lisent comme dans Slack, et ne mentionnent jamais personne : @everyone, @here et les autres mentions sont désactivées.

Microsoft Teams

Teams reçoit les webhooks par son app Workflows ; les anciens connecteurs Office 365 sont en cours de retrait. Dans le canal, ouvrez ⋯ ▸ Workflows, choisissez le modèle « Send webhook alerts to a channel », puis l’équipe et le canal, et cliquez sur Enregistrer. Copiez l’URL du webhook affichée, et ajoutez-la dans Gnista comme Microsoft Teams. Chaque changement arrive sous forme de carte, avec la même ligne que Slack.

Mattermost et Rocket.Chat acceptent le format de Slack : ajoutez l’URL de leur webhook entrant comme Slack.

Home Assistant

Créez une automatisation avec un déclencheur webhook (s’ouvre dans un nouvel onglet) : POST autorisé, et un identifiant difficile à deviner. Ajoutez un webhook dans Gnista avec Home Assistant ou autre et collez http://homeassistant.local:8123/api/webhook/ suivi de cet identifiant. L’identifiant fait office de secret : laissez donc le Secret de Gnista vide.

Cette automatisation passe une lampe au rouge tant qu’un agent vous attend, et l’éteint dès qu’il reprend :

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 }

Avec plusieurs agents à la fois, le dernier changement l’emporte. Pour « une session m’attend », tenez un compte dans une entrée auxiliaire (helper).

L’app Maison

Sur un Mac, Gnista ne peut pas piloter HomeKit directement : Apple réserve Maison aux apps conçues pour iPhone et iPad. Un raccourci, lui, le peut : Gnista en lance un, avec Gnista JSON comme entrée. Il s’exécute sur votre Mac, qui doit donc être réveillé.

Dans l’app Raccourcis, créez un raccourci qui fait ceci :

  1. « Obtenir le dictionnaire de l’entrée », puis « Obtenir la valeur du dictionnaire » pour event.
  2. « Si » la valeur est needsYou : « Contrôler le domicile », ou une scène, pour allumer une lumière en rouge.
  3. « Sinon » : « Contrôler le domicile » pour éteindre cette lumière.
  4. Dans Gnista, cliquez sur Ajouter ▸ Raccourci et choisissez-le. Laissez Événements sur Tout, pour que la lumière s’éteigne quand l’agent reprend.

Google Home

Google Home n’a ni webhook entrant ni API web publique avec laquelle un Mac pourrait allumer une lampe. Ses API pour développeurs, les Home APIs, sont faites pour les apps Android et iPhone, et ses automatisations ne peuvent pas démarrer sur une requête web.

Ce qui marche : Home Assistant (s’ouvre dans un nouvel onglet). La plupart des lampes de Google Home, comme les appareils Matter, Philips Hue et Nest, s’ajoutent aussi à Home Assistant, et un appareil Matter peut être partagé avec les deux à la fois. L’automatisation ci-dessus marche alors telle quelle.

Sans serveur : le déclencheur Receive a web request with a JSON payload des Webhooks (s’ouvre dans un nouvel onglet) d’IFTTT accepte Gnista JSON, et les services IFTTT de Philips Hue, LIFX, Govee et d’autres lampes savent en changer la couleur. Ajoutez l’URL du déclencheur, https://maker.ifttt.com/trigger/ suivi de votre nom d’événement et de votre clé, dans Gnista avec Home Assistant ou autre, et réglez Événements sur Vous attend uniquement, pour que l’applet ne s’exécute que quand un agent a besoin de vous. Les déclencheurs Webhooks demandent IFTTT Pro, une formule payante.

Votre propre script

Gnista JSON, c’est un petit objet par changement, envoyé en POST. Une session Codex qui demande à lancer une commande ressemble à ceci :

{
  "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 vaut working, needsYou, done, idle ou ended, et previous l’état d’avant. Les clés et ces valeurs sont en anglais fixe, pour les scripts, et version augmente si elles changent un jour d’une façon qui les casse. message est un texte pour les humains, dans la langue de l’app : ne vous y fiez pas pour filtrer, filtrez plutôt sur event, agent.id, project ou machine. Avec un secret, la requête porte Authorization: Bearer suivi de votre secret.

Sans Gnista

  • Les hooks de chaque agent peuvent envoyer vers une URL : les hooks Notification et Stop de Claude Code, ceux de Gemini CLI et de Qwen Code, ou le programme notify de Codex, chacun lançant curl. Ça marche, mais c’est à vous de les écrire et de les entretenir pour chaque agent, et chacun envoie ses données à sa façon.
  • Sans hooks, vous l’apprenez dans le terminal de l’agent, ou par ses propres notifications sur votre Mac.

Bon à savoir

  • Les webhooks sont marqués Expérimental.
  • Ils ne font qu’envoyer. Pour répondre à une demande, passez par l’encoche ou le terminal de l’agent.
  • Un raccourci s’exécute sur votre Mac avec Gnista JSON comme entrée, et s’arrête au bout de 30 secondes. Tester le lance une fois, avec event à test.
  • Une Concentration, un écran verrouillé et les sessions, dossiers ou agents mis en sourdine ne les arrêtent pas : une automatisation veut en général tout recevoir. Filtrez à la réception si vous voulez moins.
  • Le http:// simple ne fonctionne que vers votre réseau local, comme homeassistant.local ou une adresse IP de ce réseau ; ailleurs, il faut https://. La première fois, macOS peut vous demander si Gnista peut trouver des appareils sur votre réseau local.
  • Les URL et les secrets sont gardés dans votre trousseau. Chaque webhook est envoyé séparément, avec un délai de 10 secondes et sans nouvel essai, pour qu’un webhook lent ne retienne jamais les autres.
  • Pour votre téléphone quand vous êtes loin du Mac : Réglages ▸ Notifications ▸ Envoyer sur mon téléphone, avec Bark, ntfy, Pushover ou Telegram. Sur le Mac lui-même : notifications Claude Code et notifications Codex.
  • Sept jours gratuits, puis 19 € une fois. Plus de détails sur Claude Code, Codex, Gemini CLI et OpenCode.

D’autres guides.