Das SideBrain-Handbuch

Überblick

SideBrain macht aus Dokumenten, Mails und Notizen befragbares Wissen — lokal auf dem Mac, an eurem eigenen KI-Endpunkt.

SideBrain besteht aus drei Teilen, die zusammen als eine App ausgeliefert werden:

• Die App — Menüleisten-Symbol, Übersicht, Brain-Explorer, Chat und die Fenster für Schnellnotiz, Frage-Overlay und Terminbegleitung.
• Die Engine — verarbeitet jede eingespeiste Datei: Text extrahieren, per KI Titel/Typ/Datum bestimmen, Vorschau erzeugen, ins Brain schreiben. Läuft mit einer mitgelieferten Python-Laufzeit; nichts muss nachinstalliert werden.
• Das Brain (gbrain) — der Wissensspeicher. Wahlweise vollständig lokal auf dem Mac (PGLite, ohne Server) oder als Remote-Endpunkt, den sich ein Team teilt. Inhalte liegen als Markdown-Seiten mit Typen, Tags und Verknüpfungen vor.

Kernbegriffe

Brain

Ein Wissensspeicher (gbrain-Endpunkt). Es können mehrere Brains parallel hinterlegt sein — z. B. ein privates lokales und ein geteiltes Projekt-Brain.

Push

Der Vorgang, Inhalt ins Brain zu übernehmen: Datei einspeisen → Extraktion → Vorschau → Bestätigung → gespeichert.

Notiz / Seite

Eine Einheit im Brain: Markdown-Inhalt plus Typ, Titel, Tags, Datum und Verknüpfungen. Adressiert über einen stabilen Slug.

Typ

Kanonische Kategorien wie person, company, deal, event, project, note, email, source — von der KI vorgeschlagen, in der Vorschau überstimmbar.

Think

Eine Frage an das Brain: relevante Notizen werden gesucht, nachsortiert und dem KI-Modell als Kontext gegeben; die Antwort zitiert ihre Quellen.

KI-Profil

Der hinterlegte Modell-Zugang (Anbieter, Endpunkt, Schlüssel), mit dem Extraktion und Antworten arbeiten.

Sprache der Oberfläche

SideBrain spricht Deutsch, Englisch, Französisch, Italienisch und Spanisch. Die Systemsprache des Mac wird automatisch erkannt (fr-*, it-*, es-* wählen die passende Sprache; jede andere Nicht-Deutsch-Sprache bleibt Englisch) — der Sprachumschalter in den Einstellungen wechselt jederzeit manuell und sofort, ohne Neustart. Menüleisten-Tray und die schwebenden Zweitfenster (Schnellnotiz, Kontext-Chip, Terminbegleitung) folgen einer expliziten Sprachwahl; systemseitige Benachrichtigungen (Rückblick, fällige Punkte, geplante Berichte) bleiben unverändert Deutsch.

Installation & Einrichtung

SideBrain bringt seine komplette Laufzeit mit — kein Python, keine Abhängigkeiten.

macOS: Per Disk-Image

SideBrain.dmg laden, öffnen, SideBrain in den Programme-Ordner ziehen, starten. Da die App ohne Apple-Notarisierung ausgeliefert wird, verlangt macOS beim allerersten Start einen Rechtsklick → „Öffnen" (Gatekeeper).

macOS: Per Terminal

Ein Befehl lädt und installiert die aktuelle Version — der Gatekeeper-Umweg entfällt dabei automatisch:

curl -fsSL https://dl.sidebrain.eu/install.sh | bash

Voraussetzung: ein Mac mit Apple Silicon (M1 oder neuer). Dieses Terminal-Skript deckt nur macOS ab — eine Windows-Version (x86_64) ist verfügbar (siehe Windows-Abschnitt unten). Intel-Macs und Linux sind derzeit nicht terminiert.

macOS: Per Homebrew

Wer Homebrew nutzt, installiert SideBrain aus dem eigenen Tap — Updates kommen danach wie gewohnt mit brew upgrade:

brew install --cask m-dohmen/sidebrain/sidebrain

Da SideBrain ohne Apple-Notarisierung ausgeliefert wird, setzt Homebrew die App beim Download unter Quarantäne — beim allerersten Start verlangt macOS daher einmalig einen Rechtsklick → „Öffnen" (Gatekeeper). Wer diesen Schritt überspringen möchte, installiert mit brew install --cask --no-quarantine m-dohmen/sidebrain/sidebrain. Ab dann hält der eingebaute Auto-Updater die App aktuell.

Windows (x86_64): Per Installer

Für Windows 10 (ab 1809) und Windows 11 steht ein eigener, Authenticode-signierter NSIS-Installer bereit. Installer laden, doppelklicken, den NSIS-Wizard durchklicken (Standardpfad %LOCALAPPDATA%\Programs\SideBrain, installMode: currentUser — kein Admin, keine UAC-Abfrage nötig). Der erste Start erfordert je nach Rechner-Konfiguration ein einmaliges SmartScreen-Vertrauensbekenntnis („Weitere Informationen" → „Trotzdem ausführen") — bei signierter, aber nicht im SmartScreen-Reputation-Index aufgenommener Software normal.

Aktualisierung: Der eingebaute Auto-Updater prüft beim Start den Feed https://dl.sidebrain.eu/latest.json (Schlüssel platforms.windows-x86_64), verifiziert die Signatur und spielt neue Versionen automatisch ein. Manuelle Aktualisierung: einfach die jeweils aktuelle .exe erneut laden und durchklicken — SideBrain ersetzt die Vorversion ohne Datenverlust.

Bekannte Einschränkungen unter Windows

Der Windows-Port teilt die Kernfunktionen mit macOS und Linux. Damit klar ist, was funktioniert und was nicht, blendet die App pro plattformspezifischer Quelle eine ehrliche Verfügbarkeitsmeldung ein, statt einen stillen Fehler oder einen toten Knopf ohne Erklärung zu zeigen:

• iPhone-Erfassung (iCloud-Ordner als Watch-Folder): Auf Windows dockt der „iPhone-Erfassung einrichten"-Knopf an genau dieselbe Watch-Folder-Pipeline an wie auf macOS — statt des macOS-iCloud-Containers wird der iCloud-für-Windows-Ordner %USERPROFILE%\iCloudDrive überwacht. Ist iCloud für Windows nicht installiert, meldet die App das ehrlich („iCloud für Windows ist nicht installiert — Installiere es über den Microsoft Store und melde dich mit deiner Apple-ID an") statt einen Fehler zu schlucken.
• Terminbegleitung („Termin begleiten"): macOS-only — hängt an Calendar.app und macOS-Audio. Auf Windows v1 ohne Äquivalent; der Knopf in der Übersicht ist ausgegraut und verweist im Tooltip auf Screenshots und Freitextnotizen als Alternative. Ein Windows-Meeting-Recorder ist als eigenes Vorhaben vorgesehen, nicht Teil dieses Releases.

Ersteinrichtung (Onboarding)

Beim ersten Start führt ein Assistent in vier Schritten durch die Einrichtung — Willkommen · Dein Brain · KI · Erster Push:

1. Dein Brain: „Auf diesem Mac" richtet ein lokales Brain ein (empfohlen für den Einstieg; installiert gbrain samt Laufzeit). Alternativ verbindet „Remote-Brain" einen bestehenden Team-Endpunkt über URL und Token.
2. Lokale Suche (empfohlen, abwählbar): Beim lokalen Brain wird auf Wunsch eine vollständig lokale semantische Suche eingerichtet — ein gebündelter llama-server mit mehrsprachigem Embedding-Modell (bge-m3) und Reranker, einmalig ~880 MB Download.
3. KI: Vier Stufen zur Wahl:
   • Eigener Anthropic-Schlüssel — beste Qualität, direkter Claude-Zugang.
   • Kostenlos starten — Ein-Klick-Anmeldung bei OpenRouter oder LLM Gateway; freie Modelle fürs Antworten, ohne eigene Kosten.
   • Komplett offline — das mitgelieferte lokale Modell (einmalig ~3,2 GB) beantwortet Fragen vollständig auf dem Mac. Gut für klare Fakten-Fragen, spürbar langsamer (~3–4 s je Antwort) und komplexen Abwägungen eines Cloud-Modells unterlegen — der Assistent sagt das ehrlich dazu.
   • Ohne Schlüssel starten — erst einmal nur sammeln; KI-Funktionen lassen sich jederzeit nachrüsten.
4. Erster Push: eine Datei hineinziehen, Vorschau prüfen, übernehmen — fertig.

Wurde die Einrichtung übersprungen oder ist später kein nutzbares Brain hinterlegt, bietet SideBrain die geführte Einrichtung beim Start erneut an.

Updates

SideBrain aktualisiert sich selbst: Der eingebaute Updater prüft gegen dl.sidebrain.eu, lädt signierte Update-Archive und installiert sie nach Bestätigung. Jede Version ist zusätzlich als DMG im Download-Archiv verfügbar.

Deinstallation

Einstellungen → „SideBrain entfernen" löscht die App vollständig — inklusive Finder-Schnellaktion, Diensten und Einstellungen. Die Brain-Daten bleiben auf Wunsch erhalten und lassen sich vorher als ZIP exportieren.

Wissen erfassen

Jede Erfassungsquelle mündet in dieselbe Pipeline: Validierung → Extraktion → Plausibilisierung → Vorschau → Push. Keine Sonderwege, überall dasselbe verlässliche Verhalten.

Unterstützte Formate

• Dokumente: PDF, Word, Excel, PowerPoint, Keynote, Pages, Markdown, reine Textdateien
• E-Mails: .eml-Dateien (z. B. aus Mail/Outlook gezogen) — Betreff, Absender und Datum werden erkannt
• Bilder: Screenshots und Fotos mit Textinhalt (Vision-Extraktion transkribiert und ordnet ein)
• Audio: m4a, mp3, wav — lokal transkribiert
• Web: URLs — der Seitentext wird ausgelesen und als zitierbare Quelle abgelegt
• Freitext: über die Schnellnotiz oder das Teilen-Menü

Push-Vorschau & Bestätigung

Vor jedem Push zeigt SideBrain, was gespeichert würde — nichts landet ungeprüft im Brain:

• Titel, Typ und Datum schlägt die KI aus dem Inhalt vor (statt „Bild (3)" ein sprechender Titel; statt Push-Datum das eigentliche Dokumentdatum). Der Typ ist per Umschalter überstimmbar.
• Herkunft je Feld: Typ, Name und Wichtig-Markierung lassen sich per Hover oder Tastatur-Fokus zur belegenden Stelle im Text springen — so ist auf einen Blick nachvollziehbar, woraus die KI eine Zuordnung abgeleitet hat. Findet sich keine eindeutige Stelle, steht ehrlich „nicht sicher zuordenbar" statt einer geratenen Markierung.
• Inhalt bearbeiten: Der extrahierte Text lässt sich vor der Übernahme direkt korrigieren.
• Kontext-Feld: Ein Satz eigener Einordnung („gehört zu Projekt Nordstern") wird mitgespeichert.
• Wichtig-Stern: Markiert die Notiz als prioritär — bei Entscheidungen und Deadlines von der KI vorbelegt. Wichtige Notizen werden in der Relevanz-Gewichtung des Brains bevorzugt.
• Ziel-Brain ad-hoc wechseln: Bei mehr als einem konfigurierten Verbund-Brain zeigt die Vorschau neben Typ und Wichtig-Stern das aktuelle Ziel-Brain und erlaubt den Wechsel auf ein anderes — per Maus oder Tastatur. Der gewählte Wert gilt nur für diesen einen Push; Standard-Push-Ziel und der Ordner-Router bleiben unverändert und greifen bei der nächsten Datei wieder. Bei nur einem konfigurierten Brain bleibt der Umschalter ausgeblendet.
• Überspringen verwirft den Push; bei aktiviertem Auto-Push wird die Vorschau nach Ablauf einer einstellbaren Frist automatisch übernommen.

Überwachte Ordner (Watch-Folders)

Beliebige Ordner lassen sich überwachen — jede dort abgelegte Datei wird automatisch eingespeist. Standardmäßig ist ~/SideBrain Inbox eingerichtet.

• Mit Bestätigung (Standard): Die Datei durchläuft die normale Vorschau.
• Auto-Push: Die Datei wird ohne Nachfrage direkt übernommen — für Ordner, in die ohnehin nur Gewolltes wandert.
• Ziel-Brain je Ordner: Bei mehreren Brains lässt sich pro Ordner ein abweichendes Ziel wählen — „alles aus diesem Ordner geht ins Team-Brain, der Rest bleibt lokal". Ordner mit unterschiedlichen Zielen laufen als getrennte Sessions, damit jede Datei sicher beim richtigen Brain landet.

Schnellnotiz ⌥ N & Screenshot

Das Menüleisten-Symbol (und das Kürzel ⌥ N) öffnet ein kleines schwebendes Fenster für den Gedanken zwischendurch — Text eintippen, Enter, gespeichert. „Bildschirmausschnitt …" im Menü startet die interaktive Bereichsauswahl von macOS; der Screenshot durchläuft danach die normale Vision-Extraktion samt Vorschau.

Sprachmemos (Audio-Dateien)

m4a-, mp3- und wav-Dateien werden wie jede andere Datei gepusht: SideBrain transkribiert sie zuerst vollständig lokal (mitgeliefertes Voxtral-Modell, gleiche Infrastruktur wie die Termin-Mitschrift) und schickt dann den Text durch die normale Pipeline. Eine strenge Transkriptions-Anweisung stellt sicher, dass wortgetreu übertragen statt zusammengefasst wird — Zahlen und Anweisungen im Audio bleiben unangetastet. Kein Audio verlässt den Mac.

Voraussetzung: das lokale Sprachmodell ist installiert (einmalig ~3,2 GB, siehe Termin-Mitschrift). Ohne Modell meldet der Push den Grund statt still zu scheitern.

iPhone-Erfassung

Einstellungen → Überwachte Ordner → „iPhone-Erfassung einrichten" legt einen Ordner SideBrain-Erfassung in iCloud Drive an und überwacht ihn. Zusammen mit einem einmalig angelegten Apple-Kurzbefehl (Teilen-Menü → Datei in diesen Ordner sichern) landen Fotos, Links, Texte und Sprachmemos vom iPhone automatisch im Brain — Sprachmemos inklusive lokaler Transkription. Die Schritt-für-Schritt-Anleitung für den Kurzbefehl liegt der App bei.

Weitere Erfassungswege

Finder-Schnellaktion

Rechtsklick auf jede Datei → „SideBrain". Kein Öffnen, kein Ziehen nötig.

Drag & Drop

Dateien ins Hauptfenster, ins Chat-Fenster (dort additiv, ohne Vorschau-Dialog) oder ins Termin-Fenster ziehen.

Dienste-Menü „An SideBrain senden"

Markierten Text oder Link in jeder App → Rechtsklick → Dienste → „An SideBrain senden". Eine reine URL (auch in Anführungszeichen, spitzen Klammern oder mit Satzzeichen am Ende markiert) wird als Link-Notiz mit ausgelesenem Seiteninhalt gepusht; alles andere als Schnellnotiz. Rückmeldung per Mitteilung — kein Fenster unterbricht den Fluss.

Drucken → SideBrain

Aus jeder App per Druckdialog als PDF-Notiz sichern — auch dort, wo es keinen Export gibt.

Doppelklick / „Öffnen mit"

SideBrain ist als Ziel für PDFs registriert.

URL-Schema

sidebrain://push?path=… pusht eine Datei aus Kurzbefehlen und Skripten heraus — siehe Automatisierung.

Notizen.app-Import

Bestehende Apple-Notizen als Bestand übernehmen — siehe Import & Export.

Extraktion & Struktur

SideBrain legt nicht einfach Text ab — es baut Struktur auf, damit aus Dateien Zusammenhang wird.

• Kanonische Typen: Jede Notiz bekommt einen Typ (person, company, deal, event, project, concept, note, email, source …). Lebensläufe und LinkedIn-Profile werden automatisch als person erkannt; Angebote, Ausschreibungen und Verträge als deal; Meetings als event — jeweils mit echtem event_date für die zeitliche Einordnung.
• Dubletten-Vermeidung: Dieselbe Person oder Firma landet auf einer Seite, auch wenn sie aus verschiedenen Dateien kommt — bestehende Entitäten werden wiederverwendet statt Hash-Suffix-Dubletten anzulegen.
• Auto-Verknüpfung: Erwähnt eine Notiz Personen oder Firmen, die es im Brain schon gibt, entsteht automatisch eine Graphkante („erwähnt") — konservativ (Voll-Namen, Wortgrenzen), der Text bleibt unverändert.
• Timeline-Meilensteine: Datierte Meilensteine im Dokument (Go-live, Frist, Kickoff) werden als Timeline-Einträge angelegt.
• Herkunftszeile: Jede Datei-/Mail-Notiz endet mit „Quelle: …" (Herkunft + Datum) — die Provenienz ist Teil des Inhalts und damit zitierbar.
• Rauschfilter: Fast leere Extraktionen (z. B. Screenshots ohne Text) bekommen den Tag braucht-nacharbeit, statt unbemerkt als leere Seite zu landen.
• Fakten-Extraktion (Opt-in, experimentell): Auf Wunsch legt die KI bei klaren, dauerhaften Fakten einen strukturierten Fakten-Block an, aus dem das Brain eine Fakten-Tabelle aufbaut — Grundlage für Trajektorien und gezieltes Vergessen.
• Follow-up-Erkennung: Steht in einem Dokument ein terminierter Punkt („Angebot bis 15.08. raus", „Kündigungsfrist: 30.09."), merkt SideBrain ihn vor — rein regelbasiert, ohne KI-Aufruf, nur lokal gespeichert. Fällige Punkte erscheinen auf der Übersicht und melden sich einmalig per Mitteilung.

Fragen & Antworten

Jede Antwort stützt sich ausschließlich auf dein Brain und nennt ihre Quellen — keine erfundenen Fakten.

„Dein Second Brain fragen" (Übersicht)

Das Frage-Panel auf der Übersicht beantwortet Fragen in natürlicher Sprache. Die Antwort zeigt anklickbare Quellen-Chips (öffnen die Notiz im Brain-Explorer), erkannte Wissenslücken als eigenen Hinweis mit Absprung in den Quality Boost, und Verweise im Antworttext springen direkt zur verlinkten Notiz. Nachfragen im selben Gespräch sind möglich (⌘ ⏎ sendet).

Verbund: eine Frage an alle Brains

Wer mehrere Brains hinterlegt hat, wählt im Frage-Panel und im Chat die Option „Alle Brains (Verbund)": Die Frage läuft parallel gegen jedes verbundene Brain, die Antworten erscheinen als eine Ansicht mit einem Abschnitt je Brain. Jeder Quellen-Chip trägt den Namen seines Brains — ein Klick öffnet die Notiz im richtigen Brain (der Explorer wechselt automatisch dorthin). Ein nicht erreichbares Brain erscheint als kurze Notiz in seinem Abschnitt, ohne die übrigen Antworten zu verstecken.

Chat

Der Chat-Reiter ist das vollwertige Gesprächsfenster mit dem Brain:

• Gesprächsverlauf bleibt beim Reiterwechsel erhalten; das befragte Brain ist oben wählbar und zeigt Status und Seitenzahl — mit deutlichem Hinweis, falls das aktive Brain leer oder nicht erreichbar ist.
• Anhänge: Über den Anhang-Knopf oder per Drag & Drop hinzugefügte Dateien werden additiv fest ins Brain geladen und stehen dem Gespräch sofort als Kontext zur Verfügung.
• Korrektur-Feedback: „Daumen runter" unter einer Antwort öffnet ein Feld für eine Korrekturanmerkung, die zur Optimierung ins Brain gepusht wird — optional mit erläuternden Dateien.
• Exportieren: Jede Antwort lässt sich als Markdown-Datei (Frage, Antwort, Quellenverzeichnis) in Downloads ablegen — fertig für die Meeting-Unterlage.

Frage-Overlay ⌥ Space

Das Kürzel öffnet ein schwebendes Spotlight-Fenster über allem: Frage eintippen, Antwort mit Quellen lesen, weiterarbeiten — ohne die App zu öffnen oder den Kontext zu wechseln. Auch per sidebrain://ask?q=… aus Kurzbefehlen erreichbar.

Frage-Vorlagen

Eigene Ein-Klick-Fragen (Einstellungen → „Frage-Vorlagen"): Beschriftung + Frage speichern, z. B. „Wochenrückblick" → „Fasse zusammen, was ich diese Woche hinzugefügt habe." Gespeicherte Vorlagen ersetzen die eingebauten Beispielfragen auf der Übersicht.

Quality Boost — Wissenslücken schließen

Die KI findet auf Basis der Lücken deines Brains konkrete Fragen und stellt sie dir nacheinander — du nimmst dir 5, 10 oder 15 Minuten, deine kurzen Antworten fließen direkt als Notizen zurück ins Brain. Aus „Lücke erkannt" wird „Lücke geschlossen". Bedienung mit Fortschrittsanzeige, Überspringen und ⌘ ⏎.

Die Übersicht

Die Startansicht bündelt Kennzahlen, Erinnerungen und alles, was das Brain dir proaktiv zu sagen hat. Karten erscheinen nur, wenn sie Inhalt haben — keine leeren Kästchen.

Kennzahlen & Brain-Status

Pushes (7 Tage/gesamt), Erfolgsquote, übertragene Zeichen; daneben das aktive Brain mit Engine-Art (lokal/remote), Seitenzahl, gbrain-Version und Update-Hinweis.

Privatsphäre-Status

Zeigt live, ob Extraktion, Suche und Antworten gerade lokal oder über einen Cloud-Dienst laufen — der „Exit-Beweis" auf einen Blick. Ehrlich auch bei Mischbetrieb.

Rückblick (Digest)

Was diese Woche (oder täglich, einstellbar) ins Brain kam — mit Aktivitäts-Sparkline, neuen Notizen, optional Widerspruchs- und Fällige-Punkte-Zählern, Markdown-Export und Opt-in-Benachrichtigung.

Fällige Punkte

Beim Ablegen erkannte Termine der nächsten 7 Tage, Überfälliges rot markiert, mit „Erledigt"-Knopf. Nur lokal gespeichert.

Widersprüche

Konflikte zwischen Notizen (z. B. unterschiedliche Zahlen zum selben Thema) mit Schweregrad — aus der letzten Widerspruchs-Prüfung des Brains, rein lesend, ein Klick öffnet die Notiz.

Heute vor …

Ereignisse aus früheren Jahren, die auf den heutigen Kalendertag fallen — Erinnern als Funktion, nicht nur Speichern.

Ungewöhnliches bemerkt

Statistische Ausreißer der Aktivität (deutlich mehr Notizen eines Typs als üblich) — ohne KI-Aufruf, höchstens ~2× pro Woche, abschaltbar.

Anstehende Termine

Kommende Kalender-Termine der nächsten 7 Tage, jeweils mit „Termin begleiten"-Knopf, der das Termin-Fenster mit Titel und Teilnehmern startet. Braucht einmalig die macOS-Automatisierungs-Freigabe für den Kalender.

Letzte Aktivität

Die jüngsten Pushes mit Status; Absprung in den vollen Verlauf mit Textsuche und Status-Filter.

MCP-Adressen

Die lokale HTTP-URL des MCP-Servers (Klick kopiert) — zum Einbinden in Claude Desktop & Co.

Schnellaktionen

Schnellnotiz, Screenshot, Termin begleiten und Entwurf direkt aus der Übersicht.

Beim allerersten Start (noch keine Pushes) zeigt die Übersicht statt leerer Karten eine Begrüßung mit drei Schritten zum ersten Push.

„Dein Brain kann jetzt was"

Sobald genug Wissen zusammengekommen ist — ab ~50 erfolgreichen Erfassungen laut deiner lokalen Historie oder 14 Tage nach dem ersten Start mit dieser Version (bei Bestandsnutzern greift meist ohnehin die 50er-Schwelle) —, zeigt die Übersicht einmalig die Karte „Dein Brain kann jetzt was". Klickst du auf „Beispielfragen zeigen", ruft SideBrain dafür einmal die KI auf und generiert bis zu fünf Beispielfragen, die dein Brain mit seinem aktuellen Wissen jetzt beantworten kann; ein Klick auf eine der Fragen stellt sie dir direkt. Mit dem ✕ („Ausblenden") oder nach dem Generieren verschwindet die Karte dauerhaft — sie kommt nicht wieder, es gibt keine Benachrichtigung dazu und keine wiederkehrenden Kampagnen. Der Auslöser (Zähler, Datum, ob schon gezeigt) bleibt vollständig lokal auf deinem Rechner.

Dokument-Werkstatt: Dein Brain schreibt den ersten Entwurf

Der Knopf „Entwurf" bei den Schnellaktionen öffnet die „Dokument-Werkstatt": zuerst eine Vorlage wählen — eingebaut sind Angebot, Statusbericht, Kundenbrief und Projektzusammenfassung, dazu eigene Markdown-Vorlagen aus den Einstellungen (Abschnitt „Entwurfs-Vorlagen"; Platzhalter in eckigen Klammern wie [Kunde] oder [Leistungen]). Dann den Auftrag in einem Satz beschreiben — etwa „Angebot für Stadtwerke Musterstadt über die Cloud-Migration, drei Phasen, Start September" — und „Entwurf erstellen" klicken. Das Brain füllt die Vorlage mit belegtem Wissen aus den Notizen samt Quellen; wo Wissen fehlt, bleibt ein Platzhalter „[offen: …]" stehen statt erfundener Fakten. Die Vorschau erscheint direkt in der App, Export wahlweise „Als Markdown (.md)" oder „Als Word (.docx)" — ganz ohne Zusatzsoftware, mit Bordmitteln von macOS — die Datei landet in Downloads und wird im Finder gezeigt. Wie bei Fragen und dem Kunden-Dossier läuft immer nur eine lange Anfrage zur Zeit, mit Abbrechen-Knopf jederzeit. Ein Hinweis vorab: Die Dokument-Werkstatt liefert einen ersten Entwurf zum Weiterarbeiten — kein fertiges Briefpapier oder Corporate-Design-Layout.

Brain-Explorer

Der Explorer ist die Bestandsansicht des Brains: durchsuchen, lesen, pflegen — ohne Kommandozeile.

Suchen & Stöbern

Bei mehreren Brains zeigt die Seitenleiste eine Sektion „Brains": ein Eintrag je verbundenem Brain plus „Alle Brains (Verbund)" — ein Klick wechselt das aktive Brain, ganz wie zwischen Laufwerken im Finder. Das zuletzt gewählte Brain merkt sich SideBrain auch über einen Neustart hinweg. In der Verbund-Sicht laufen Liste und Suche über jedes verbundene Brain, jeder Eintrag trägt einen Herkunfts-Chip. Öffnen, Bearbeiten, Tags und Verknüpfungen wirken automatisch auf das Quell-Brain der Notiz. Die Übersicht zeigt dazu die Verbund-Kennzahl („X von Y Brains erreichbar · N Seiten gesamt").

• Volltextsuche über alle Notizen; ohne Suchbegriff die zuletzt aktualisierten Seiten.
• Kategorie-Seitenleiste: Links im Explorer wie im Finder — „Alle Notizen" und die Kategorien (Personen, Firmen, Projekte, Termine, Angebote, Konzepte, Quellen) mit Trefferzahl, leere Kategorien ausgeblendet. Ein Klick filtert die Liste, die Auswahl bleibt beim Wechsel zwischen den Reitern und beim Brain-Wechsel erhalten; komplett per Tab und Pfeiltasten bedienbar.
• Spaltenliste: Die Notizen erscheinen wie im Finder in Spalten — Name, Art und Geändert. Ein Klick auf den Spaltenkopf Name oder Geändert sortiert auf- bzw. absteigend, ein Pfeil-Symbol markiert die aktive Spalte und Richtung; die Spaltenköpfe sind auch per Tastatur bedienbar. Die Volltextsuche zeigt weiterhin Treffer-Snippets statt der Spalten.
• Tags in der Seitenleiste: Unterhalb der Kategorien zeigt die Seitenleiste die meistgenutzten Tags des aktiven Brains, nach Häufigkeit sortiert („Mehr anzeigen" für weitere). Ein Klick filtert die Liste auf Notizen mit diesem Tag und lässt sich mit der Kategorie kombinieren; ein erneuter Klick hebt den Filter wieder auf. In der Verbund-Sicht „Alle Brains" steht dort ein Hinweis, dass Tags nur je Brain verfügbar sind; ein Brain ganz ohne Tags zeigt die Sektion gar nicht erst.
• Vorschau statt Fenster: Ein Klick auf einen Listeneintrag zeigt die Notiz direkt in einer dritten Spalte rechts neben der Liste — Titel, Typ, Tags, Meta, gerendertes Markdown mit anklickbaren [[Wikilinks]] sowie Beziehungen („Verweist auf" / „Erwähnt in") stehen dort bereit, die Liste bleibt dabei sichtbar und bedienbar. So lassen sich mehrere Notizen nacheinander durchklicken, ohne ein Fenster zu öffnen oder zu schließen. Ohne Auswahl zeigt die Vorschau einen Leerzustand; bei schmalem Fenster ersetzt sie Seitenleiste und Liste vollständig, ein „Zurück zur Liste"-Weg führt zurück.
• Vollständig per Tastatur bedienbar: Pfeil hoch/runter bewegt die Auswahl in der Liste — die Vorschau folgt sofort, die Zeile scrollt in den sichtbaren Bereich. Enter fokussiert zusätzlich die Vorschau, Esc kehrt zur Liste zurück. Tab durchläuft Seitenleiste → Liste → Vorschau in nachvollziehbarer Reihenfolge, Pfeiltasten navigieren innerhalb der Seitenleiste (Brains, Kategorien, Tags). Tippen eines Buchstabens/Wortanfangs springt per Typeahead zur ersten passenden Notiz, ⌘F fokussiert die Suche. Fokus ist in beiden Themes deutlich sichtbar, die Liste trägt passende ARIA-Rollen für Screenreader.

Kuratieren & Aufräumen

Bearbeiten (Markdown-Editor)

Titel, Typ, Tags und Inhalt direkt ändern — mit „Bearbeiten / Vorschau"-Umschalter: Die Vorschau rendert das Markdown live, inklusive klickbarer [[Wikilinks]]. Der Slug bleibt stabil, Verweise brechen nicht; Abbrechen mit ungespeicherten Änderungen fragt nach. Die maschinelle Timeline-Zone (Herkunftszeile, Mitschriften) erscheint nicht im Editor und bleibt beim Speichern garantiert erhalten — ein aufklappbarer Hinweis zeigt sie read-only.

Tags & Verknüpfungen

Tags per ✕ entfernen und per „+ Tag" ergänzen; Verknüpfungen per „+ Verknüpfung" setzen und per ✕ lösen — direkt in der Notiz-Ansicht, ohne Bearbeiten-Modus.

Zusammenführen

Zwei Notizen vereinen: Inhalte werden zusammengelegt, Verweise umgebogen, das Duplikat gelöscht.

Dubletten-Review

SideBrain schlägt verdächtig ähnliche Paare vor (gleiche Slug-Basis, enthaltene Titel, stark überlappende Titel derselben Kategorie). Pro Paar wählst du, welche Notiz bleibt; „Kein Duplikat" merkt sich das Paar dauerhaft. Nichts passiert ohne Klick.

Fakten vergessen

Einzelne falsche oder veraltete Fakten aus der Fakten-Liste einer Notiz streichen, ohne die Notiz zu löschen — nachvollziehbar markiert, übersteht einen Neuaufbau.

Titel aufräumen

Bestands-Backfill: Seiten mit nichtssagenden Titeln („Bild (3)") bekommen aus dem Inhalt abgeleitete sprechende Titel — mit Vorschau (alt → neu) vor dem Anwenden.

Versionen & Papierkorb

Versionen: Das Notiz-Detail zeigt frühere Fassungen (Zeitpunkt + Vorschau); „Wiederherstellen" setzt die Notiz nach Bestätigung zurück — der aktuelle Stand wird dabei selbst als Version gesichert, ein Rollback ist nie Datenverlust. Papierkorb: Gelöschte Notizen bleiben 72 Stunden wiederherstellbar.

Graph, Experten & Trajektorien

Graph-Ansicht

Interaktive Verknüpfungs-Karte: die Notiz im Zentrum, Beziehungen radial darum, farbcodiert nach Typ — ausgehende Verweise durchgezogen, eingehende Erwähnungen gestrichelt. Klick auf einen Nachbarn zentriert ihn (Erkunden mit Zurück-Pfad).

Experten-Suche

„Wer kennt sich damit aus?" — Thema eingeben, SideBrain zeigt die Personen (und Entitäten), die im Brain am meisten dazu beigetragen haben, mit Relevanz-Prozent. Besonders wertvoll im Team-Brain.

Trajektorien

Notizen mit erfassten Kennzahlen (Projekte, Deals) zeigen eine chronologische „Entwicklung über Zeit"-Liste — z. B. Budget-Verlauf und Meilensteine.

Kunden-Dossier

Für die Viertelstunde vor dem Kundentermin: Der Knopf „Dossier" bei einer geöffneten Person oder Firma baut eine Ein-Blick-Akte — Überblick, letzte Interaktionen und offene Punkte als Synthese mit Quellen, dazu die erfassten Fakten und alle verknüpften Dokumente. Jeder Baustein lädt einzeln und degradiert für sich; scheitert einer (z. B. weil gerade keine Synthese verfügbar ist), bleiben die übrigen trotzdem sichtbar — ein toter Baustein verhindert nie das ganze Dossier. Das Dossier öffnet als Dialog über dem Explorer und lässt sich per Klick als Markdown-Datei exportieren (landet in Downloads, danach zeigt der Finder die Datei direkt); ein Abbrechen-Knopf beendet die Erstellung jederzeit. Es läuft immer nur eine lange Anfrage zur Zeit — auch Chat, Frage-Panel und Overlay warten, bis das Dossier fertig ist oder abgebrochen wird. Auch per Kommandozeile/Skill verfügbar: --dossier "Name".

Termine begleiten ⌥ T

Ein Fenster fürs Meeting: Notizen, Anhänge, Mitschrift und Teilnehmer — beim Abschließen entsteht eine verknüpfte, befragbare Terminnotiz.

• Vorbefüllung aus dem Kalender: Läuft gerade ein Termin, übernimmt das Fenster Titel und Teilnehmer automatisch. Aus der Übersicht-Karte „Anstehende Termine" startet „Termin begleiten" das Fenster gezielt mit einem gewählten Termin der nächsten 7 Tage.
• Notizen & Anhänge: Freitext plus per Drag & Drop angehängte Dateien und Screenshots — Anhänge werden gepusht und mit der Terminnotiz verknüpft; Teilnehmer werden als Personen verbunden.
• Mitschrift (lokal): „Aufnahme starten" transkribiert das Gesagte vollständig auf dem Mac (Voxtral-Mini über den gebündelten llama-server, 8 Sprachen inkl. Deutsch, einmalig ~3,2 GB, Opt-in). Der Text erscheint abschnittsweise live und ist direkt korrigierbar. Sprechpausen-Schnitt und Stille-Filter verhindern Halluzinationen; das Modell wird nur bei Bedarf geladen (~4 GB RAM nur während des Termins). Nichts geht ins Netz.
• Termin-Zusammenfassung: Beim Abschließen fasst die KI Notizen + Mitschrift zu einem Protokollkopf zusammen — Kurzfassung, Entscheidungen, offene Punkte, je mit Verantwortlichen und Terminen. Die Zusammenfassung steht oben in der Terminnotiz (von der Suche bevorzugt), die vollständige Mitschrift wandert in die Timeline-Zone. Schlägt der KI-Aufruf fehl, wird ohne Zusammenfassung gespeichert — nie ein Blocker.
• Termin-Vorbereitung: „Was weiß mein Brain dazu?" fragt vor dem Termin mit Titel + Teilnehmern als Kontext und zeigt relevante Fakten, offene Punkte und Quellen.
• Entwurf übersteht alles: Der Stand des Fensters wird laufend lokal gesichert und übersteht App-Neustart und versehentliches Schließen. Erkannte offene Punkte mit Datum fließen in die Fälligen Punkte.

Kalender-Zugriff braucht einmalig die macOS-Freigabe (Systemeinstellungen › Datenschutz & Sicherheit › Automatisierung). Ohne Freigabe bleibt die Vorbefüllung einfach leer — nichts hängt oder blockiert.

Automatisierung & Berichte

Geplante Berichte

Wiederkehrende Fragen an das Brain zu festem Zeitpunkt (Einstellungen → „Geplante Berichte"): z. B. „Projektstatus Nordstern, wöchentlich Montag 8 Uhr". Zur eingestellten Zeit kommt eine Benachrichtigung, die Antwort samt Quellenverzeichnis liegt als Markdown-Datei in Downloads. „Jetzt testen" prüft einen Bericht sofort. Jeder Bericht ist eine bewusste eigene Entscheidung (Frage + Zeitplan selbst angelegt) — SideBrain plant nie von sich aus kostenpflichtige KI-Aufrufe ein.

Wissensbericht statt Frage: Bei jedem geplanten Bericht wählst du den Typ — „Frage-Bericht" (wie oben) oder „Wissensbericht". Der berichtet nicht auf eine gestellte Frage, sondern über dein Brain selbst: Bestand, Neu/aktualisiert (gesamt und je Typ, die fünf größten Zuwächse), aus der App gestellte Fragen (lokal gezählt — Chat, Übersicht, Frage-Overlay, Kunden-Dossier, Dokument-Werkstatt; Fragen von externen MCP-/Skill-Clients zählen nicht mit) und offene Widersprüche, jeweils im Vergleich zur Vorperiode (beim ersten Bericht noch ohne Vorperiode), dazu ein kurzer „Das hat sich getan"-Absatz aus deinem Brain. Fehlt ein Baustein einmal, steht dort „nicht verfügbar" — der Bericht kommt trotzdem. Zustellung wie jeder Bericht (Benachrichtigung + Markdown-Datei, optional Teams/Slack); „Jetzt testen" funktioniert beim Wissensbericht auch ohne eingetragene Frage. Die Fragen-Zählung bleibt vollständig lokal (60 Tage) — keine Telemetrie.

Optional an Teams oder Slack posten: Pro Bericht (und beim Rückblick) lässt sich eine Incoming-Webhook-URL hinterlegen — die Adresse, die Teams unter „Connector hinzufügen" bzw. „Workflows" oder Slack unter „Incoming Webhooks" für einen Kanal ausstellt. Ist eine URL eingetragen, postet SideBrain zur eingestellten Zeit zusätzlich zur Benachrichtigung eine gekürzte Fassung (max. 3.000 Zeichen) mit dem Hinweis, dass der vollständige Bericht in SideBrain liegt. Teams-„Workflows"-URLs (logic.azure.com) erkennt SideBrain automatisch und formatiert die Nachricht als Adaptive Card; alle anderen Ziele (Slack, Mattermost, klassische Teams-Connectoren) bekommen einfaches Text-JSON. Der letzte Zustellstatus je Bericht steht direkt in den Einstellungen; „Jetzt testen" prüft die Zustellung mit. Es geht dabei ausschließlich der selbst bestellte Berichtsinhalt an die selbst eingetragene URL — keine Telemetrie, kein zusätzlicher Datenabfluss.

URL-Schema sidebrain://

Macht SideBrain in Apple-Kurzbefehle, Tastatur-Automatisierungen und Skripte einbaubar:

sidebrain://push?path=/Pfad/zur/Datei.pdf   → Datei pushen (wie per Drop)
sidebrain://ask?q=Was%20ist%20offen%3F      → Overlay öffnet mit gestellter Frage

Rückblick (Digest) & Dream-Cycle

Der Rückblick fasst wahlweise täglich oder wöchentlich zusammen, was ins Brain kam — Bausteine (Widersprüche, fällige Punkte) einzeln zuschaltbar, Benachrichtigung als Opt-in, Export als Markdown. Genau wie bei geplanten Berichten lässt sich auch der Rückblick optional an eine Teams-/Slack-Webhook-URL posten (gekürzt, mit Verweis auf die vollständige Fassung in SideBrain); „Jetzt anzeigen" prüft die Zustellung mit. Der Dream-Cycle (Opt-in) lässt das lokale Brain nachts konsolidieren (Entity-Sweep, Zitat-Fixes, Memory-Konsolidierung) — höchstens einmal je ~20 Stunden, solange die App läuft, zusätzlich jederzeit auf Knopfdruck mit Dry-Run-Option.

KI-Anbindung

SideBrain bringt kein Pflicht-Modell mit und bindet an keinen Anbieter. Drei Schichten sind getrennt konfigurierbar: Extraktion, Antworten und Suche.

KI-Profile (Extraktion)

Unter Einstellungen → KI-Endpunkte werden Modell-Zugänge als Profile hinterlegt: Anthropic Claude (direkt oder über Gateway mit eigener Base-URL/Auth-Token) und OpenAI-kompatible Endpunkte mit fertigen Vorlagen für OpenAI, Azure OpenAI / AI Foundry, Google Vertex AI, LiteLLM, Ollama, LM Studio, vLLM, OpenRouter und Groq. Mehrere Profile sind parallel möglich; Dateityp-Regeln ordnen bestimmten Endungen ein eigenes Profil zu (z. B. „.pdf → Haiku, Rest → Sonnet").

Antworten / Synthese (Think)

Der Antwort-Endpunkt ist unabhängig von der Extraktion wählbar:

• Claude (Standard) — nutzt automatisch das KI-Profil samt vollständiger Zugangsdaten (auch Gateway-Konstellationen).
• OpenAI-kompatibel — beliebiger /v1-Chat-Endpunkt mit denselben Vorlagen wie oben.
• SideBrain lokal — das mitgelieferte Modell antwortet komplett auf dem Mac, ohne Schlüssel, auch im Flugmodus. Es ist dasselbe Modell wie für die Termin-Mitschrift: der Download fällt nur einmal an, der Server wird geteilt.
• Kostenlos starten — Ein-Klick-Anmeldung bei OpenRouter (Modell openrouter/free) oder LLM Gateway (Gratis-Guthaben).

Suche: Embeddings & Reranker

Die semantische Suche des lokalen Brains ist Opt-in und anbieteroffen:

• Lokal gebündelt (empfohlen): mitgelieferter llama-server mit mehrsprachigem bge-m3-Embedding-Modell und bge-reranker-v2-m3 — einmalig ~880 MB, danach vollständig offline. Wird bei der Einrichtung angeboten und bestehenden Installationen einmalig aktiv angeboten.
• Alternativ: Ollama (lokal), OpenAI, Azure OpenAI, ZeroEntropy (zembed-1) und Voyage AI — teils mit wählbarer Vektor-Dimension (Matryoshka: weniger Speicher gegen minimal weniger Genauigkeit). Oder bewusst reine Schlüsselwort-Suche.
• Robuster Modell-Wechsel: Vor jedem Wechsel prüft SideBrain, was nötig ist — gleiche Vektorbreite: verlustfreie Neuberechnung; andere Dimension: Neuaufbau mit automatischer Sicherung. Die Bestätigung sagt vorab, welcher Fall eintritt.
• Reranker: sortiert Suchtreffer per Cross-Encoder vor der Antwort neu (Qualitätshebel) — aus, lokal (gebündelt) oder ZeroEntropy.

Firmen-Proxy

SideBrain liest den macOS-System-Proxy automatisch und reicht ihn an alle Netzaufrufe durch (Einrichtung, Extraktion, Suche, Antworten) — auch wenn die Engine von Claude Desktop oder als HTTP-MCP-Server gestartet wird. NO_PROXY schützt localhost und die System-Ausnahmen. Ohne konfigurierten Proxy ändert sich nichts; reine PAC-URL-Konfigurationen werden nicht ausgewertet.

Lizenz & Testphase

SideBrain macht Lizenzfragen in der Testphase unsichtbar und bleibt danach ehrlich: eigene Daten bleiben zugänglich, nur neues Wissen braucht eine passende Lizenz.

30 Tage ohne Lizenzschlüssel

Die Testphase beginnt beim ersten Start der Installation und dauert 30 Tage. In dieser Zeit stehen Erfassung, Bearbeitung, Suche und alle KI-Funktionen vollständig zur Verfügung. Es gibt keine Aktivierung, kein Konto und keinen Online-Check.

Was nach Ablauf passiert

Ohne gültige Lizenz sperrt SideBrain das Erzeugen neuen Wissens: neue Erfassung, Schreiben und KI-Synthese sind nicht möglich. Verlauf, Lesen, Suchen und Export bereits vorhandener Daten bleiben zugänglich. Die App löscht keine eigenen Daten und zeigt den Grund der Sperre sowie beide Auswege an.

Lizenz hinterlegen

Private, nicht-kommerzielle Nutzung bleibt dauerhaft kostenlos. Fordern Sie unter sidebrain.eu/privatlizenz nach einmaligem Google-Login eine Privatlizenz an, kopieren Sie den signierten Schlüssel und fügen Sie ihn in SideBrain unter Einstellungen → Lizenz ein. Die Prüfung erfolgt danach vollständig offline. Kommerzielle Nutzung braucht eine kommerzielle Lizenz; dafür wenden Sie sich an vertrieb@incubateit.de.

Für MCP und Skill gilt dasselbe Modell: Schreiben und Synthese werden nach Ablauf ohne Lizenz abgewiesen, Suche und Nachschlagen bleiben möglich. Details stehen im Endnutzer-Lizenzvertrag.

EU-KI-Kennzeichnung

SideBrain nutzt KI zur Extraktion und Beantwortung — die App zeigt das entsprechend im Footer an.

Gemäß den Kennzeichnungspflichten des EU AI Act zeigt SideBrain im Footer der Übersicht dauerhaft das offizielle Kennzeichnungsbild für KI-generierte Inhalte. Im Dark Mode wird es automatisch invertiert dargestellt; ein lokalisierter Alt-Text macht die Kennzeichnung auch für Screenreader zugänglich.

Datensicherheit

Gebaut für vertrauliche Firmendaten: lokal verarbeitet, ohne Kontozwang, ohne Telemetrie — und auf Wunsch beweisbar 100 % offline.

• Lokale Verarbeitung: Text-Extraktion und Indexierung laufen auf dem Gerät. Reiner Text und E-Mails werden immer lokal extrahiert; Dokumente über das hinterlegte KI-Profil, mit lokalem Ausweich-Pfad bei Fehlern.
• Privatsphäre-Status: Die Übersicht zeigt live und ehrlich, welche Schicht (Extraktion / Suche / Antworten) gerade lokal und welche über die Cloud läuft.
• 100 % offline möglich: Mit lokalem Brain, lokaler Suche und lokalem Antwort-Modell funktioniert die gesamte Kette Ablegen → Suchen → Antworten ohne Netz. Ein automatisierter Flugmodus-Test in der Entwicklungs-Pipeline beweist das bei jedem Release: Push + Frage gelingen in einer Umgebung ganz ohne Cloud-Zugangsdaten.
• Keine Telemetrie: kein Nach-Hause-Funken, kein Tracking, kein Pflichtkonto.
• Datenhoheit: Alles Wissen liegt als Markdown vor und lässt sich jederzeit vollständig als ZIP exportieren — kein Lock-in.
• Nur ihr entscheidet, wohin Prompts gehen: KI-Aufrufe gehen ausschließlich an den konfigurierten Endpunkt, und nur, wenn jemand aktiv fragt oder pusht. Zeitgesteuerte KI-Aufrufe gibt es nur dort, wo sie explizit selbst angelegt wurden (Geplante Berichte).

Lizenz: SideBrain ist proprietäre Software der IncubateIT (EULA unter sidebrain.eu/license). Jede Installation läuft die ersten 30 Tage vollständig ohne Lizenzschlüssel. Der Lizenzbereich der Einstellungen prüft einen eingefügten Schlüssel komplett offline (kein Aktivierungsserver, kein Phone-Home) und zeigt bei Gültigkeit sofort Name, E-Mail, Lizenztyp (privat/kommerziell) und Laufzeit — bei einem Problem einen verständlichen Grund, ohne die Eingabe zu verwerfen. Ohne Schlüssel zeigt derselbe Bereich den verbleibenden Test-Zeitraum sowie den Weg zur dauerhaft kostenlosen Privatlizenz. Die holt man sich unter sidebrain.eu/privatlizenz: einmal mit dem Google-Konto anmelden, Schlüssel anfordern, kopieren, in den Einstellungen einfügen — fertig. Der Schlüssel bleibt danach vollständig offline gültig; ein erneuter Besuch der Seite liefert genau denselben Schlüssel zurück, es entstehen keine Duplikate. Auch das ist reiner Compliance-Anker, keine technische Durchsetzung. Ab 7 Resttagen ergänzt eine dezente, nicht-modale Leiste im Hauptfenster diesen Hinweis mit dem exakten Reststand und einem Ein-Klick-Weg zur kostenlosen Privatlizenz — wegklickbar, kehrt frühestens am nächsten Tag zurück und stört nie eine laufende Erfassung. Sind die 30 Tage ohne Schlüssel abgelaufen, sperrt SideBrain neue Erfassung, Bearbeitung und alle KI-Funktionen (Fragen, Verbund-Antworten, Kuratieren, Qualitäts-Boost u. a.) — hart, ohne Kulanzfrist. Lesen und Durchsuchen des bereits Erfassten bleiben dabei ausdrücklich möglich; eine Sperr-Ansicht erklärt genau das und bietet direkt beide Auswege (Schlüssel eingeben oder kostenlose Privatlizenz holen).

Team-Brains & mehrere Brains

Vom persönlichen Speicher zum geteilten Projektwissen — mit sauberer Trennung zwischen Brains.

• Mehrere Endpunkte: Beliebig viele Gbrain-Profile parallel (lokal + remote). Ein Profil ist das Standard-Push-Ziel; Übersicht, Chat und Explorer lassen das befragte Brain frei wählen.
• Team-Anbindung: „Mit Team-Brain verbinden …" in den Einstellungen führt durch den Beitritt: URL + Token vom Betreiber, Verbindung wird vor dem Anlegen geprüft, und das private Brain bleibt ausdrücklich das Standard-Push-Ziel. Lese-/Schreibrechte richten sich nach dem Token-Scope.
• Projekt-Router: Watch-Folder können in ein abweichendes Brain pushen — Projektordner → Projekt-Brain, alles andere → privates Brain, automatisch sortiert.
• Verlässliche Identität: Die Brain-Kachel zeigt Engine-Art, Version und Seitenzahl auch ohne Admin-Token.
• Verbund-Fragen: „Alle Brains (Verbund)" fragt privates und Unternehmens-Wissen gleichzeitig — mit je Brain gekennzeichneten Quellen (siehe Fragen & Antworten).
• Lokale / private CAs: Für jedes HTTPS-Ziel lässt sich die TLS-Zertifikatsprüfung gezielt lockern (Opt-in pro Profil, Standard aus, Bestätigungsdialog mit Sicherheitshinweis). Greift ausschließlich für genau dieses Brain; ein zweites Profil bleibt strikt verifiziert. Für Pushes, Suchen, Think und „Alle Brains".
• OAuth-Client-Authentifizierung: Für Remote-Gbrain-Ziele (nicht für lokale stdio:-Brains) lässt sich der Authentifizierungsmodus je Ziel in den Einstellungen von „API-Key" auf „OAuth-Client" umstellen — Token-Endpoint, Client-ID und Client-Secret stammen vom Betreiber des Ziels und werden lokal im bestehenden Secret-Store abgelegt, nie im Klartext angezeigt, exportiert oder geloggt. SideBrain holt sich das Zugriffstoken per Client-Credentials-Flow und erneuert es automatisch vor Ablauf oder nach einer fehlgeschlagenen Anfrage; scheitert das dauerhaft, erscheint ein verständlicher Fehler statt eines stillen Fehlschlags. Standard bleibt für neue wie bestehende Ziele „API-Key", einen globalen Default für alle Ziele gibt es nicht — die Einstellung wirkt ausschließlich für das eine gewählte Ziel. Voraussetzung ist ein GBrain-Betreiber, der den Client-Credentials-Flow tatsächlich unterstützt; SideBrain bindet keinen beliebigen Drittanbieter-Provider ohne passenden GBrain-Vertrag an.

MCP für Entwickler

Das eigene Wissen als Model-Context-Protocol-Server — für Claude Desktop, Codex und jeden MCP-Client.

SideBrain stellt sein Brain auf zwei Wegen bereit:

• Lokaler HTTP-Server (Streamable HTTP): http://127.0.0.1:8765/mcp — Port einstellbar, standardmäßig nur localhost (auf Wunsch auch im Netzwerk erreichbar, siehe „Mac als Brain-Server im Netzwerk"), läuft als verwalteter Kindprozess solange SideBrain geöffnet ist. An/Aus, Token-Schutz und Live-Status in den Einstellungen.
• stdio-Startbefehl für Clients, die Prozesse selbst starten (z. B. Claude Desktop) — Ein-Klick-Installation der Desktop-Konfiguration inklusive.

"mcpServers": {
  "sidebrain": {
    "url": "http://127.0.0.1:8765/mcp"
  }
}

Verfügbare Werkzeuge: Push (Dateien/Text/URLs einspeisen), Suche und Think — read/write gemäß Token-Scope. Bei mehreren Brains erscheinen zusätzlich die Verbund-Werkzeuge: think_all fragt alle Brains parallel (Antwort mit Abschnitt und Quellen je Brain), und je Brain gibt es ein eigenes think_<name>-Tool für gezielte Fragen — der Assistent kann also selbst routen. context_for (bei aktiviertem MCP-Kontext-Tool): liefert zu einem Thema die passenden Notizen aus allen verbundenen Brains als fertigen Prompt-Kontext; per CLI jederzeit über --context-for "Thema" — unabhängig vom Toggle. Beide Transporte teilen denselben Dispatch; langlebige Server geben das lokale Brain bei Leerlauf frei, damit App und MCP-Clients sich nicht gegenseitig blockieren. Ein exportierbarer Skill beschreibt die Werkzeuge für Agenten-Clients. Ist die 30-tägige Testphase ohne hinterlegte Lizenz abgelaufen, gilt dieselbe Sperre wie in der App: Schreiben und Synthese (Push, think/think_all) antworten mit einem strukturierten Fehler samt Hinweis auf die kostenlose Privatlizenz, Suche und Nachschlagen bleiben uneingeschränkt möglich.

Push-Werkzeuge im Detail

Die vier Push-Werkzeuge spiegeln exakt die App-UI-Capture-Pfade — dieselbe Pipeline, kein put_page-Workaround für Agenten:

• push_file (Dateipfad): PDF, Office, Bilder, Text, E-Mails als .eml — Engine übernimmt Extraktion (KI-Konvertierung, OCR, Bildbeschreibung).
• push_url (URL): eine Web-Seite als Lesetext-Notiz — Titel und Slug aus der Seite, dieselbe URL aktualisiert ihre Notiz, Schema wie der App-URL-Push (type: source, tags: [url-import, source], source_url, extracted_with, imported_at).
• push_shared (Text/URL): geteilten Inhalt automatisch routen — lone http(s)-URL wird zum URL-Push, sonst zur Schnellnotiz. Gleiche Heuristik wie das macOS-Dienste-Menü „An SideBrain senden".
• push_text (Text, optional note_type): Freitext-Notiz; mit note_type='person' läuft die strukturierte 5-Felder-Personen-Erfassung (Name, Rolle, Firma, Kontakt, Kontext) — Resultat-Schema ist bit-identisch zur App-Schnellnotiz mit Typ-Selektor „Person".

Antwort kommt als JSON mit Slug, Titel und ggf. Methode/Zeichenzahl; bei Trial-Schloss nach 30 Tagen ohne Lizenz antworten alle vier Werkzeuge mit code: license_required.

Standardmäßig antwortet der lokale HTTP-Server jedem Prozess auf demselben Mac — praktikabel im Alltag, aber auf einem Rechner mit mehreren Benutzerkonten kommt so jedes Konto über localhost ans Brain. In den Einstellungen (Sektion „Lokaler MCP-Server (HTTP)") lässt sich deshalb ein Bearer-Token-Schutz zuschalten: ein Klick auf „Neuen Token generieren" erzeugt einen zufälligen Token, der sich anzeigen und kopieren lässt. Ist der Schutz aktiv, verlangt jede Anfrage — auch der Health-Check — den Header Authorization: Bearer <Token>; ohne oder mit falschem Token antwortet der Server mit 401, ohne ein MCP-Tool auszuführen:

"mcpServers": {
  "sidebrain": {
    "url": "http://127.0.0.1:8765/mcp",
    "headers": { "Authorization": "Bearer <Token>" }
  }
}

Schutz aus (Standard) ändert nichts am heutigen Verhalten — bestehende Clients laufen ohne Anpassung weiter. Der stdio-Startbefehl braucht keinen Token: er startet als lokaler Kindprozess ohne Netzwerkzugriff.

Zur Transparenz führt SideBrain ein lokales, schreibgeschütztes MCP-Zugriffsprotokoll: jeder Zugriff — ob über den HTTP-Server oder den stdio-Startbefehl — wird mit Zeitpunkt, Werkzeug/Methode und einem minimalen Anriss der Abfrage vermerkt, rein lokal und ohne Netzversand. Beim Bearer-Token lässt sich zusätzlich eine frei wählbare Bezeichnung hinterlegen (z. B. „Claude Desktop MacBook") — das Protokoll zeigt diese Bezeichnung an, niemals den Token selbst. Einsehbar über „Zugriffsprotokoll ansehen" in derselben Einstellungs-Sektion. Sperren oder Widerrufen einzelner Zugriffe ist bewusst ein späterer Ausbauschritt.

Mac als Brain-Server im Netzwerk

Standardmäßig bindet der lokale HTTP-Server ausschließlich an 127.0.0.1 — kein anderes Gerät kommt heran. Wer einen Mac bewusst als kleinen Brain-Server für ein Team nutzen will (ein Rechner hostet das Wissen, Kolleg:innen greifen aus dem LAN zu), stellt in den Einstellungen unter „Lokaler MCP-Server (HTTP)" die Erreichbarkeit um: „Alle Netzwerke dieses Macs" bindet an 0.0.0.0, „Bestimmte IP-Adresse" an eine feste Adresse dieses Rechners. Beide Optionen setzen den Bearer-Token-Schutz von oben zwingend voraus — er wird beim Umschalten automatisch mit aktiviert; eine Netzwerkfreigabe ohne Schutz gibt es nicht. Die Statuszeile zeigt danach die tatsächlich nutzbare Adresse zum Kopieren (bei „Alle Netzwerke" mit der LAN-IP des Macs statt 0.0.0.0) — Kolleg:innen tragen sie samt Token in ihren Client ein, genau wie oben beschrieben.

Ehrlich gesagt: Der Server lebt nur, solange SideBrain geöffnet ist — schließt sich die App, ist auch das Team-Brain nicht mehr erreichbar (kein Daemon, kein Autostart-Betrieb). Beim ersten Start mit einer Netzwerkfreigabe fragt macOS einmalig, ob eingehende Verbindungen für SideBrain erlaubt sind (Firewall-Dialog) — ohne Bestätigung bleibt der Server für andere Geräte unerreichbar. Eine ungültige oder auf diesem Mac nicht vorhandene IP-Adresse zeigt die Statuszeile als klaren Fehler statt stillen Ausfalls. Kein TLS in diesem Schritt — die Freigabe ist fürs lokale Netzwerk gedacht, nicht fürs offene Internet.

SideBrain in KI-Assistenten nutzen

Schritt für Schritt: euer Brain als Wissensquelle in Claude, ChatGPT, Codex und anderen Werkzeugen — auf Basis des MCP-Servers, der lokal mitläuft, solange SideBrain geöffnet ist.

Vorbedingung für die MCP-Anleitungen unten: SideBrain läuft, der lokale MCP-Server ist aktiv (Standard; An/Aus, Port und Live-Status unter Einstellungen → „Lokaler MCP-Server"). Die Adressen stehen zum Kopieren auf der Übersicht (Karte „MCP-Adressen"). Wer keine MCP-Einrichtung möchte (oder zusätzlich einen schnellen Weg braucht), nutzt den Kontext-Chip.

Kontext-Chip ⌃⌥C

Der schnellste Weg ganz ohne Einrichtung: In den Einstellungen aktivierbar (Sektion „Kontext-Chip", Standard aus) öffnet die Tastenkombination ⌃⌥C (unter „Tastenkombination" anpassbar — eine Änderung wirkt erst nach einem Neustart von SideBrain) ein kleines Panel mit passenden Notizen zum gerade aktiven Fenster. SideBrain liest dafür den Titel des Vordergrund-Fensters (macOS fragt dazu einmalig nach der Automation-Berechtigung unter Systemeinstellungen → Datenschutz & Sicherheit); ohne diese Berechtigung bleibt das Themenfeld leer und zeigt einen Hinweis — du tippst das Thema dann einfach selbst ein. Das erkannte (oder eingetippte) Thema bleibt jederzeit editierbar. „Suchen" durchsucht alle verbundenen Brains im Verbund; die Treffer erscheinen mit Brain-Chip und Snippet in der Reihenfolge des Engine-Rankings — die Anzeige selbst zeigt keinen Zahlen-Score. Ein Klick auf eine Notiz öffnet sie im Brain-Explorer, „Alle kopieren" legt die komplette Trefferliste als Markdown-Block in die Zwischenablage — bereit zum Einfügen in Claude, ChatGPT oder jeden anderen Chatbot. Bei aktiviertem Feature erscheint der Kontext-Chip zusätzlich als Eintrag im Menüleisten-Symbol.

Datenschutz: Der Fenstertitel wird nie protokolliert oder gespeichert; die Suche schickt das Thema ausschließlich als Anfrage an deine eigenen Brains. Eine app-spezifische Ausschlussliste hat der Kontext-Chip nicht — die gibt es beim Kontext-Agenten.

MCP-Kontext-Tool

Für externe KI-Clients, die sich per MCP verbinden (Claude, Codex, jeder MCP-Host): In den Einstellungen aktivierbar (Sektion „MCP-Kontext-Tool", Standard aus) bietet der SideBrain-MCP-Server dann zusätzlich das Werkzeug context_for an. Der Assistent ruft es mit einem Thema auf, SideBrain durchsucht dafür alle verbundenen Brains im Verbund und liefert die Trefferliste direkt als fertigen Prompt-Kontext zurück — einen Markdown-Block plus eine strukturierte Liste je Notiz (Titel, Brain, Slug, Snippet). Auch hier: kein Zahlen-Score, die Reihenfolge der Treffer ist die Relevanz. Ist ein Brain gerade nicht erreichbar, sagt der Kontext das ehrlich statt einfach nichts zu finden. Die Einstellung wirkt sofort für neue MCP-Anfragen, ganz ohne Neustart. Wer die App per Skript statt per Assistent anspricht, nutzt dieselbe Suche unabhängig vom Toggle über --context-for "Thema" (Details im Abschnitt „MCP für Entwickler").

Kontext-Agent

Der dritte Baustein läuft ganz von selbst, ohne dass du etwas anstoßen musst: In den Einstellungen aktivierbar (Sektion „Kontext-Agent", Standard aus) beobachtet SideBrain danach automatisch den Titel deines aktiven Fensters (Abfrage-Intervall 1/3/5/10 Sekunden, einstellbar) und prüft bei einem Fensterwechsel — nach einer kurzen Beruhigungsphase — automatisch alle verbundenen Brains zum neuen Thema. Findet sich mindestens eine passende Notiz, kommt eine stille Notification ohne Ton: „{n} Notizen zu ›Thema‹" — ist zusätzlich der Kontext-Chip aktiviert, ergänzt SideBrain den konfigurierten Shortcut als Klartext (z. B. „ctrl+alt+c") für Details; ohne aktivierten Kontext-Chip bleibt dieser Zusatz weg. Eine Ausschlussliste (Bundle-IDs, vorbelegt mit gängigen Passwort-Managern) sorgt dafür, dass sensible Apps nie angesehen werden — SideBrain selbst schließt sich dabei automatisch aus. Der jeweils letzte erfasste Kontext liegt lokal in einer Cache-Datei und ist bei aktiviertem MCP-Kontext-Tool zusätzlich über das Werkzeug latest_context abrufbar (frisch = jünger als 60 Sekunden). Das Einschalten zeigt zuerst einen Bestätigungsdialog mit dem Datenschutz-Hinweis unten — nur bei Zustimmung aktiviert sich der Agent; der Toggle selbst wirkt sofort, kein Neustart nötig.

Datenschutz (der Bestätigungsdialog beim Einschalten sagt es genauso): SideBrain erkennt dann laufend deine aktive App und den Fenstertitel — nur lokal, nie protokolliert. Das jeweils aktuelle Thema wird automatisch als Suchanfrage an deine eigenen Brains geschickt, genau wie bei jeder anderen Suche; der letzte Kontext liegt lokal im Cache (wird beim Ausschalten gelöscht — auch nachgeholt, falls SideBrain zwischenzeitlich neu gestartet wurde). Apps auf der Ausschlussliste sind ausgenommen. Ergänzend, ehrlich: Für den allerersten Poll fragt macOS einmalig nach der Automation-Berechtigung (Systemeinstellungen → Datenschutz & Sicherheit) — ohne sie tut der Agent still gar nichts. Eine ausgelöste Notification bleibt wie jede macOS-Notification im Mitteilungszentrum sichtbar, das erkannte Thema darin eingeschlossen. Es gibt keinen Zahlen-Score als Schwelle — die Meldung kommt ab dem ersten Treffer, konsistent mit Kontext-Chip und MCP-Kontext-Tool.

Claude Desktop & Cowork

Der schnellste Weg: Ein-Klick-Einrichtung unter Einstellungen → Integrationen → „In Claude Desktop einbinden" — SideBrain schreibt den Eintrag in die Claude-Desktop-Konfiguration; danach Claude Desktop neu starten. Alternativ manuell in der claude_desktop_config.json:

"mcpServers": {
  "sidebrain": {
    "url": "http://127.0.0.1:8765/mcp"
  }
}

Danach stehen die SideBrain-Werkzeuge in jedem Gespräch bereit: „Such in meinem Brain nach dem Stadtwerke-Angebot", „Leg diese Zusammenfassung als Notiz ab" oder „Was weiß mein Brain über Anna Schmidt?" — Claude ruft Suche, Think und Push selbst auf. Bei mehreren Brains sieht Claude auch think_all (alle Brains parallel, Quellen je Brain) und je Brain ein think_<name>-Tool — „frag alle meine Brains" funktioniert damit wörtlich. Cowork-Agenten nutzen dieselbe Anbindung und können so recherchieren und Ergebnisse zurück ins Brain schreiben.

Claude Code (Terminal)

Ein Befehl registriert SideBrain als MCP-Server für Coding-Sessions:

claude mcp add --transport http sidebrain http://127.0.0.1:8765/mcp

Damit kann Claude Code während der Arbeit euer Brain befragen (Projektentscheidungen, Kontext zu Kunden/Systemen) und Erkenntnisse als Notizen ablegen. Der Skill kennt zusätzlich --think-all: eine Frage an alle hinterlegten Brains parallel, mit Brain-Zuordnung je Quelle. Der exportierbare Skill (Einstellungen → Integrationen) liefert zusätzlich eine SKILL.md, die Agenten-Setups den Umgang mit den Werkzeugen erklärt.

ChatGPT

ChatGPT unterstützt eigene MCP-Konnektoren (Einstellungen → Konnektoren, Entwicklermodus). Wichtig: ChatGPT läuft in der Cloud und erreicht 127.0.0.1 auf eurem Mac nicht — der Konnektor braucht einen aus dem Internet erreichbaren Endpunkt:

• Team-Brain: Läuft euer gbrain als zentraler Endpunkt (eigener Server), tragt dessen URL direkt als Konnektor ein — der natürliche Weg für Unternehmens-Setups.
• Lokales Brain: Nur über einen von euch kontrollierten Tunnel erreichbar machen (VPN/Tailscale o. ä.) — bewusst abwägen, ob ihr das wollt; ohne Tunnel bleibt das lokale Brain für ChatGPT unerreichbar.

Stand Anfang 2026 — die Konnektor-Funktionen der Anbieter ändern sich laufend; maßgeblich ist deren aktuelle Dokumentation.

Codex

Auch hier gibt es die Ein-Klick-Einrichtung (Einstellungen → Integrationen → „In Codex einbinden") — sie trägt den SideBrain-stdio-Befehl in die Codex-Konfiguration (~/.codex/config.toml) ein. Codex-Sessions können danach das Brain durchsuchen und befüllen, mit denselben Werkzeugen wie Claude.

Andere MCP-Clients & eigene Agenten

Jedes Werkzeug, das MCP über Streamable HTTP spricht (Cursor, LM Studio, eigene Agenten-Frameworks), verbindet sich mit der lokalen URL http://127.0.0.1:8765/mcp; Clients, die Prozesse selbst starten, nutzen den stdio-Befehl von der Übersicht. Lese-/Schreibrechte folgen dem Token-Scope des jeweiligen Brains — ein Assistent mit Lese-Token kann suchen und fragen, aber nichts verändern.

Import & Export

Markdown-Ordner / Obsidian

Einen ganzen Ordner (z. B. Obsidian-Vault) importieren — jede Datei durchläuft die normale Pipeline, Fortschritt wird live angezeigt.

Notizen.app

Apple-Notizen (optional ein einzelner Ordner) werden lokal per AppleScript exportiert und wie ein Vault importiert. Braucht einmalig die Automatisierungs-Freigabe; alle Zeitüberschreitungen sind hart begrenzt, damit eine fehlende Freigabe nie die App einfriert.

ZIP-Export

Das gesamte Brain als ZIP aller Markdown-Notizen — vollständige Datenhoheit, jederzeit.

Antwort-/Digest-Export

Einzelne Antworten und der Rückblick lassen sich als Markdown-Datei nach Downloads exportieren.

Wartung & Diagnose

Diagnose

Einstellungen → Lokales Brain → „Diagnose" führt den Gesundheits-Check des Brains aus und zeigt den Gesundheitswert samt auffälliger Punkte mit Fix-Hinweisen. Read-only.

Schema-Panel

Zeigt das aktive Schema-Pack (Typen, Beziehungstypen), die Typ-Verteilung der eigenen Seiten und die Orphan-Prüfung. Read-only.

Verlauf

Jeder Push wird protokolliert (Status, Methode, Zeichen) — mit Textsuche, Status-Filter und Detail-Ansicht; Einträge lassen sich mitsamt Brain-Seite löschen.

Wiedervorlage-Queue

Scheitert ein Push (Brain offline, Netzwerkfehler), erscheint er sichtbar mit Fehlergrund in einer eigenen Wiedervorlage-Liste im Verlauf — kein stiller Verlust. „Erneut senden" funktioniert einzeln und für alle auf einmal; erfolgreiche Einträge verschwinden automatisch. Die Queue übersteht einen Neustart der App.

Verständliche Fehler

Die häufigsten Fehlerbilder werden übersetzt statt roh angezeigt: Brain belegt, fehlende Token-Rechte, Brain nicht erreichbar, fehlender Modell-Zugang — jeweils mit dem nächsten sinnvollen Schritt.

Support-Paket

Diagnose-Bundle für Fehlerberichte als ZIP unter ~/Downloads/SideBrain-diagnose-YYYY-MM-DD-HHMM.zip: meta.json mit App-/OS-Version und Zeitstempeln, recent.log mit den letzten 200 Verlaufs-Einträgen, config.redacted.json mit der Konfiguration (Secret-Felder wie api_key, token, *_password stehen als <REDACTED> drin, der Rest ist lesbar), cache-stats.json mit Cache-Größe und Anzahl ohne Inhalte. Die Datei bleibt auf dem Gerät — der Nutzer entscheidet, ob er sie anhängt oder mailt.

Tastaturkürzel

Release-Historie

Jede veröffentlichte Version seit dem ersten Meilenstein — neueste zuerst. Details zu jeder Version stehen im Änderungsprotokoll der App.

Diese Dokumentation wird mit jedem Feature-Release fortgeschrieben — neue Funktionen erscheinen hier im passenden Kapitel und in dieser Historie.