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.
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
- Téléchargez Gnista, ouvrez-le et cochez vos agents.
- Ouvrez Réglages ▸ Notifications et trouvez Webhooks, marqué Expérimental.
- 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.
- Collez l’URL, ou choisissez le raccourci. Pour Gnista JSON, vous pouvez aussi définir un Secret, envoyé comme jeton Bearer.
- 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.
- 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 :
- « Obtenir le dictionnaire de l’entrée », puis « Obtenir la valeur du dictionnaire » pour
event. - « Si » la valeur est
needsYou: « Contrôler le domicile », ou une scène, pour allumer une lumière en rouge. - « Sinon » : « Contrôler le domicile » pour éteindre cette lumière.
- 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
NotificationetStopde Claude Code, ceux de Gemini CLI et de Qwen Code, ou le programmenotifyde Codex, chacun lançantcurl. Ç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, commehomeassistant.localou une adresse IP de ce réseau ; ailleurs, il fauthttps://. 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.
Les notifications Claude Code
sur votre Mac.Sachez quand Claude Code a terminé ou vous attend, où que vous soyez sur votre Mac.
Les notifications Codex
sur votre Mac.Sachez quand Codex a terminé, ou veut lancer une commande, sans surveiller son terminal.
Approuvez Claude Code
sans changer de fenêtre.Autorisez ou refusez une commande ou une modification depuis l’encoche, puis reprenez ce que vous faisiez.
Les limites de Claude Code et Codex,
en un coup d’œil.Vos limites sur 5 heures et à la semaine pour Claude Code et Codex, sous vos sessions.
Les agents d’Xcode,
dans votre encoche.Sachez quand Claude, Codex ou Antigravity vous attend dans Xcode, sans garder Xcode au premier plan.
Des agents sur un serveur,
et vous répondez depuis votre Mac.Claude Code, Codex et d’autres sur un serveur ou un autre Mac : sachez quand ils vous attendent, et répondez depuis votre Mac.
Des agents en conteneur,
à portée de main.Claude Code ou Codex dans un devcontainer ou un pod Kubernetes : leurs requêtes arrivent quand même dans votre encoche.