Bromure Agentic Coding — Benutzerhandbuch

Willkommen zum offiziellen Benutzerhandbuch von Bromure Agentic Coding, der macOS-App, die KI-Coding-Agenten — Claude Code, Codex, Grok, Kimi Code, Oh My Pi und gewöhnliches Shell-Werkzeug — in isolierten Linux-VMs auf Ihrem Mac laufen lässt, mit einem Gateway auf der Host-Seite, das Ihre echten Zugangsdaten außer Reichweite des Agenten hält.

Dieses Handbuch beschreibt Version 5.0.0. Sie verlangt macOS 14 (Sonoma) oder neuer auf Apple Silicon.

Version 5.0.0 ist um Sitzungen herum gebaut: jedes Gespräch mit einem Agenten ist eine Zeile in der Seitenleiste, und Sie reden in einem Chat mit ihm. Die Linux-VMs, in denen Sitzungen laufen, heißen im Hauptfenster Maschinen. Der Einstellungseditor nennt sie noch Arbeitsbereiche; die beiden Wörter bedeuten dasselbe.

Neu in der App? Beginnen Sie mit Installation & erster Start und folgen Sie dann dem Schnellstart. Lesen Sie Konzepte & Architektur, wenn Sie das ganze Bild wollen. Alles Übrige ist Referenz.

Inhalt

Erste Schritte

Kapitel	Was es behandelt
1. Einführung	Was die App ist, das Sicherheitsmodell mit einer einzigen Grenze, die wichtigsten Funktionen, und wie sie sich zu anderen Werkzeugen verhält.
2. Installation & erster Start	Systemvoraussetzungen, die App installieren, der Einrichtungsassistent in sechs Schritten, Basis-Image-Aktualisierungen, das Kommandozeilenwerkzeug, Speicher, der Umzug auf einen neuen Mac, und Deinstallieren.
3. Schnellstart	Vom Assistenten zu einer fertigen Aufgabe: eine Sitzung starten, die Frage des Agenten beantworten, die geänderten Dateien ansehen, den Trace prüfen, dann die Sitzung archivieren und zurückholen.
4. Konzepte & Architektur	Sitzungen, Maschinen, Räume und Branches; Sitzungszustände; Host und Gast; die Übertragungsgrenze; was bleibt; die vsock- und MCP-Ports; das Netzwerk.

Im Alltag

Kapitel	Was es behandelt
5. Die Sitzungsübersicht	Das Hauptfenster: die Seitenleiste und ihre eingeklappte Schiene, Sitzungszeilen und ihre Menüs, die Sitzungs-Kopfzeile, das Maschinen-Menü, die Linux-Kapsel, die ⌘K-Befehlspalette, und Archivieren, Beenden, Löschen und Widerrufen.
6. Eine Sitzung starten	Der Neue-Sitzung-Bildschirm: den Agenten, die Maschine und den Arbeitsort wählen (einen neuen Ordner, einen Ihrer eigenen, oder ein Repository), Dateien anhängen, die letzten Starts, und eine andere Sitzung mit @ fragen.
6.1 Der Chat	Mit einem Agenten reden: das Eingabefeld, Anhänge, Slash-Befehle und das Terminal in der Zeile, Fragekarten, Aktivitätszeilen, Zusammenfassungen geänderter Dateien, Anmeldekarten, Anhalten, Bearbeiten und erneut Senden, und die Suche.
6.2 Räume	Verwandte Sitzungen in einem Raum bündeln: das Raster lebender Chats, Layouts und Tabs, in eine Zelle zoomen, die eigene Schaltzentrale des Raums, und an den ganzen Raum senden.
6.3 Branches und Review	Branch-Sitzungen auf ihrer eigenen git-Worktree, sie zurückführen, das Branches-Fenster, und das Review-Fenster mit Zeilenkommentaren.
6.4 Agenten arbeiten zusammen	Delegation an Kind-Sitzungen, Anfragen an andere Sitzungen per @Kurzname, das Delegationen-Panel, die Dateiübergabe, die Grenzen, und Anfragen über Maschinen hinweg.
6.5 Schaltzentrale und Messaging	Die Schaltzentralen-Sitzung, die jede andere Sitzung im Blick hat, ihre Sicherheitsregeln, und der Messaging-Konnektor für Signal, WhatsApp und Slack.
6.6 Maschinen	Der Abschnitt Virtuelle Maschinen: Maschinen anlegen, starten, anhalten und löschen, Home zurückdrehen und Platte zurücksetzen, Terminals und das Raster, der Dateien-Bereich, und die Zwischenablage.
6.7 Der eingebettete Browser	Der Chromium-Browser neben einer Sitzung: ihn selbst steuern, den Agenten ihn über die Browser-Werkzeuge steuern lassen, angemeldet bleiben, und Privatsphäre.
Metal-Beschleunigung in Bromure Web	Die eigenständige Web-App: Metal-Voraussetzungen, app-weite und profilbezogene Steuerung, aktiver Renderer und Videounterstützung.
6.8 Automatisierungen	Geplante, unbeaufsichtigte Agenten-Läufe auf einer Kanban-Tafel: Auslöser, Zeitpläne, Ketten, Laufverlauf, ihre Fragen beantworten, und der Automatisierungs-MCP-Server.
6.9 Coding-Aufgaben	Das Coding-Kanban: Aufgaben, vom Agenten geplante Phasen, autonome Läufe in Worktrees, Review mit Zeilenkommentaren, und Merges.

Einstellungsreferenz

Kapitel	Was es behandelt
7. Einstellungsreferenz	Wie man den Einstellungseditor und die Einstellungen öffnet, die gruppierte Bereichsliste und Einstellungen suchen, die Vorlage Standardwerte, und was wann sichert.

Die Einstellungsreferenz hat eine Seite je Bereich, in der Reihenfolge des Editors:

Arbeitsbereich: Allgemein, Darstellung
Modelle: Modelle, Fusion, Squelch
Maschine: Ordner, Umgebung, MCP, Browser, Ressourcen
Sicherheit: Zugangsdaten, Tracing, Schutzmechanismen, Lieferkette, Prompt-Injection, Schutz personenbezogener Daten
App (nur in den Einstellungen): Automatisierung

Sicherheit und die Übertragungsgrenze

Kapitel	Was es behandelt
8. Zugangsdaten & die Übertragungsgrenze	Wie echte Geheimnisse auf dem Host bleiben, während der Agent nur Stellvertreter bekommt: der MITM-Proxy, Anmeldungen und API-Schlüssel, Zustimmungen je Zugangsmittel, und der Kompromittierungs-Alarm.
9. Lieferketten-Schutz	Paketinstallationen prüfen, umschreiben und blockieren, bevor der Agent sie sieht: die Alterssperre, OSV, socket.dev, Depi, und das Entfernen von Installationsskripten.
10. Prompt-Injection-Erkennung & Schutzmechanismen	Erkenner auf dem Gerät, die den KI-Verkehr des Agenten nach eingeschobenen Anweisungen durchsuchen, die Egress-Firewall, und Schutzmechanismen für zerstörende Operationen.
10.5 Schutz personenbezogener Daten	Personenbezogene Daten gegen gleichbleibende Stellvertreter tauschen, bevor ein Gespräch Ihren Mac verlässt, und sie in den Antworten wiederherstellen.
11. Tracing & Audit	Was ein Sitzungs-Trace aufzeichnet, der Trace-Inspektor, Verschlüsselung im Ruhezustand, Aufbewahrung, Export, und Privatsphäre.
11.5 Sicherheitsübersicht und Zeitleiste	Das Fenster Sicherheits-Zeitleiste: die 24-Stunden-Übersicht, die Schutzmechanismen je Maschine, und die filterbare, exportierbare Zeitleiste jeder Sicherheitsentscheidung.

Modelle & Infrastruktur

Kapitel	Was es behandelt
12. Fusion — das Multi-Modell-Panel	Jeden Prompt mit mehreren Modellen zugleich beantworten, beurteilt und auf der Leitung zu einer einzigen Antwort zusammengeführt.
12.5 Squelch — weniger Rauschen, weniger Tokens	Bestandene Tests, Fortschrittsanzeigen und anderes Rauschen aus der Befehlsausgabe entfernen, bevor das Modell sie liest (nach dem Vorbild von rtk), und die pro Sitzung eingesparten Tokens.
13. Modelle & Anbieter	Die globale Modelle-Tafel: Anbieter (Anmeldungen, API-Schlüssel, Amazon Bedrock, OpenRouter, eigene Server, Modelle auf dem Gerät), Modellwahl je Agent, Übersteuerungen je Arbeitsbereich, und Änderungen im Betrieb.
13.5 Kubernetes-Cluster und Registries	k3s-Cluster und eine private Container-Registry in eigenen VMs neben Ihren Maschinen laufen lassen: Speicher, Lastverteilung, Add-ons, Zugang, und der Infrastruktur-MCP-Server.

Über einen Mac hinaus

Kapitel	Was es behandelt
14. Fernzugriff & der Rich Client	Ein entferntes Bromure von einem anderen Mac, iPhone, iPad oder Apple Vision Pro spiegeln; Fern-Einstellungen; die CLI über SSH, Tunnel und PAC; und das Sicherheitsmodell der Ferne.
15. Enterprise — Registrierung & Flotte	Bei bromure.io registrieren, was die Telemetrie hochlädt (und was nicht), die Flottenansicht, und das Abmelden.

Referenz

Kapitel	Was es behandelt
16. CLI, API & MCP	Das Kommandozeilenwerkzeug `bromure-cli`, die Loopback-Steuer-API, die MCP-Server, und AppleScript.
16.5 Erweitert	Werkzeuge für Fortgeschrittene: der ext4-Dateibrowser und die Dateisystemprüfung, und das Home einer Maschine wiederherstellen oder zurückdrehen.
17. Fehlerbehebung	Probleme bei Einrichtung, Maschine, Anmeldung, TLS, Lieferkette, Plattenplatz und Fernzugriff diagnostizieren, nach Symptom geordnet.
18. Glossar	Definitionen jedes in diesem Handbuch benutzten Begriffs.
19. Anhang — Dateispeicherorte, Ports & Umgebung	Referenztabellen: Orte auf der Platte, Netzwerk- und vsock-Ports, Umgebungsvariablen, Voreinstellungen, Tastaturkürzel, und der Gast-Spickzettel.

Konventionen in diesem Handbuch

Fetter Text nennt ein Steuerelement oder eine Beschriftung auf dem Bildschirm genau so, wie die App sie auf Englisch zeigt — eine Schaltfläche, einen Menüeintrag, einen Schalter, einen Bereich oder einen Abschnitt der Seitenleiste (zum Beispiel New session oder Start this VM at login).
Nichtproportionaler Text ist ein Befehl, ein Dateipfad, eine Umgebungsvariable oder ein wörtlicher Wert, den Sie tippen oder sehen (zum Beispiel bromure-cli vm ls oder ~/Library/Application Support/BromureAC).
Ein Pfad wie Workspaces › Infrastructure › Messaging Connector… ist ein Menüpfad: das Menü, dann jedes Untermenü oder Element der Reihe nach. Einstellungen › Modelle meint den Bereich Modelle des Einstellungsfensters.
Maschine und Arbeitsbereich bedeuten dasselbe: eine isolierte Linux-VM mit ihren Einstellungen. Das Hauptfenster sagt Maschine; der Einstellungseditor, Menüs wie New Workspace… und die CLI sagen Arbeitsbereich (oder Profil).
Eine Sitzung ist ein Gespräch mit einem Agenten, in einem Ordner, auf einer Maschine. Sie ist kein Lauf einer Maschine; siehe Konzepte & Architektur.
Tastaturkürzel benutzen die macOS-Symbole: ⌘ Befehl, ⌥ Option, ⌃ Control, ⇧ Umschalt, ⏎ Return, ⎋ Escape.
Bildschirmfotos zeigen die englische Oberfläche mit erfundenen Demo-Inhalten. Die App ist lokalisiert, Ihre Bildschirme folgen also der Sprache Ihres macOS.
Hinweise, Tipps und Warnungen erscheinen als Auszeichnungen:

Hinweis: Hintergrundwissen, das gut zu kennen ist.

Tipp: Eine Abkürzung oder eine empfohlene Vorgehensweise.

Warnung: Etwas, das Daten verlieren oder einen Schutz schwächen kann, wenn Sie es falsch machen.

Wo man sonst nachschaut

Produkt-Downloads, das technische Whitepaper und die ausführliche Funktionsmatrix stehen auf bromure.io. Für Fragen, die dieses Handbuch nicht beantwortet, sammelt Fehlerbehebung die Diagnoseverfahren, und das Glossar erklärt das Vokabular.