Bromure Agentic Coding — Manuel de l'utilisateur
Bienvenue dans le manuel de l'utilisateur officiel de Bromure Agentic Coding, l'application macOS qui exécute des agents de codage IA — Claude Code, Codex CLI, Grok CLI et l'outillage shell ordinaire — au sein de machines virtuelles Linux jetables, avec une passerelle côté hôte qui maintient vos véritables identifiants hors de portée de l'agent.
Ce manuel documente la version 4.3.0. Il nécessite macOS 14 (Sonoma) ou une version ultérieure sur Apple Silicon. Si vous débutez, lisez Introduction puis Démarrage rapide ; tout le reste constitue une référence que vous pourrez consulter selon vos besoins.
Vous découvrez l'application ? Le chemin le plus rapide vers un agent en fonctionnement passe par l'Installation suivie du guide pas à pas Démarrage rapide.
Table des matières
Pour commencer
| Chapitre | Ce qu'il couvre |
|---|---|
| 1. Introduction | Ce qu'est l'application, le modèle de sécurité à frontière unique, les fonctionnalités piliers et sa comparaison avec d'autres outils. |
| 2. Installation | Configuration requise, téléchargement et installation de l'application, le flux de configuration au premier lancement, les mises à jour d'image de base, la migration et la désinstallation. |
| 3. Démarrage rapide | D'une nouvelle installation à un agent en fonctionnement en une dizaine de minutes : créer un espace de travail, choisir un agent, partager un dossier, exécuter une tâche et inspecter la trace. |
Fondamentaux
| Chapitre | Ce qu'il couvre |
|---|---|
| 4. Concepts et architecture | Hôte contre invité, espaces de travail contre sessions contre VM, le cycle de vie des VM, la frontière du fil, le stockage, les ponts vsock et le réseau. |
| 5. Espaces de travail | Le navigateur d'espaces de travail : pastilles d'état, cartes de ressources, le résumé de configuration, ainsi que la création, la duplication, la réinitialisation et la suppression des espaces de travail. |
| 6. Sessions | La fenêtre de session unifiée : démarrer et fermer des sessions, onglets et worktrees, les volets de navigateur et de fichiers, le transfert de fichiers et les points de contrôle. |
| Le navigateur intégré | Utiliser le Chromium intégré à l'espace de travail : le piloter soi-même, laisser l'agent le piloter via les outils de navigateur, rester connecté et la confidentialité. |
| Automatisations | Exécutions d'agent planifiées et sans surveillance sur un tableau kanban : les créer, déclencheurs et planifications, automatisations chaînées, historique des exécutions et réponse à leurs invites. |
| Tâches de code | Le kanban de code : consignes, phases planifiées par l'agent avec leurs dépendances, exécutions autonomes dans des worktrees, revue de diff avec commentaires par 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 Modifier l'espace de travail et une référence page par volet pour les seize volets. |
La référence des réglages comporte une page par volet : Général, Agents, Modèles locaux, Fusion, Dossiers, Identifiants, Environnement, MCP, Traçage, Garde-fous, Chaîne d'approvisionnement, Injection de prompt, Apparence, Navigateur, Ressources, et le volet Automatisation à l'échelle de l'application.
Les piliers en détail
| Chapitre | Ce qu'il couvre |
|---|---|
| 8. Identifiants et frontière du fil | Comment les véritables secrets restent sur l'hôte et l'agent n'obtient que des leurres : le proxy MITM, les cycles de vie par identifiant, les approbations et le détecteur 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, Delpi et le retrait des scripts. |
| 10. Détection d'injection de prompt et garde-fous | Des détecteurs sur l'appareil qui analysent le trafic IA de l'agent à la recherche d'instructions injectées, ainsi que des garde-fous qui retirent les opérations d'infrastructure destructrices. |
| 11. Traçage et audit | Ce qu'enregistre une trace de session, l'Inspecteur de traces, le chiffrement au repos, la rétention, l'exportation et la confidentialité. |
| 12. Fusion — le panneau multi-modèles | Répondre à chaque prompt avec plusieurs modèles à la fois, jugés et synthétisés sur le fil en une réponse unique. |
| 13. Inférence locale et hybride | Exécuter des modèles sur votre propre Apple Silicon avec MLX, le catalogue de modèles, le repli hybride cloud/local et les métriques d'inférence. |
Au-delà d'un seul Mac
| Chapitre | Ce qu'il couvre |
|---|---|
| 14. Accès à distance et client riche | Atteindre votre bac à sable depuis n'importe où — le miroir du client riche, la CLI, SSH, les tunnels, PAC et le modèle de sécurité à distance. |
| 15. Entreprise — inscription et parc | S'inscrire auprès de Bromure Enterprise Manager, quelle télémétrie est téléversée (et laquelle ne l'est pas), la vue du parc et le désenrôlement. |
Référence
| Chapitre | Ce qu'il couvre |
|---|---|
| 16. CLI, automatisation et MCP | L'interface en ligne de commande bromure-cli, l'API de contrôle en boucle locale, le serveur MCP et AppleScript. |
| Avancé | Outils pour utilisateurs avancés, dont le navigateur de fichiers ext4 pour lire l'image d'accueil d'un espace de travail arrêté sans le démarrer. |
| 17. Dépannage | Diagnostiquer les problèmes de configuration, de VM, d'authentification, 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 technique utilisé dans ce manuel. |
| 19. Annexe | Tableaux de référence : emplacements sur disque, ports réseau, variables d'environnement et arguments de lancement, et l'aide-mémoire de la VM invitée. |
Conventions utilisées dans ce manuel
- Le texte en gras nomme un contrôle à l'écran exactement tel que l'application l'intitule — un bouton, un élément de menu, un commutateur ou un volet (par exemple, Démarrer cette VM à l'ouverture de session).
- Le texte en
Monospaceest une commande, un chemin de fichier, une variable d'environnement ou une valeur littérale que vous tapez ou voyez (par exemple,bromure-cli runou~/Library/Application Support/BromureAC). - Les captures d'écran montrent l'interface en français. L'application est entièrement localisée ; vos écrans correspondront à la langue de votre macOS.
- Les remarques, astuces et avertissements apparaissent sous forme de callouts :
Remarque : Information de fond utile à connaître.
Astuce : Un raccourci ou une pratique recommandée.
Avertissement : Quelque chose qui peut entraîner une perte de 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 détaillée des fonctionnalités se trouvent 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.