Automatisation

Le volet Automatisation est le seul réglage de l'éditeur qui n'est pas propre à un espace de travail. Il configure l'API d'automatisation HTTP de Bromure Agentic Coding — un plan de contrôle en loopback que les outils externes, les scripts et les agents d'IA utilisent pour gérer les espaces de travail et les sessions — et il s'applique à l'ensemble de l'application. Comme il n'appartient à aucun espace de travail en particulier, il n'apparaît que lorsque vous ouvrez l'éditeur en tant que Préférences de l'application.

Il n'y a pas de capture d'écran pour ce volet dans ce chapitre : on y accède via Bromure → Préférences… (⌘,), où l'éditeur est lié au modèle de préférences et la catégorie Automatisation est ajoutée au bas de la barre latérale des catégories. Il n'apparaît pas lorsque vous modifiez un espace de travail ordinaire.

Remarque : Contrairement à tous les volets propres à un espace de travail, celui-ci n'est pas transactionnel. Ses contrôles écrivent les préférences de l'application dès que vous les modifiez — il n'y a pas d'étape Enregistrer, et le commutateur prend effet immédiatement.

Ce qu'est le serveur d'automatisation

Le résumé du volet l'explique clairement : Bromure Agentic Coding expose une API HTTP sur l'interface loopback qui permet aux outils externes de gérer les espaces de travail et les sessions, et la sous-commande bromure-cli mcp fournie englobe la même surface pour les agents d'IA tels que Claude Code et Claude Desktop.

Deux chemins d'accès partagent cette unique surface HTTP, et il convient de les distinguer :

  • Le socket de contrôle — un socket Unix toujours actif et réservé au propriétaire, situé à ~/Library/Application Support/BromureAC/control.sock (mode 0600). L'outil en ligne de commande bromure-cli communique avec l'application via ce socket. Il est indépendant de ce volet : la CLI fonctionne que le serveur d'automatisation soit activé ou non, car les permissions du fichier socket constituent son contrôle d'accès.
  • L'API d'automatisation — les mêmes routes exposées via TCP, désactivées par défaut, activées ici. C'est ce qu'utilisent les clients HTTP externes et le serveur bromure-cli mcp. La désactiver n'affecte pas la CLI.

La liste complète des routes, la CLI et les serveurs MCP sont documentés dans Automatisation et la CLI.

Activer le serveur d'automatisation

Le commutateur Activer le serveur d'automatisation active et désactive l'écouteur TCP. Sa légende reflète l'état actuel :

  • Lorsqu'il est activé : À l'écoute sur 127.0.0.1:9223. Le désactiver arrête le serveur immédiatement ; la sous-commande MCP n'atteindra plus l'application.
  • Lorsqu'il est désactivé : Désactivé — l'API HTTP et la sous-commande MCP sont indisponibles.

Le serveur est désactivé par défaut. Tant qu'il est désactivé, le serveur stdio bromure-cli mcp n'a rien à quoi se connecter, de sorte que tout client MCP configuré pour l'utiliser ne signalera aucun outil tant que vous n'aurez pas activé le serveur ici.

Avertissement : L'API d'automatisation ne dispose d'aucune authentification. Sur l'interface loopback, la liste des profils et des sessions ainsi que la création/fermeture de sessions sont ouvertes à tout processus local ; les routes de mutation et d'introspection (contrôle des espaces de travail, exec, état de l'application, débogage) nécessitent en outre que l'application ait été lancée avec BROMURE_DEBUG_CLAUDE. Comme il n'y a pas d'authentification, exposer l'écouteur au-delà du loopback représente un risque réel — voir Adresse de liaison ci-dessous.

Port et adresse de liaison

Deux champs règlent l'endroit où le serveur écoute :

  • Port — le port TCP, avec un texte indicatif (par défaut : 9223) et une plage valide de 1 à 65535. La valeur par défaut de 9223 est délibérément décalée d'une unité par rapport au port d'automatisation du navigateur web Bromure (9222), afin que les deux applications puissent fonctionner côte à côte.
  • Adresse de liaison — l'interface à laquelle se lier, avec 127.0.0.1 par défaut. Toute valeur autre que loopback déclenche un avertissement orange : Une liaison non-loopback expose l'API au réseau. Le serveur MCP n'a pas d'authentification. Conservez 127.0.0.1 à moins de bien comprendre l'exposition.

Le volet précise le moment d'application : Le port et l'adresse de liaison prennent effet au prochain démarrage du serveur. Désactiver puis réactiver le commutateur les applique immédiatement. Autrement dit, modifiez le port ou l'adresse, puis désactivez et réactivez Activer le serveur d'automatisation pour effectuer une nouvelle liaison sur-le-champ.

Configuration du client MCP

Le bas du volet contient un extrait Configuration du client MCP prêt à coller pour raccorder le serveur bromure-cli mcp à un client MCP. Il indique : ajoutez ceci à ~/.config/claude-code/.mcp.json (ou à l'équivalent de votre client MCP) :

{
  "mcpServers": {
    "bromure-cli": {
      "command": "/Applications/Bromure Agentic Coding.app/Contents/MacOS/bromure-cli",
      "args": ["mcp"]
    }
  }
}

La clé command pointe directement vers le binaire de l'application à l'intérieur du bundle. Activez d'abord le serveur d'automatisation, car les outils de session et de profil du serveur MCP appellent l'API HTTP que vous venez d'activer.

Où sont stockés les réglages

Tout ce qui figure dans ce volet est stocké dans les préférences de l'application sous le domaine io.bromure.agentic-coding, et non dans un quelconque profile.json. Les trois mêmes clés peuvent être définies depuis la ligne de commande ou via AppleScript, ce qui est utile pour le provisionnement scripté :

RéglageClé de préférenceTypePar défaut
Activer le serveur d'automatisationautomation.enabledBooléenfalse
Portautomation.portEntier (1–65535)9223
Adresse de liaisonautomation.bindAddressChaîne (IP)127.0.0.1

Par exemple, defaults write io.bromure.agentic-coding automation.enabled -bool true active le serveur, et set ac app setting "automation.enabled" to value "true" en AppleScript le bascule à chaud. Le fonctionnement des deux, ainsi que tout ce que les serveurs API et MCP peuvent faire, sont décrits dans Automatisation et la CLI.