Bromure Agentic Coding — Manuel de l'utilisateur

Bienvenue dans le manuel officiel de Bromure Agentic Coding, l'app macOS qui fait tourner des agents de code IA — Claude Code, Codex, Grok, Kimi Code, Oh My Pi, et l'outillage shell ordinaire — à l'intérieur de machines virtuelles Linux isolées sur votre Mac, avec une passerelle côté hôte qui garde vos véritables identifiants hors de portée de l'agent.

Ce manuel documente la version 5.0.0. Elle exige macOS 14 (Sonoma) ou plus récent sur Apple Silicon.

La version 5.0.0 est organisée autour des sessions : chaque conversation avec un agent est une ligne de la barre latérale, et vous lui parlez dans un chat. Les VM Linux dans lesquelles tournent les sessions s'appellent des machines dans la fenêtre principale. L'éditeur de réglages les appelle encore des espaces de travail ; les deux mots veulent dire la même chose.

Nouveau dans l'app ? Commencez par Installation et premier lancement, puis suivez le Démarrage rapide. Lisez Concepts et architecture quand vous voudrez la vue d'ensemble. Servez-vous du reste comme référence.

Table des matières

Pour commencer

Chapitre	Ce qu'il couvre
1. Introduction	Ce qu'est l'app, le modèle de sécurité à frontière unique, les grandes fonctions, et comment elle se compare aux autres outils.
2. Installation et premier lancement	Prérequis système, installation de l'app, l'assistant de mise en route en six étapes, les mises à jour de l'image de base, l'outil en ligne de commande, le stockage, le passage à un nouveau Mac, et la désinstallation.
3. Démarrage rapide	De l'assistant à une tâche terminée : démarrer une session, répondre à la question de l'agent, regarder les fichiers modifiés, inspecter la trace, puis archiver la session et la ramener.
4. Concepts et architecture	Sessions, machines, salles et branches ; états de session ; hôte et invité ; la frontière du fil ; ce qui persiste ; les ports vsock et MCP ; le réseau.

Au quotidien

Chapitre	Ce qu'il couvre
5. L'accueil des sessions	La fenêtre principale : la barre latérale et son rail replié, les lignes de session et leurs menus, l'en-tête de session, le menu des machines, la pastille Linux, la palette de commandes ⌘K, et l'archivage, la fin, la suppression et l'annulation.
6. Démarrer une session	L'écran de nouvelle session : choisir l'agent, la machine et où elle travaille (un dossier neuf, l'un des vôtres, ou un dépôt), joindre des fichiers, les démarrages récents, et interroger une autre session avec @.
6.1 Le chat	Parler à un agent : la zone de composition, les pièces jointes, les commandes slash et le terminal en ligne, les cartes de question, les lignes d'activité, les résumés de fichiers modifiés, les cartes de connexion, arrêter, modifier et renvoyer, et la recherche.
6.2 Salles	Grouper des sessions liées dans une salle : la grille de chats vivants, les dispositions et les onglets, zoomer sur une cellule, le Standard propre à la salle, et envoyer à toute la salle.
6.3 Branches et revue	Les sessions de branche sur leur propre worktree git, les refusionner, la fenêtre Branches, et la fenêtre de revue avec commentaires de ligne.
6.4 Des agents qui travaillent ensemble	La délégation à des sessions enfants, les requêtes à d'autres sessions par @pseudo, le panneau Délégations, le passage de fichiers, les limites, et les requêtes entre machines.
6.5 Standard et messagerie	La session Standard qui garde trace de toutes les autres sessions, ses règles de sûreté, et le connecteur de messagerie pour Signal, WhatsApp et Slack.
6.6 Machines	La section Machines virtuelles : créer, démarrer, suspendre et supprimer des machines, Rembobiner le dossier personnel et Réinitialiser le disque, les terminaux et la Grille, le volet Fichiers, et le presse-papiers.
6.7 Le navigateur intégré	Le navigateur Chromium à côté d'une session : le piloter vous-même, laisser l'agent le piloter par les outils de navigateur, rester connecté, et la confidentialité.
Accélération Metal dans Bromure Web	L'application web autonome : prérequis de Metal, commandes globales et par profil, moteur de rendu actif, et prise en charge de la vidéo.
6.8 Automatisations	Des exécutions d'agent programmées et sans surveillance sur un tableau kanban : déclencheurs, horaires, chaînes, historique, répondre à leurs questions, et le serveur MCP des automatisations.
6.9 Tâches de code	Le kanban du code : tâches, phases planifiées par l'agent, exécutions autonomes dans des worktrees, revue avec commentaires de ligne, et fusion.

Référence des réglages

Chapitre	Ce qu'il couvre
7. Référence des réglages	Comment ouvrir l'éditeur de réglages et les Préférences, la liste groupée des volets et Rechercher dans les réglages, le modèle Valeurs par défaut, et ce qui s'enregistre quand.

La référence des réglages a une page par volet, dans l'ordre de l'éditeur :

Espace de travail : Général, Apparence
Modèles : Modèles, Fusion, Squelch
Machine : Dossiers, Environnement, MCP, Navigateur, Ressources
Sécurité : Identifiants, Traçage, Garde-fous, Chaîne d'approvisionnement, Injection de prompt, Protection des données personnelles
App (Préférences seulement) : Automatisation

Sécurité et frontière du fil

Chapitre	Ce qu'il couvre
8. Identifiants et la frontière du fil	Comment les vrais secrets restent sur l'hôte tandis que l'agent ne reçoit que des leurres : le proxy MITM, connexions et clés d'API, approbations par identifiant, et l'alerte de compromission.
9. Protection de la chaîne d'approvisionnement	Vérifier, réécrire et bloquer les installations de paquets avant que l'agent ne les voie : la barrière d'âge, OSV, socket.dev, Depi, et le dépouillement des scripts d'installation.
10. Détection d'injection de prompt et garde-fous	Les détecteurs sur l'appareil qui scrutent le trafic IA de l'agent à la recherche d'instructions injectées, le pare-feu de sortie, et les garde-fous sur les opérations destructrices.
10.5 Protection des données personnelles	Échanger les données personnelles contre des remplaçants cohérents avant qu'une conversation ne quitte votre Mac, et les rétablir dans les réponses.
11. Traçage et audit	Ce qu'une trace de session enregistre, l'Inspecteur de traces, le chiffrement au repos, la conservation, l'export, et la confidentialité.
11.5 Vue d'ensemble et chronologie de sécurité	La fenêtre Chronologie de sécurité : la Vue d'ensemble sur 24 heures, les protections par machine, et la Chronologie filtrable et exportable de chaque décision de sécurité.

Modèles et infrastructure

Chapitre	Ce qu'il couvre
12. Fusion — le panneau multi-modèles	Répondre à chaque prompt avec plusieurs modèles à la fois, jugés et combinés en une réponse unique sur le fil.
12.5 Squelch — moins de bruit, moins de tokens	Élaguer les tests réussis, la progression et autres bruits de la sortie des commandes avant que le modèle ne la lise (d'après rtk), et les tokens économisés par session.
13. Modèles et fournisseurs	Le tableau Modèles global : fournisseurs (connexions, clés d'API, Amazon Bedrock, OpenRouter, serveurs personnalisés, modèles sur l'appareil), choix de modèle par agent, surcharges par espace de travail, et changements à chaud.
13.5 Clusters Kubernetes et registres	Faire tourner des clusters k3s et un registre de conteneurs privé dans leurs propres VM à côté de vos machines : stockage, répartition de charge, modules, accès, et le serveur MCP d'infrastructure.

Au-delà d'un seul Mac

Chapitre	Ce qu'il couvre
14. Accès à distance et client riche	Refléter un Bromure distant depuis un autre Mac, un iPhone, un iPad ou un Apple Vision Pro ; les Préférences distantes ; la CLI par SSH, les tunnels et le PAC ; et le modèle de sécurité distant.
15. Entreprise — Inscription et parc	S'inscrire auprès de bromure.io, ce que la télémétrie envoie (et ce qu'elle n'envoie pas), la vue du parc, et le départ.

Référence

Chapitre	Ce qu'il couvre
16. CLI, API et MCP	L'outil en ligne de commande `bromure-cli`, l'API de contrôle en bouclage, les serveurs MCP, et AppleScript.
16.5 Avancé	Outils pour utilisateurs avancés : l'explorateur de fichiers ext4 et la vérification du système de fichiers, et restaurer ou rembobiner le dossier personnel d'une machine.
17. Dépannage	Diagnostiquer les problèmes d'installation, de machine, de connexion, de TLS, de chaîne d'approvisionnement, d'espace disque et d'accès à distance, organisés par symptôme.
18. Glossaire	Définitions de chaque terme employé dans ce manuel.
19. Annexe	Tableaux de référence : emplacements sur le disque, ports réseau et vsock, variables d'environnement, valeurs par défaut, raccourcis clavier, et l'aide-mémoire de l'invité.

Conventions de ce manuel

Le texte en gras nomme une commande ou une étiquette à l'écran exactement comme l'app la montre en anglais — un bouton, un élément de menu, un interrupteur, un volet ou une section de barre latérale (par exemple New session ou Start this VM at login).
Le texte en chasse fixe est une commande, un chemin de fichier, une variable d'environnement ou une valeur littérale que vous tapez ou voyez (par exemple bromure-cli vm ls ou ~/Library/Application Support/BromureAC).
Un chemin comme Workspaces › Infrastructure › Messaging Connector… est un chemin de menu : le menu, puis chaque sous-menu ou élément dans l'ordre. Préférences › Modèles désigne le volet Modèles de la fenêtre des Préférences.
Machine et espace de travail veulent dire la même chose : une VM Linux isolée avec ses réglages. La fenêtre principale dit machine ; l'éditeur de réglages, les menus comme New Workspace… et la CLI disent espace de travail (ou profil).
Une session est une conversation avec un agent, dans un dossier, sur une machine. Ce n'est pas une exécution de machine ; voir Concepts et architecture.
Les raccourcis clavier utilisent les symboles de macOS : ⌘ Commande, ⌥ Option, ⌃ Contrôle, ⇧ Majuscule, ⏎ Retour, ⎋ Échap.
Les captures d'écran montrent l'interface en anglais avec du contenu de démonstration synthétique. L'app est localisée, vos écrans suivent donc la langue de votre macOS.
Notes, astuces et avertissements apparaissent comme des encadrés :

Note : une information de fond qui vaut d'être connue.

Astuce : un raccourci ou une bonne pratique.

Avertissement : quelque chose qui peut perdre des données ou affaiblir une protection si vous vous trompez.

Où chercher ailleurs

Les téléchargements du produit, le livre blanc technique et la matrice de fonctions détaillée sont sur bromure.io. Pour les questions auxquelles ce manuel ne répond pas, Dépannage rassemble les procédures de diagnostic, et le Glossaire définit le vocabulaire.