Bromure Sidecar für Windows
Bromure Sidecar macht einen Windows-PC zu einer nativen Maschine für Bromure Agentic Coding. Die Maschinen Ihres Macs sind Linux-VMs. Eine Sidecar-Maschine ist ein echter Windows-PC, der Coding-Agenten — Claude Code, Codex, Grok Build, Kimi Code, Oh My Pi — direkt unter Windows ausführt, in Ihrem eigenen Windows-Konto.
Sobald der PC beim selben bromure.io-Konto angemeldet ist wie Ihr Mac und an ihn angebunden ist, erscheint er in Bromure Agentic Coding als eine weitere Maschine. Seine Sitzungen erscheinen auf dem Mac neben denen, die in VMs laufen: Sie können sie vom Mac aus starten, beobachten, mit ihnen chatten und an sie delegieren. Sie können Sitzungen auch auf dem PC selbst starten, über das Infobereichssymbol des Sidecars.
PC und Mac sprechen Peer-to-Peer über bromure.io miteinander. Der PC baut nur ausgehende Verbindungen auf, es gibt also keinen Port weiterzuleiten, kein VPN und keine Adresse einzutippen.
Hinweis: Weil Agenten auf einem Sidecar direkt auf dem PC laufen, gehen sie nicht durch die Netzwerkgrenze einer Maschine. Squelch, das Einfügen von Zugangsdaten, das Tracing und die Sandbox-Richtlinie sind Funktionen von Maschinen (den Linux-VMs) und gelten nicht für eine native Maschine. Ein Sidecar-Agent hat die Zugriffsrechte Ihres Windows-Kontos; wählen Sie seine Freigabestufe entsprechend (siehe Freigabestufen).
Dieses Kapitel behandelt die Installation des Sidecars, das Anmelden und Anbinden, das Installieren von Agenten, Sitzungen, Einstellungen, Updates, die Deinstallation, die Befehlszeile und die Fehlerbehebung. Für die Mac-Seite des Fernzugriffs siehe Fernzugriff & Clients.
Voraussetzungen
| Windows | Windows 10 Version 1809 oder neuer, oder Windows 11. 64 Bit, auf Intel/AMD (x64) oder ARM (ARM64). |
| Git for Windows | Erforderlich: Agenten und die Befehle von Bromure Agentic Coding laufen unter Git Bash. Das Installationsprogramm bietet an, es zu installieren, wenn es fehlt. |
| Microsoft Edge WebView2 Runtime | Erforderlich für das Fenster des Sidecars. In Windows 11 enthalten; das Installationsprogramm bietet es an, wenn es fehlt. |
| Ein Konto | Ein bromure.io-Konto — das, bei dem das Bromure Agentic Coding Ihres Macs angemeldet ist. |
| Administratorrechte | Nicht nötig. Alles wird in Ihrem eigenen Konto installiert. |
Unter Windows 11 ab Version 22H2 nutzen die Fenster des Sidecars den durchscheinenden Windows-11-Stil; auf älteren Versionen sehen sie schlichter aus, funktionieren aber genauso.
Installation
Laden Sie das Installationsprogramm für Ihren PC herunter:
| PC | Download |
|---|---|
| Intel oder AMD (die meisten PCs) | BromureSidecar-x64.exe |
| ARM (zum Beispiel Snapdragon-Laptops) | BromureSidecar-arm64.exe |
Diese Links zeigen immer auf die neueste Version. Unsicher, welches Sie brauchen? Öffnen Sie Einstellungen → System → Info und sehen Sie unter Systemtyp nach: „x64-basierter Prozessor" bedeutet x64, „ARM-basierter Prozessor" bedeutet ARM64. Das ARM64-Installationsprogramm verweigert den Start auf einem x64-PC und sagt Ihnen das.
Führen Sie das Installationsprogramm aus. Es ist von Seclio LLC signiert, daher zeigt Windows diesen Herausgeber an. Dann:
- Fehlen Git for Windows oder die WebView2 Runtime, listet das Installationsprogramm sie als Komponenten auf. Lassen Sie sie angehakt, um sie mitzuinstallieren: Git kommt über winget, WebView2 von Microsoft. Sind beide schon vorhanden, wird diese Seite übersprungen.
- Das Installationsprogramm kopiert Bromure Sidecar nach
%LOCALAPPDATA%\Programs\Bromure Sidecar. - Lassen Sie auf der letzten Seite Start Bromure Sidecar angehakt.
Außerdem:
- legt das Installationsprogramm eine Verknüpfung Bromure Sidecar im Startmenü an;
- startet es den Sidecar, wenn Sie sich bei Windows anmelden;
- registriert es den Linktyp
bromure-agent-host://, über den bromure.io die Anmeldung an den PC zurückgibt; - fügt es einen Eintrag unter Einstellungen → Apps → Installierte Apps hinzu, zum Deinstallieren.
Das Infobereichssymbol und das Flyout
Bromure Sidecar lebt im Infobereich der Taskleiste. Sehen Sie sein Symbol nicht, klicken Sie auf den Pfeil ^; Sie können das Symbol auf die Taskleiste ziehen, damit es sichtbar bleibt.
Das Symbol zeigt den Zustand auf einen Blick:
| Symbol | Bedeutung |
|---|---|
| Grau | Der Sidecar läuft nicht, oder der PC ist an kein Bromure Agentic Coding angebunden. |
| Farbig | Angebunden. Fahren Sie mit der Maus darüber, um den Namen des Macs zu sehen, an den er angebunden ist. |
| Mit einem Punkt | Ein Agent braucht Sie: Er wartet auf eine Antwort oder eine Freigabe. |
Ein Linksklick auf das Symbol öffnet das Flyout, das Panel des Sidecars. Klicken Sie woanders hin oder drücken Sie Esc, um es zu schließen. Ein Rechtsklick öffnet ein Menü mit Open Bromure Sidecar, Coding Agents… und Quit Bromure Sidecar.
Das Flyout zeigt von oben nach unten:
- Die Kopfzeile: „Bromure Sidecar" und eine Statuszeile, etwa „Not signed in to bromure.io", „Signed in as pc-name" oder „Attached to Mac as pc-name". Ihre zwei Schaltflächen öffnen Coding agents und Settings.
- Banner, wenn sie zutreffen: „Git for Windows is needed" mit einer Schaltfläche Install, oder „Bromure Sidecar version is available" mit einer Schaltfläche Update.
- Die Verbindungskarte: anmelden oder an einen Mac anbinden.
- Sessions: die Agenten, die auf diesem PC laufen.
- Die Fußzeile: Coding Agents und Quit.
Bei bromure.io anmelden
Die Verbindungskarte des Flyouts zeigt Reach this PC from Bromure AC.
- Klicken Sie auf Sign in to bromure.io. Ihr Browser öffnet die Anmeldeseite von bromure.io.
- Melden Sie sich mit dem Konto an, das Ihr Mac verwendet, und bestätigen Sie das Hinzufügen dieses PCs.
- bromure.io gibt die Anmeldung über einen
bromure-agent-host://-Link an den Sidecar zurück; Ihr Browser fragt möglicherweise, ob Bromure Sidecar geöffnet werden soll. Erlauben Sie es.
Die Statuszeile wechselt zu „Signing in…" und dann zu „Signed in as pc-name".
Kann der Browser den Sidecar nicht öffnen (etwa weil Sie die Anmeldung auf einem anderen Computer abgeschlossen haben), kopieren Sie den bromure-agent-host://-Link von der Seite und klicken Sie im Flyout auf Paste link.
Sicherheit: Der Sidecar akzeptiert nur die Anmeldung, die er selbst gestartet hat. Ein
bromure-agent-host://-Link muss den Code der Anmeldung tragen, die Sie mit Sign in to bromure.io begonnen haben, ob er aus dem Browser kommt oder eingefügt wird; alles andere wird mit „that sign-in link wasn't started here — sign in again from the menu" abgelehnt. Das verhindert, dass eine Webseite oder eine Nachricht diesen PC in das Konto von jemand anderem schmuggelt. Sehen Sie diese Meldung, klicken Sie erneut auf Sign in to bromure.io und schließen Sie diese Anmeldung ab.
Der Maschinenname ist der Name, unter dem Bromure Agentic Coding diesen PC aufführt. Standardmäßig ist es der Computername gefolgt von -native; Sie können ihn in den Einstellungen ändern.
An Bromure Agentic Coding anbinden
Nach der Anmeldung listet die Verbindungskarte die Server Ihres Kontos auf: die Macs, deren Bromure Agentic Coding online ist, jeweils mit Online oder Offline und einer Schaltfläche Attach. Steht keiner da, heißt es „No Bromure AC server is online in your account": Öffnen Sie Bromure Agentic Coding auf Ihrem Mac (beim selben Konto angemeldet, mit eingeschaltetem Fernzugriff über bromure.io — siehe Fernzugriff & Clients).
Klicken Sie neben Ihrem Mac auf Attach:
- Die Karte zeigt Connecting.
- Beim ersten Mal zeigt sie Waiting for approval: „Allow this PC in Bromure AC's fleet dialog on Mac." Geben Sie den PC auf dem Mac frei, wenn Bromure Agentic Coding danach fragt.
- Die Karte zeigt Attached, und das Infobereichssymbol wird von grau zu farbig.
Der PC erscheint jetzt unter den Maschinen des Macs, unter Native Machines. Die Anbindung übersteht Neustarts: Der Sidecar verbindet sich beim nächsten Start von selbst wieder. Klicken Sie auf Detach, um sie zu beenden; der Mac vergisst diesen PC dann, bis Sie ihn erneut anbinden.
Schlägt das Anbinden fehl, sagt die Karte, warum:
- „Can't reach Mac" — der Mac ist offline oder nicht erreichbar.
- „Mac didn't accept this machine (is it up to date?)" — aktualisieren Sie Bromure Agentic Coding auf dem Mac.
- „Mac refused this machine" — der PC wurde auf dem Mac abgelehnt; der Sidecar versucht es nach zwei Minuten erneut.
Coding-Agenten
Der Sidecar bringt keinen Agenten mit. Öffnen Sie Coding Agents (die Schaltfläche im Flyout oder Coding Agents… im Menü des Symbols), um zu wählen, welche dieser PC ausführt:
| Agent | Hersteller | Anmerkungen |
|---|---|---|
| Claude Code | Anthropic | Voll integriert: Live-Status, Chat und Delegation in Bromure Agentic Coding. |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot AI | |
| Oh My Pi | Open Source |
Jede Karte zeigt den Status des Agenten (Installed · version, Not installed, Installing, Queued, Failed) und den genauen Befehl, den sein Installationsprogramm ausführt, mit einer Kopierschaltfläche.
- Install / Update führt das eigene Installationsprogramm des Agenten aus, heruntergeladen vom Hersteller, in Ihrem Konto, ohne Administratorrechte. Bromure bündelt oder hostet keinen davon. Installationen laufen nacheinander. Die meisten Agenten halten sich danach selbst aktuell.
- Sign in… meldet den Agenten bei seinem Anbieter an. Der Sidecar zeigt einen Einmalcode mit Copy und Open sign-in page; bei Claude Code fügen Sie den Code, den die Seite anzeigt, wieder ein und klicken auf Submit. „Agent: signed in" bestätigt es. (Oh My Pi hat hier keinen Anmeldeschritt.)
- Check again prüft erneut, was installiert ist, etwa nachdem Sie einen Agenten selbst installiert haben.
Freigabestufen
Jede Agentenkarte hat eine Freigabeeinstellung. Sie gilt für neue und fortgesetzte Sitzungen:
| Stufe | Was der Agent tut |
|---|---|
| Ask | Fragt, bevor er handelt — die Standardeinstellung des Agenten selbst. |
| Auto | Fragt nur, wenn eine Aktion riskant ist. Bei Codex: fragt nie, behält aber die eigene Sandbox von Codex. Bei Kimi Code: fragt nur, wenn nötig. |
| Full | Fragt nie, ohne Grenzen. |
Oh My Pi bietet nur Ask und Full.
Warnung: Auf einem Sidecar bedeutet Full, dass der Agent alles tun kann, was Ihr Windows-Konto kann, ohne zu fragen. Bevorzugen Sie Ask oder Auto, es sei denn, der PC ist den Agenten vorbehalten.
Sitzungen
Die Liste Sessions im Flyout zeigt jeden Agenten, der auf diesem PC läuft — vom Mac oder vom PC gestartet — mit Titel, Agent, Ordner und einem Status: Working, Needs you oder Idle. Ein einfaches Terminal erscheint als Shell.
- Klicken Sie auf eine Sitzung, um sie in einem Terminalfenster zu öffnen (Windows Terminal, wenn es installiert ist). Schließen Sie das Terminalfenster, wann immer Sie wollen: Die Sitzung läuft weiter.
- New startet eine Sitzung auf dem PC: Wählen Sie einen installierten Agenten, navigieren Sie zu dem Ordner, in dem er arbeiten soll, und klicken Sie auf Start in this folder. Ein Terminal öffnet sich darauf, und die Sitzung erscheint auch in Bromure Agentic Coding auf dem Mac.
- End this session (die Ein/Aus-Schaltfläche, die erscheint, wenn Sie über eine Zeile fahren) beendet sie.
Vom Mac aus funktioniert eine Sidecar-Maschine wie jede andere: Starten Sie darauf eine Sitzung, öffnen Sie ihr Terminal, chatten Sie mit einer Claude-Code-Sitzung oder delegieren Sie an sie. Pfade werden auf Linux-Art angezeigt: Ihr Windows-Profilordner ist /home/ubuntu, und D:\src ist /d/src.
Agenten überleben den Sidecar. Sie laufen in einem eigenen Hintergrundprozess: Bromure Sidecar zu beenden oder ein Update zu installieren hält sie nicht an. Solange der Sidecar beendet ist, kann der Mac sie allerdings nicht erreichen; er warnt Sie, wenn Sie ihn mit laufenden Agenten beenden. Windows neu zu starten, sich von Windows abzumelden oder zu deinstallieren hält sie dagegen an.
Einstellungen
Öffnen Sie Settings über die Kopfzeile des Flyouts:
- Start at login — startet den Sidecar, wenn Sie sich bei Windows anmelden, damit Agenten nach einem Neustart erreichbar bleiben. Standardmäßig an.
- Machine name — der Name, unter dem Bromure Agentic Coding diesen PC aufführt. Leeren Sie das Feld, um zum Standard zurückzukehren (computername-native).
- SSH host key — der Fingerabdruck des SSH-Hostschlüssels dieses PCs, mit einer Kopierschaltfläche, um ihn vom Mac aus zu prüfen.
- bromure.io account — als wer der PC angemeldet ist, und Sign out. Das Abmelden bindet den PC auch ab und entfernt die Schlüssel des Kontos von ihm.
Die Fußzeile zeigt die Version des Sidecars und die Adresse seines SSH-Servers (siehe Sicherheit).
Updates
Der Sidecar sucht zwei Minuten nach dem Start nach einer neuen Version und danach alle 12 Stunden. Gibt es eine, zeigt das Flyout „Bromure Sidecar version is available — Agents keep running while it installs." Klicken Sie auf Update: Der Sidecar lädt das neue Installationsprogramm herunter, prüft es und installiert es im Hintergrund. Der Sidecar startet einige Sekunden später von selbst neu; laufende Agenten werden nicht unterbrochen.
Nichts wird aktualisiert, ohne dass Sie auf Update klicken. Sie können eine neue Version auch jederzeit installieren, indem Sie das neueste Installationsprogramm von den Download-Links über das vorhandene ausführen.
Deinstallation
Öffnen Sie Einstellungen → Apps → Installierte Apps, suchen Sie Bromure Sidecar und wählen Sie Deinstallieren. Laufen noch Agenten, fragt das Deinstallationsprogramm zuerst: „Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?"
Die Deinstallation entfernt das Programm, die Startmenü-Verknüpfung, den Autostart-Eintrag und den Linktyp bromure-agent-host://. Ihr Datenordner %LOCALAPPDATA%\BromureSidecar (Anmeldung, Einstellungen, Protokolle) bleibt erhalten: Löschen Sie auch diesen Ordner für einen Neuanfang. Um den PC auch aus Ihrem bromure.io-Konto zu entfernen, melden Sie sich vor dem Deinstallieren ab (in den Einstellungen).
Sicherheit
- Nur ausgehend. Der PC öffnet keinen Port zum Netzwerk. Sein SSH-Server lauscht nur auf
127.0.0.1(Port 2223), und der Mac erreicht ihn über das bromure.io-Relay, zu dem der PC selbst die Verbindung aufbaut. - Schlüssel, keine Passwörter. SSH-Anmeldungen erfolgen nur per Schlüssel und nur für Ihren eigenen Windows-Benutzernamen. Die Schlüssel stammen von den Geräten Ihres bromure.io-Kontos; der Sidecar gleicht sie alle drei Minuten ab und entfernt sie, wenn Sie sich abmelden.
- Freigabe auf dem Mac. Ein Mac lässt einen Sidecar erst anbinden, nachdem Sie ihn dort freigegeben haben.
- Ihre Daten bleiben Ihre. Der Ordner des Sidecars ist nur für Ihr Konto und Windows selbst lesbar.
- Signierte Software. Das Installationsprogramm und jedes Programm darin sind von Seclio LLC signiert und mit Zeitstempel versehen; Updates werden vor dem Ausführen gegen den veröffentlichten SHA-256 geprüft.
- Keine Netzwerkgrenze. Wie oben erwähnt, bekommen native Maschinen nicht die Gateway-Schutzfunktionen der Linux-VMs. Behandeln Sie einen Sidecar wie Ihr eigenes Terminal, und wählen Sie die Freigabestufen der Agenten entsprechend.
Die Befehlszeile
bromure-sidecar.exe im Installationsordner ist das Befehlszeilenwerkzeug des Sidecars. Sein Befehl ctl spricht mit dem laufenden Sidecar:
| Befehl | Was er tut |
|---|---|
bromure-sidecar ctl health | Läuft der Sidecar? |
bromure-sidecar ctl status | Version, Maschinenname, Konto, Anbindung, SSH-Port und -Fingerabdruck, laufende Agenten. |
bromure-sidecar ctl signin | Öffnet die Anmeldeseite von bromure.io. |
bromure-sidecar ctl enroll <code-or-link> | Mit einem kopierten Code oder Link anmelden (wie Paste link). |
bromure-sidecar ctl signout | Von bromure.io abmelden (bindet auch ab). |
bromure-sidecar ctl servers | Listet die Server des Kontos auf. |
bromure-sidecar ctl attach {"id":"<server-id>"} | An einen Server anbinden. |
bromure-sidecar ctl detach | Abbinden. |
bromure-sidecar ctl machine-name <name> | Den PC umbenennen. |
bromure-sidecar ctl install-state | Der Installationsstatus der Agenten. |
bromure-sidecar ctl quit | Den Sidecar beenden (Agenten laufen weiter). |
bromure-sidecar claude | Startet Claude Code im aktuellen Ordner als Sidecar-Sitzung und verbindet sich hier mit ihr. Drücken Sie Ctrl-B und dann D, um sie weiterlaufen zu lassen. |
bromure-sidecar version | Gibt die Version aus. |
Setzen Sie in PowerShell JSON-Argumente in einfache Anführungszeichen: bromure-sidecar ctl attach '{"id":"<server-id>"}'.
Dateien und Ordner
| Pfad | Was dort liegt |
|---|---|
%LOCALAPPDATA%\Programs\Bromure Sidecar | Die Programme. |
%LOCALAPPDATA%\BromureSidecar | Ihre Daten: Anmeldung, Einstellungen, Sitzungen, SSH-Schlüssel. |
%LOCALAPPDATA%\BromureSidecar\settings.json | Die Einstellungen, darunter einige ohne Schaltfläche: sshPort (Standard 2223) und updateFeed (setzen Sie ihn auf "", um die Update-Suche abzuschalten). Beenden und starten Sie den Sidecar nach dem Bearbeiten neu. |
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.log | Das Protokoll. |
Fehlerbehebung
| Problem | Was zu tun ist |
|---|---|
| „Bromure Sidecar isn't running" | Starten Sie Bromure Sidecar über das Startmenü. Ihre Agenten wurden nicht angehalten. |
| Banner „Git for Windows is needed", oder Befehle scheitern mit „Git for Windows isn't installed on this machine" | Klicken Sie im Banner auf Install (es führt winget install --id Git.Git -e --scope user aus), oder installieren Sie Git for Windows selbst, und versuchen Sie es erneut. |
| „WebView2 isn't available" | Installieren Sie die Microsoft Edge WebView2 Runtime und starten Sie den Sidecar erneut. |
| „that sign-in link wasn't started here — sign in again from the menu" | Klicken Sie auf Sign in to bromure.io und schließen Sie diese Anmeldung ab; siehe Bei bromure.io anmelden. |
| „This machine was removed from your bromure.io account." | Der PC wurde auf bromure.io entfernt. Melden Sie sich erneut an. |
| „Enrolled without the agent-host capability…" | Melden Sie sich in Settings ab und dann mit Sign in to bromure.io erneut an. |
| „No Bromure AC server is online in your account." | Starten Sie Bromure Agentic Coding auf dem Mac, beim selben Konto angemeldet, mit eingeschaltetem Fernzugriff über bromure.io. |
| Hängt bei Waiting for approval | Geben Sie den PC auf dem Mac frei, in Bromure Agentic Coding. |
| Ein Agent sagt, er sei nicht installiert | Installieren Sie ihn über Coding Agents. Ist das Installationsprogramm fertig, der Agent aber weiterhin nicht zu finden, klicken Sie auf Check again, oder melden Sie sich von Windows ab und wieder an. |
| Die Ansicht Settings zeigt „Couldn't start the SSH server" | Ein anderes Programm nutzt Port 2223. Setzen Sie in settings.json einen anderen sshPort, beenden Sie dann den Sidecar und starten Sie ihn neu. |
| Alles andere | Beenden und starten Sie den Sidecar über das Menü des Symbols neu (Agenten laufen weiter), und sehen Sie sich dann die Protokolldatei an. bromure-sidecar ctl status zeigt den Zustand des Sidecars auf einen Blick. |