Bromure Sidecar pour Windows
Bromure Sidecar fait d'un PC Windows une machine native pour Bromure Agentic Coding. Les machines de votre Mac sont des VM Linux. Une machine Sidecar est un vrai PC Windows, qui exécute des agents de code — Claude Code, Codex, Grok Build, Kimi Code, Oh My Pi — directement sous Windows, dans votre propre compte Windows.
Une fois le PC connecté au même compte bromure.io que votre Mac et rattaché à celui-ci, il apparaît dans Bromure Agentic Coding comme une machine de plus. Ses sessions s'affichent sur le Mac à côté de celles qui tournent dans des VM : vous pouvez les lancer depuis le Mac, les suivre, discuter avec elles et leur déléguer du travail. Vous pouvez aussi lancer des sessions sur le PC lui-même, depuis l'icône du Sidecar dans la zone de notification.
Le PC et le Mac se parlent de pair à pair via bromure.io. Le PC ne fait que des connexions sortantes : aucun port à rediriger, aucun VPN, aucune adresse à saisir.
Remarque : Comme les agents d'un Sidecar tournent directement sur le PC, ils ne passent pas par la frontière réseau d'une machine. Squelch, l'injection d'identifiants, le traçage et la politique de bac à sable sont des fonctions des machines (les VM Linux) et ne s'appliquent pas à une machine native. Un agent Sidecar a les accès de votre compte Windows ; choisissez son niveau d'approbation en conséquence (voir Niveaux d'approbation).
Ce chapitre couvre l'installation du Sidecar, la connexion et le rattachement, l'installation des agents, les sessions, les réglages, les mises à jour, la désinstallation, la ligne de commande et le dépannage. Pour le côté Mac de l'accès à distance, voir Accès à distance et clients.
Configuration requise
| Windows | Windows 10 version 1809 ou ultérieure, ou Windows 11. 64 bits, sur Intel/AMD (x64) ou ARM (ARM64). |
| Git for Windows | Obligatoire : les agents et les commandes de Bromure Agentic Coding s'exécutent sous Git Bash. L'installeur propose de l'installer s'il manque. |
| Microsoft Edge WebView2 Runtime | Obligatoire pour la fenêtre du Sidecar. Intégré à Windows 11 ; l'installeur le propose s'il manque. |
| Un compte | Un compte bromure.io — celui auquel est connecté le Bromure Agentic Coding de votre Mac. |
| Droits d'administrateur | Inutiles. Tout s'installe dans votre propre compte. |
Sous Windows 11 version 22H2 et ultérieure, les fenêtres du Sidecar adoptent le style translucide de Windows 11 ; sur les versions plus anciennes, elles sont plus sobres mais fonctionnent de la même façon.
Installation
Téléchargez l'installeur adapté à votre PC :
| PC | Téléchargement |
|---|---|
| Intel ou AMD (la plupart des PC) | BromureSidecar-x64.exe |
| ARM (par exemple les portables Snapdragon) | BromureSidecar-arm64.exe |
Ces liens pointent toujours vers la dernière version. Vous ne savez pas lequel prendre ? Ouvrez Paramètres → Système → Informations système et regardez Type du système : « processeur x64 » signifie x64, « processeur ARM » signifie ARM64. L'installeur ARM64 refuse de s'exécuter sur un PC x64, et vous le dit.
Lancez l'installeur. Il est signé par Seclio LLC, et Windows affiche donc cet éditeur. Ensuite :
- Si Git for Windows ou le WebView2 Runtime manque, l'installeur les présente comme composants. Laissez-les cochés pour les installer aussi : Git vient de winget, et WebView2 de Microsoft. Quand les deux sont déjà présents, cette page est sautée.
- L'installeur copie Bromure Sidecar dans
%LOCALAPPDATA%\Programs\Bromure Sidecar. - Sur la dernière page, laissez Start Bromure Sidecar coché.
L'installeur, en outre :
- ajoute un raccourci Bromure Sidecar au menu Démarrer ;
- lance le Sidecar à l'ouverture de votre session Windows ;
- enregistre le type de lien
bromure-agent-host://que bromure.io utilise pour rendre la connexion au PC ; - ajoute une entrée dans Paramètres → Applications → Applications installées, pour la désinstallation.
L'icône de notification et le volet
Bromure Sidecar vit dans la zone de notification de la barre des tâches. Si vous ne voyez pas son icône, cliquez sur la flèche ^ ; vous pouvez faire glisser l'icône sur la barre des tâches pour la garder visible.
L'icône indique l'état d'un coup d'œil :
| Icône | Signification |
|---|---|
| Grise | Le Sidecar ne tourne pas, ou le PC n'est rattaché à aucun Bromure Agentic Coding. |
| En couleur | Rattaché. Survolez-la pour voir le nom du Mac auquel il est rattaché. |
| Avec un point | Un agent a besoin de vous : il attend une réponse ou une approbation. |
Un clic gauche sur l'icône ouvre le volet, le panneau du Sidecar. Cliquez ailleurs, ou appuyez sur Échap, pour le fermer. Un clic droit ouvre un menu avec Open Bromure Sidecar, Coding Agents… et Quit Bromure Sidecar.
Le volet affiche, de haut en bas :
- L'en-tête : « Bromure Sidecar » et une ligne d'état, comme « Not signed in to bromure.io », « Signed in as nom-du-pc » ou « Attached to Mac as nom-du-pc ». Ses deux boutons ouvrent Coding agents et Settings.
- Des bandeaux, le cas échéant : « Git for Windows is needed », avec un bouton Install, ou « Bromure Sidecar version is available », avec un bouton Update.
- La carte de connexion : se connecter, ou se rattacher à un Mac.
- Sessions : les agents qui tournent sur ce PC.
- Le pied : Coding Agents et Quit.
Se connecter à bromure.io
La carte de connexion du volet affiche Reach this PC from Bromure AC.
- Cliquez sur Sign in to bromure.io. Votre navigateur ouvre la page de connexion de bromure.io.
- Connectez-vous avec le compte qu'utilise votre Mac, et approuvez l'ajout de ce PC.
- bromure.io rend la connexion au Sidecar par un lien
bromure-agent-host://; votre navigateur peut demander s'il faut ouvrir Bromure Sidecar. Acceptez.
La ligne d'état passe à « Signing in… », puis à « Signed in as nom-du-pc ».
Si le navigateur ne parvient pas à ouvrir le Sidecar (par exemple parce que vous avez terminé la connexion sur un autre ordinateur), copiez le lien bromure-agent-host:// depuis la page, puis cliquez sur Paste link dans le volet.
Sécurité : Le Sidecar n'accepte que la connexion qu'il a lui-même lancée. Un lien
bromure-agent-host://doit porter le code de la connexion commencée avec Sign in to bromure.io, qu'il arrive du navigateur ou qu'il soit collé ; tout autre lien est refusé avec « that sign-in link wasn't started here — sign in again from the menu ». Cela empêche une page web ou un message de glisser ce PC dans le compte de quelqu'un d'autre. Si vous voyez ce message, cliquez de nouveau sur Sign in to bromure.io et allez au bout de cette connexion.
Le nom de machine est celui sous lequel Bromure Agentic Coding liste ce PC. Par défaut, c'est le nom de l'ordinateur suivi de -native ; vous pouvez le changer dans les réglages.
Se rattacher à Bromure Agentic Coding
Une fois connecté, la carte de connexion liste les serveurs de votre compte : les Mac dont Bromure Agentic Coding est en ligne, chacun avec Online ou Offline et un bouton Attach. Si aucun n'est listé, « No Bromure AC server is online in your account » : ouvrez Bromure Agentic Coding sur votre Mac (connecté au même compte, avec l'accès à distance via bromure.io activé — voir Accès à distance et clients).
Cliquez sur Attach à côté de votre Mac :
- La carte affiche Connecting.
- La première fois, elle affiche Waiting for approval : « Allow this PC in Bromure AC's fleet dialog on Mac. » Sur le Mac, approuvez le PC quand Bromure Agentic Coding le demande.
- La carte affiche Attached, et l'icône de notification passe du gris à la couleur.
Le PC figure maintenant parmi les machines du Mac, sous Native Machines. Le rattachement survit aux redémarrages : le Sidecar se reconnecte tout seul à son prochain lancement. Cliquez sur Detach pour arrêter ; le Mac oublie alors ce PC jusqu'à ce que vous le rattachiez de nouveau.
Si le rattachement échoue, la carte dit pourquoi :
- « Can't reach Mac » — le Mac est hors ligne ou injoignable.
- « Mac didn't accept this machine (is it up to date?) » — mettez à jour Bromure Agentic Coding sur le Mac.
- « Mac refused this machine » — le PC a été refusé sur le Mac ; le Sidecar réessaie au bout de deux minutes.
Agents de code
Le Sidecar n'est livré avec aucun agent. Ouvrez Coding Agents (le bouton du volet, ou Coding Agents… dans le menu de l'icône) pour choisir ceux que ce PC exécute :
| Agent | Éditeur | Remarques |
|---|---|---|
| Claude Code | Anthropic | Intégration complète : état en direct, chat et délégation dans Bromure Agentic Coding. |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot AI | |
| Oh My Pi | Open source |
Chaque carte affiche l'état de l'agent (Installed · version, Not installed, Installing, Queued, Failed) et la commande exacte que lance son installeur, avec un bouton de copie.
- Install / Update lance l'installeur de l'agent, téléchargé chez son éditeur, dans votre compte, sans droits d'administrateur. Bromure n'en intègre ni n'en héberge aucun. Les installations se font une à la fois. La plupart des agents se tiennent ensuite à jour eux-mêmes.
- Sign in… connecte l'agent à son fournisseur. Le Sidecar affiche un code à usage unique avec Copy et Open sign-in page ; pour Claude Code, recollez le code qu'affiche la page et cliquez sur Submit. « Agent: signed in » le confirme. (Oh My Pi n'a pas d'étape de connexion ici.)
- Check again réexamine ce qui est installé, par exemple après que vous avez installé un agent vous-même.
Niveaux d'approbation
Chaque carte d'agent a un réglage d'approbation. Il s'applique aux sessions nouvelles et reprises :
| Niveau | Ce que fait l'agent |
|---|---|
| Ask | Demande avant d'agir — le comportement par défaut de l'agent. |
| Auto | Ne demande que lorsqu'une action est risquée. Pour Codex : ne demande jamais, mais garde le bac à sable de Codex. Pour Kimi Code : ne demande qu'en cas de besoin. |
| Full | Ne demande jamais, sans aucune limite. |
Oh My Pi ne propose que Ask et Full.
Avertissement : Sur un Sidecar, Full signifie que l'agent peut faire tout ce que peut votre compte Windows, sans demander. Préférez Ask ou Auto, sauf si le PC est dédié aux agents.
Sessions
La liste Sessions du volet montre chaque agent qui tourne sur ce PC — lancé depuis le Mac ou depuis le PC — avec son titre, son agent, son dossier et un état : Working, Needs you ou Idle. Un simple terminal apparaît comme Shell.
- Cliquez sur une session pour l'ouvrir dans une fenêtre de terminal (Windows Terminal s'il est installé). Fermez la fenêtre de terminal quand vous voulez : la session continue de tourner.
- New lance une session sur le PC : choisissez un agent installé, naviguez jusqu'au dossier où il doit travailler, et cliquez sur Start in this folder. Un terminal s'ouvre dessus, et elle apparaît aussi dans Bromure Agentic Coding sur le Mac.
- End this session (le bouton marche/arrêt qui apparaît au survol d'une ligne) l'arrête.
Depuis le Mac, une machine Sidecar fonctionne comme n'importe quelle autre : lancez-y une session, ouvrez son terminal, discutez avec une session Claude Code, ou déléguez-lui du travail. Les chemins s'affichent à la manière de Linux : votre dossier de profil Windows est /home/ubuntu, et D:\src devient /d/src.
Les agents survivent au Sidecar. Ils tournent dans un processus d'arrière-plan distinct : quitter Bromure Sidecar, ou installer une mise à jour, ne les arrête pas. Tant que le Sidecar est fermé, en revanche, le Mac ne peut pas les joindre ; il vous prévient si vous le quittez alors que des agents tournent. Redémarrer Windows, fermer votre session Windows ou désinstaller les arrête bel et bien.
Réglages
Ouvrez Settings depuis l'en-tête du volet :
- Start at login — lance le Sidecar à l'ouverture de votre session Windows, pour que les agents restent joignables après un redémarrage. Activé par défaut.
- Machine name — le nom sous lequel Bromure Agentic Coding liste ce PC. Videz-le pour revenir au nom par défaut (nom-de-l-ordinateur-native).
- SSH host key — l'empreinte de la clé d'hôte SSH de ce PC, avec un bouton de copie, pour la vérifier depuis le Mac.
- bromure.io account — le compte auquel le PC est connecté, et Sign out. Se déconnecter détache aussi le PC et en retire les clés du compte.
Le pied affiche la version du Sidecar et l'adresse de son serveur SSH (voir Sécurité).
Mises à jour
Le Sidecar cherche une nouvelle version deux minutes après son lancement, puis toutes les 12 heures. Quand il y en a une, le volet affiche « Bromure Sidecar version is available — Agents keep running while it installs. » Cliquez sur Update : le Sidecar télécharge le nouvel installeur, le vérifie et l'installe en silence. Le Sidecar redémarre tout seul quelques secondes plus tard ; les agents en cours ne sont pas interrompus.
Rien ne se met à jour sans que vous cliquiez sur Update. Vous pouvez aussi installer une nouvelle version à tout moment en lançant le dernier installeur depuis les liens de téléchargement par-dessus l'existant.
Désinstallation
Ouvrez Paramètres → Applications → Applications installées, trouvez Bromure Sidecar et choisissez Désinstaller. Si des agents tournent encore, le désinstalleur demande d'abord : « Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue? »
La désinstallation retire le programme, le raccourci du menu Démarrer, l'entrée de lancement à l'ouverture de session et le type de lien bromure-agent-host://. Elle conserve votre dossier de données, %LOCALAPPDATA%\BromureSidecar (connexion, réglages, journaux) : supprimez aussi ce dossier pour repartir de zéro. Pour retirer également le PC de votre compte bromure.io, déconnectez-vous (dans les réglages) avant de désinstaller.
Sécurité
- Connexions sortantes uniquement. Le PC n'ouvre aucun port sur le réseau. Son serveur SSH n'écoute que sur
127.0.0.1(port 2223), et le Mac le joint par le relais bromure.io auquel le PC se connecte lui-même. - Des clés, pas des mots de passe. Les connexions SSH se font uniquement par clé, et seulement pour votre propre nom d'utilisateur Windows. Les clés viennent des appareils de votre compte bromure.io ; le Sidecar les synchronise toutes les trois minutes, et les retire quand vous vous déconnectez.
- Approbation sur le Mac. Un Mac ne laisse un Sidecar se rattacher qu'après votre approbation sur ce Mac.
- Vos données restent les vôtres. Le dossier du Sidecar n'est lisible que par votre compte et par Windows lui-même.
- Logiciel signé. L'installeur et chaque programme qu'il contient sont signés par Seclio LLC et horodatés ; les mises à jour sont vérifiées par rapport au SHA-256 publié avant d'être exécutées.
- Pas de frontière réseau. Comme indiqué en haut, les machines natives n'ont pas les protections de passerelle des VM Linux. Traitez un Sidecar comme votre propre terminal, et choisissez les niveaux d'approbation des agents en conséquence.
La ligne de commande
bromure-sidecar.exe, dans le dossier d'installation, est l'outil en ligne de commande du Sidecar. Sa commande ctl parle au Sidecar en cours d'exécution :
| Commande | Ce qu'elle fait |
|---|---|
bromure-sidecar ctl health | Le Sidecar tourne-t-il ? |
bromure-sidecar ctl status | Version, nom de machine, compte, rattachement, port et empreinte SSH, agents en cours. |
bromure-sidecar ctl signin | Ouvre la page de connexion de bromure.io. |
bromure-sidecar ctl enroll <code-or-link> | Se connecter avec un code ou un lien copié (comme Paste link). |
bromure-sidecar ctl signout | Se déconnecter de bromure.io (détache aussi). |
bromure-sidecar ctl servers | Liste les serveurs du compte. |
bromure-sidecar ctl attach {"id":"<server-id>"} | Se rattacher à un serveur. |
bromure-sidecar ctl detach | Se détacher. |
bromure-sidecar ctl machine-name <name> | Renommer le PC. |
bromure-sidecar ctl install-state | L'état d'installation des agents. |
bromure-sidecar ctl quit | Arrêter le Sidecar (les agents continuent de tourner). |
bromure-sidecar claude | Lance Claude Code dans le dossier courant comme session Sidecar, et s'y attache ici. Appuyez sur Ctrl-B, puis D, pour la laisser tourner. |
bromure-sidecar version | Affiche la version. |
Dans PowerShell, mettez les arguments JSON entre apostrophes : bromure-sidecar ctl attach '{"id":"<server-id>"}'.
Fichiers et dossiers
| Chemin | Contenu |
|---|---|
%LOCALAPPDATA%\Programs\Bromure Sidecar | Les programmes. |
%LOCALAPPDATA%\BromureSidecar | Vos données : connexion, réglages, sessions, clés SSH. |
%LOCALAPPDATA%\BromureSidecar\settings.json | Les réglages, dont certains sans bouton : sshPort (2223 par défaut) et updateFeed (mettez-le à "" pour couper la recherche de mises à jour). Quittez et relancez le Sidecar après l'avoir modifié. |
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.log | Le journal. |
Dépannage
| Problème | Que faire |
|---|---|
| « Bromure Sidecar isn't running » | Lancez Bromure Sidecar depuis le menu Démarrer. Vos agents n'ont pas été arrêtés. |
| Bandeau « Git for Windows is needed », ou des commandes échouent avec « Git for Windows isn't installed on this machine » | Cliquez sur Install dans le bandeau (il lance winget install --id Git.Git -e --scope user), ou installez Git for Windows vous-même, puis réessayez. |
| « WebView2 isn't available » | Installez le Microsoft Edge WebView2 Runtime, puis relancez le Sidecar. |
| « that sign-in link wasn't started here — sign in again from the menu » | Cliquez sur Sign in to bromure.io et allez au bout de cette connexion ; voir Se connecter. |
| « This machine was removed from your bromure.io account. » | Le PC a été retiré sur bromure.io. Reconnectez-vous. |
| « Enrolled without the agent-host capability… » | Déconnectez-vous dans Settings, puis reconnectez-vous avec Sign in to bromure.io. |
| « No Bromure AC server is online in your account. » | Lancez Bromure Agentic Coding sur le Mac, connecté au même compte, avec l'accès à distance via bromure.io activé. |
| Bloqué sur Waiting for approval | Approuvez le PC sur le Mac, dans Bromure Agentic Coding. |
| Un agent dit qu'il n'est pas installé | Installez-le depuis Coding Agents. Si l'installeur a terminé mais que l'agent reste introuvable, cliquez sur Check again, ou fermez votre session Windows et rouvrez-la. |
| La vue Settings affiche « Couldn't start the SSH server » | Un autre programme utilise le port 2223. Indiquez un autre sshPort dans settings.json, puis quittez et relancez le Sidecar. |
| Autre chose | Quittez et relancez le Sidecar depuis le menu de l'icône (les agents continuent de tourner), puis consultez le fichier journal. bromure-sidecar ctl status montre l'état du Sidecar d'un seul coup. |