Il manuale di SideBrain

panoramica

SideBrain trasforma documenti, e-mail e note in conoscenze discutibili, localmente sul Mac, presso il tuo endpoint AI.

SideBrain è composto da tre parti fornite insieme come un'unica app:

• L'app — Icona della barra dei menu, panoramica, Brain Explorer, chat e finestre per note rapide, sovrapposizione di domande e accompagnamento agli appuntamenti.
• Il motore — elabora ogni file immesso: estrae testo, determina titolo/tipo/data utilizzando l'intelligenza artificiale, genera anteprima, scrive al cervello. Funziona con un runtime Python incluso; non è necessario reinstallare nulla.
• Il cervello (gbrain) – il magazzino della conoscenza. O completamente localmente sul Mac (PGLite, senza server) o come endpoint remoto condiviso da un team. Il contenuto è disponibile come pagine Markdown con tipi, tag e collegamenti.

Termini fondamentali

Cervello

Un repository di conoscenza (endpoint gbrain). È possibile memorizzare più cervelli in parallelo, ad es. B. un cervello locale privato e un progetto condiviso.

Spingere

Il processo di trasferimento del contenuto in Brain: file feed → estrazione → anteprima → conferma → salvato.

Nota/Pagina

Un'unità nel cervello: contenuto Markdown più tipo, titolo, tag, data e collegamenti. Indirizzato tramite una stalla Lumaca.

tipo

Categorie canoniche come person, company, deal, event, project, note, email, source — suggerito dall'IA, può essere annullato nell'anteprima.

Pensare

Una domanda per il cervello: le note rilevanti vengono cercate, ordinate e fornite al modello AI come contesto; la risposta cita le sue fonti.

Profilo dell'IA

L'accesso al modello archiviato (provider, endpoint, chiave) con cui funzionano l'estrazione e le risposte.

Linguaggio della superficie

SideBrain parla tedesco, inglese, francese, italiano e spagnolo. La lingua di sistema del Mac viene riconosciuta automaticamente (fr-*, it-*, es-* scegliere la lingua appropriata; qualsiasi altra lingua non tedesca rimane l'inglese) — il commutatore di lingua nelle impostazioni cambia manualmente e immediatamente in qualsiasi momento, senza riavviare. La barra dei menu e le finestre secondarie mobili (nota rapida, chip di contesto, accompagnamento dell'appuntamento) seguono un'esplicita scelta linguistica; Le notifiche lato sistema (revisione, voci in scadenza, report pianificati) rimangono invariate.

Installazione e configurazione

Due modi, un risultato: SideBrain viene fornito con il suo intero runtime: nessun homebrew, nessun Python, nessuna dipendenza.

Tramite immagine disco

Carica SideBrain.dmg, apri, trascina SideBrain nella cartella Applicazioni, avvia. Poiché l'app viene consegnata senza autenticazione Apple, macOS richiede un clic con il tasto destro → "Apri" (Gatekeeper) al primo avvio.

Tramite terminale

Un comando carica e installa la versione corrente: la deviazione del gatekeeper viene automaticamente eliminata:

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

Requisito: un Mac con Apple Silicon (M1 o successivo). Una versione per Windows (x86_64) è disponibile — vedi la sezione Windows qui sotto. I Mac Intel e Linux non sono attualmente previsti.

Windows (x86_64): tramite installer

Per Windows 10 (dalla 1809) e Windows 11 è disponibile un installer NSIS proprio, firmato con Authenticode. Carica l'installer, fai doppio clic, segui la procedura guidata NSIS (percorso predefinito %LOCALAPPDATA%\Programs\SideBrain, installMode: currentUser — nessun amministratore, nessuna richiesta UAC necessaria). Il primo avvio richiede, a seconda della configurazione del computer, una conferma di fiducia SmartScreen una tantum ("Ulteriori informazioni" → "Esegui comunque") — normale per software firmato che non ha ancora accumulato reputazione nell'indice SmartScreen.

Aggiornamento: l'aggiornamento automatico integrato controlla all'avvio il feed https://dl.sidebrain.eu/latest.json (chiave platforms.windows-x86_64), verifica la firma e installa automaticamente le nuove versioni. Aggiornamento manuale: basta ricaricare l'ultimo .exe ed eseguirlo — SideBrain sostituisce la versione precedente senza perdita di dati.

Limitazioni note su Windows

Il port Windows condivide le funzioni principali con macOS e Linux. Per rendere chiaro cosa funziona e cosa no, l'app mostra un messaggio di disponibilità onesto per ogni fonte specifica della piattaforma, invece di fallire silenziosamente o lasciare un pulsante morto senza spiegazione:

• Cattura da iPhone (cartella iCloud come cartella monitorata): su Windows il pulsante "Configura cattura da iPhone" si collega esattamente alla stessa pipeline di cartella monitorata di macOS — al posto del contenitore iCloud di macOS viene monitorata la cartella iCloud per Windows %USERPROFILE%\iCloudDrive. Se iCloud per Windows non è installato, l'app lo segnala onestamente ("iCloud per Windows non è installato — installalo dal Microsoft Store e accedi con il tuo Apple ID") invece di ingoiare l'errore.
• Accompagnamento appuntamenti ("Accompagna appuntamento"): solo macOS — dipende da Calendar.app e dall'audio di macOS. Nessun equivalente su Windows v1; il pulsante nella panoramica è disattivato (grigio) e il tooltip rimanda a screenshot e note di testo libero come alternativa. Un registratore di riunioni per Windows è previsto come progetto separato, non fa parte di questa release.

Configurazione iniziale (onboarding)

Quando lo avvii per la prima volta, un assistente ti guida attraverso la configurazione in quattro passaggi: Benvenuto · Il tuo cervello · AI · Prima spinta:

1. Il tuo cervello: "Su questo Mac" configura un Brain locale (consigliato per iniziare; installa gbrain incluso il runtime). In alternativa, "Remote Brain" collega un endpoint del team esistente tramite URL e token.
2. Ricerca locale (consigliata, può essere deselezionata): Se lo si desidera, è possibile impostare una ricerca semantica completamente locale per Brain locale: un server lama in bundle con un modello di incorporamento multilingue (bge-m3) e Reranker, download una tantum da ~880 MB.
3. IA: Quattro livelli tra cui scegliere:
   • Propria chiave antropica - migliore qualità, accesso diretto a Claude.
   • Inizia gratuitamente — Accesso con un clic a OpenRouter o LLM Gateway; Modelli gratuiti per rispondere, senza alcun costo per te.
   • Completamente offline — il modello locale incluso (~3,2 GB una tantum) risponde completamente alle domande sul Mac. Buono per domande chiare e concrete, notevolmente più lento (~ 3-4 s per risposta) e inferiore alle complesse considerazioni di un modello cloud - l'assistente lo dice onestamente.
   • Inizia senza chiave — prima basta raccogliere; Le funzioni AI possono essere aggiornate in qualsiasi momento.
4. Prima spinta: Trascina un file, controlla l'anteprima, applica – fatto.

Se la configurazione è stata saltata o non viene memorizzato alcun cervello utilizzabile in seguito, SideBrain offre nuovamente la configurazione guidata all'avvio.

Aggiornamenti

SideBrain si aggiorna da solo: il programma di aggiornamento integrato verifica dl.sidebrain.eu, carica gli archivi di aggiornamento firmati e li installa dopo la conferma. Ogni versione è disponibile anche come DMG nell'archivio download.

Disinstallare

Impostazioni → "Rimuovi SideBrain" elimina completamente l'app, incluse le azioni rapide, i servizi e le impostazioni del Finder. Se lo si desidera, i dati del cervello vengono conservati e sono accessibili in anticipo esportare come ZIP.

Cattura la conoscenza

Ogni fonte di acquisizione confluisce nella stessa pipeline: convalida → estrazione → plausibilità → anteprima → push. Nessun percorso speciale, lo stesso comportamento affidabile ovunque.

Formati supportati

• Documenti: PDF, Word, Excel, PowerPoint, Keynote, Pages, Markdown, file di testo normale
• E-mail: File .eml (ad esempio estratti da Mail/Outlook): oggetto, mittente e data vengono riconosciuti
• Immagini: Schermate e foto con contenuto testuale (l'estrazione della visione trascrive e classifica)
• Audio: m4a, mp3, wav — trascritto localmente
• Rete: URL: il testo della pagina viene letto e archiviato come fonte citabile
• Testo libero: riguardo al Nota veloce o il menu di condivisione

Premi anteprima e conferma

Prima di ogni pressione, SideBrain mostra cosa verrebbe salvato: nulla finisce nel cervello senza controllo:

• Titolo, tipo e data l'IA suggerisce dal contenuto (invece di “Immagine (3)” un titolo significativo; invece di push date la data effettiva del documento). Il tipo può essere sovrascritto utilizzando un interruttore.
• Modifica contenuto: Il testo estratto può essere corretto direttamente prima di essere accettato.
• Campo contesto: Viene salvata anche una frase della tua classificazione ("appartiene al Progetto Nordstern").
• Stella importante: Contrassegna la nota come priorità, preassegnata dall'IA per decisioni e scadenze. Le note importanti hanno la priorità nella ponderazione della rilevanza del cervello.
• Saltare scarta la spinta; Se è attivato il push automatico, l'anteprima viene adottata automaticamente allo scadere di un periodo di tempo regolabile.

Guarda le cartelle

È possibile monitorare qualsiasi cartella: ogni file archiviato viene aggiunto automaticamente. L'impostazione predefinita è ~/SideBrain Inbox arredato.

• Con conferma (Predefinito): il file passa attraverso l'anteprima normale.
• Spinta automatica: Il file viene trasferito direttamente senza richiesta: cartelle in cui va comunque solo ciò che desideri.
• Cervello target per cartella: Se hai più cervelli, puoi scegliere un obiettivo diverso per ciascuna cartella: "tutto da questa cartella entra nel cervello del team, il resto rimane locale". Le cartelle con destinazioni diverse vengono eseguite come sessioni separate in modo che ogni file finisca in modo sicuro nel cervello giusto.

Nota veloce ⌥N & Schermata

L'icona della barra dei menu (e il collegamento ⌥N) apre una piccola finestra mobile per i pensieri intermedi: digita il testo, inserisci, salva. “Ritaglio schermo…” nel menu avvia la selezione dell'area interattiva di macOS; Lo screenshot passa quindi alla normale estrazione della visione inclusa l'anteprima.

Memo vocali (file audio)

I file m4a, mp3 e wav vengono inviati come qualsiasi altro file: SideBrain li trascrive prima completamente locale (incluso modello Voxtral, stessa infrastruttura Trascrizione dell'appuntamento) e quindi invia il testo attraverso la normale pipeline. Le rigorose istruzioni di trascrizione assicurano che la trascrizione venga eseguita parola per parola anziché riassunta: i numeri e le istruzioni nell'audio rimangono intatti. Nessun audio lascia il Mac.

Requisito: è installato il modello della lingua locale (~3,2 GB una tantum, vedere Trascrizione dell'appuntamento). Senza un modello, il push segnala il motivo invece di fallire silenziosamente.

Acquisizione dell'iPhone

Impostazioni → Cartelle controllate → “Imposta monitoraggio iPhone” crea una cartella SideBrain-Erfassung in iCloud Drive e lo monitora. Insieme a un collegamento Apple una tantum (menu Condividi → Salva file in questa cartella), foto, collegamenti, testi e memo vocali dell'iPhone finiscono automaticamente nel Brain - memo vocali con trascrizione locale. Le istruzioni dettagliate per il collegamento sono incluse nell'app.

Altri metodi di registrazione

Azione rapida del Finder

Fare clic con il tasto destro su ciascun file → “SideBrain”. Nessuna apertura, nessuna trazione necessaria.

Trascina e rilascia

Trascina i file nella finestra principale, nella finestra di chat (lì in aggiunta, senza finestra di anteprima) o nella finestra dell'appuntamento.

Menù Servizi “Invia a SideBrain”

Testo o collegamento evidenziato in qualsiasi app → fare clic con il pulsante destro del mouse → Servizi → “Invia a SideBrain”. Un URL puro (contrassegnato anche tra virgolette, parentesi angolari o con segni di punteggiatura alla fine) viene inviato come nota di collegamento con il contenuto della pagina letto; tutt'altro che una breve nota. Feedback tramite messaggio: nessuna finestra interrompe il flusso.

Stampa → SideBrain

Salva come nota PDF da qualsiasi app utilizzando la finestra di dialogo di stampa, anche dove non è disponibile l'esportazione.

Doppio clic/"Apri con"

SideBrain è registrato come destinazione per i PDF.

Schema URL

sidebrain://push?path=… spinge un file fuori da scorciatoie e script - vedi automazione.

Importazione di Notes.app

Adotta Apple Notes esistente come inventario - vedi Importa ed esporta.

Estrazione e struttura

SideBrain non si limita a memorizzare il testo: crea una struttura in modo che i file diventino contesto.

• Tipi canonici: Ogni nota ottiene un tipo (person, company, deal, event, project, concept, note, email, source …). I curriculum e i profili LinkedIn vengono salvati automaticamente come person riconosciuto; Offerte, appalti e contratti come deal; riunioni come event - ciascuno con quelli veri event_date per la tempistica.
• Evitare i duplicati: Atterra sulla stessa persona o azienda uno Pagina, anche se proviene da file diversi: le entità esistenti vengono riutilizzate invece di creare duplicati del suffisso hash.
• Collegamento automatico: Se una nota menziona persone o aziende già esistenti in Brain, viene creato automaticamente un bordo del grafico ("menzionato") - conservativo (nomi completi, confini delle parole), il testo rimane invariato.
• Traguardi della sequenza temporale: Le tappe fondamentali datate nel documento (go-live, scadenza, kickoff) vengono create come voci della sequenza temporale.
• Linea di origine: Ogni file/nota di posta elettronica termina con “Fonte: …” (origine + data) — la provenienza fa parte del contenuto e può quindi essere citata.
• Filtro rumore: Le estrazioni quasi vuote (ad esempio screenshot senza testo) ricevono il tag braucht-nacharbeit, invece di finire inosservato come una pagina bianca.
• Estrazione dei fatti (opt-in, sperimentale): Se lo si desidera, l'intelligenza artificiale crea un blocco di fatti strutturato per fatti chiari e permanenti, da cui il cervello costruisce una tabella dei fatti, la base per Traiettorie e mirato Dimenticare.
• Rilevamento successivo: Se in un documento c'è un punto temporale ("Offerta scaduta entro il 15 agosto", "Periodo di cancellazione: 30 settembre"), SideBrain lo nota - puramente basato su regole, senza chiamata AI, salvato solo localmente. I punti dovuti appaiono sul Panoramica e segnalare una volta tramite messaggio.

Domande e risposte

Ogni risposta si basa esclusivamente sul tuo cervello e cita le sue fonti, senza fatti inventati.

“Chiedi al tuo secondo cervello” (panoramica)

Il pannello delle domande nella panoramica risponde alle domande in linguaggio naturale. La risposta mostra i chip sorgente cliccabili (aprire la nota in Brain Explorer), le lacune riconosciute nella conoscenza come riferimento separato con un salto al Incremento della qualitàe i riferimenti nel testo della risposta passano direttamente alla nota collegata. Le domande possono essere poste nella stessa conversazione (⌘ ⏎ invia).

Verbund: una domanda per tutti i cervelli

Se hai memorizzato più cervelli, seleziona l'opzione nel pannello delle domande e nella chat "Tutti i cervelli (composito)": La domanda corre parallela su ogni Cervello collegato, le risposte appaiono come una vista con una sezione per Cervello. Ogni chip sorgente ha il nome del suo cervello: un clic apre la nota nel cervello corretto (l'esploratore passa lì automaticamente). Un Cervello irraggiungibile appare come una breve nota nella sua sezione senza nascondere il resto delle risposte.

Chiacchierata

La scheda chat è la finestra di conversazione a tutti gli effetti con Brain:

• Cronologia delle conversazioni rimane intatto durante il cambio pilota; Il cervello in questione è selezionabile in alto e ne mostra lo stato e il numero di pagina - con una chiara indicazione se il cervello attivo è vuoto o non accessibile.
• Allegati: I file aggiunti utilizzando il pulsante degli allegati o tramite drag & drop vengono caricati in modo permanente nel cervello e sono immediatamente disponibili come contesto per la conversazione.
• Feedback sulla correzione: "Pollice in giù" sotto una risposta apre un campo per una nota di correzione, che viene spinta nel cervello per l'ottimizzazione - eventualmente con file esplicativi.
• Esportare: Ogni risposta può essere salvata come file Markdown (domanda, risposta, elenco di fonti) nei download, pronto per il documento della riunione.

Sovrapposizione di domande ⌥Spazio

La scorciatoia apre una finestra mobile sopra tutto: digita una domanda, leggi la risposta con le fonti, continua a lavorare, senza aprire l'app o modificare il contesto. Anche tramite sidebrain://ask?q=… accessibile da scorciatoie.

Modelli di domande

Proprie domande con un clic (Impostazioni → "Modelli di domande"): salva etichetta + domanda, ad es. Per esempio. “Revisione settimanale” → “Riassumi ciò che ho aggiunto questa settimana”. I modelli salvati sostituiscono le domande di esempio integrate nella panoramica.

Incremento della qualità: colmare le lacune della conoscenza

L'intelligenza artificiale trova domande specifiche in base alle lacune del tuo cervello e te le pone una dopo l'altra: impieghi 5, 10 o 15 minuti, le tue brevi risposte ritornano direttamente nel tuo cervello come appunti. “Gap rilevato” diventa “Gap chiuso”. Funzionamento con visualizzazione dell'avanzamento, salto e ⌘ ⏎.

La panoramica

La visualizzazione Home raggruppa cifre chiave, promemoria e tutto ciò che il cervello ha da dirti in modo proattivo. Le carte appaiono solo se hanno dei contenuti, nessuna casella vuota.

Figure chiave e stato del cervello

Push (7 giorni/totale), percentuale di successo, personaggi trasferiti; accanto c'è il cervello attivo con il tipo di motore (locale/remoto), numero di pagina, versione di gbrain e nota di aggiornamento.

Stato della privacy

Mostra in tempo reale se l'estrazione, la ricerca e le risposte sono attualmente in esecuzione localmente o tramite un servizio cloud: "prova di uscita" a colpo d'occhio. Onesto anche con operazioni miste.

Revisione (Digest)

Cosa è arrivato a Brain questa settimana (o ogni giorno, regolabile) - con sparkline di attività, nuove note, contatori facoltativi di obiezioni e punti dovuti, esportazione Markdown e notifica di attivazione.

Punti dovuti

Appuntamenti per i prossimi 7 giorni riconosciuti in fase di archiviazione, scaduti contrassegnati in rosso con un pulsante "Fatto". Salvato solo localmente.

Contraddizioni

Conflitti tra le note (ad esempio numeri diversi sullo stesso argomento) con gravità: dall'ultimo controllo delle contraddizioni del cervello, leggendo puramente, un clic apre la nota.

Oggi prima…

Eventi degli anni precedenti che cadono nel giorno di calendario di oggi: ricordare come funzione, non solo come risparmio.

Ho notato qualcosa di insolito

Valori anomali dell'attività statistica (un numero significativamente maggiore di note di un tipo rispetto al solito): possono essere disattivati senza chiamare l'AI, al massimo ~ 2 volte a settimana.

Prossimi appuntamenti

Prossimi appuntamenti del calendario per i prossimi 7 giorni, ciascuno con un pulsante "Accompagna appuntamento", che avvia la finestra dell'appuntamento con titolo e partecipanti. Richiede l'approvazione dell'automazione macOS per il calendario una volta.

Ultima attività

I push più recenti con lo stato; Passa alla cronologia completa con la ricerca testuale e il filtro di stato.

Indirizzi MCP

L'URL HTTP locale del server MCP (clicca copiato) - per l'integrazione in Claude Desktop & Co.

Azioni rapide

Nota rapida, screenshot, accompagnamento dell'appuntamento e bozza direttamente dalla panoramica.

Al primo avvio (ancora nessuna spinta), la panoramica mostra un saluto con tre passaggi fino alla prima spinta invece delle carte vuote.

“Il tuo cervello può fare qualcosa adesso”

Non appena sono state accumulate conoscenze sufficienti - a partire da ~50 inserimenti riusciti in base alla cronologia locale o 14 giorni dopo il primo avvio con questa versione (per gli utenti esistenti di solito si applica comunque la soglia di 50) - la panoramica mostra la mappa una volta “Il tuo cervello può fare qualcosa adesso”. Fai clic su "Mostra domande di esempio", SideBrain chiama l'intelligenza artificiale una volta e genera fino a cinque domande di esempio a cui il tuo cervello ora può rispondere con le sue attuali conoscenze; Clicca su una delle domande e te la farà direttamente. Con il ✕ ("Nascondi") o dopo la generazione la mappa scompare in modo permanente: non tornerà più, non ci saranno notifiche a riguardo e nessuna campagna ricorrente. Il trigger (contatore, data, se già visualizzato) rimane completamente locale sul tuo computer.

Workshop sui documenti: il tuo cervello scrive la prima bozza

Il pulsante "Bozza" nelle azioni rapide che si apre "Laboratorio sui documenti": seleziona prima un modello: l'offerta, il rapporto sullo stato, la lettera al cliente e il riepilogo del progetto sono integrati, così come i tuoi modelli Markdown dalle impostazioni (sezione "Modelli di progettazione"; segnaposto tra parentesi quadre come [Kunde] O [Leistungen]). Quindi descrivi l'ordine in una frase - ad esempio "Offerta per Stadtwerke Musterstadt per la migrazione al cloud, tre fasi, a partire da settembre" - e “Crea bozza” clic. Il Cervello riempie il modello con conoscenze comprovate provenienti da note e fonti; Dove manca la conoscenza, rimane un segnaposto „[offen: …]" stare al posto dei fatti inventati. L'anteprima appare direttamente nell'app, esportazione facoltativa “Come Markdown (.md)” O "Come Word (.docx)" - senza alcun software aggiuntivo, utilizzando le risorse integrate di macOS - il file finisce nei download e viene visualizzato nel Finder. Come per le domande e il dossier del cliente, viene eseguita solo una lunga query alla volta, con un pulsante di annullamento in qualsiasi momento. Una nota in anticipo: il workshop sui documenti fornisce una prima bozza per il lavoro successivo, non elementi di cancelleria finiti o layout di design aziendale.

Esploratore del cervello

L'Explorer è la vista dell'inventario del cervello: cerca, leggi, mantieni, senza una riga di comando.

Cerca e sfoglia

Se sono presenti più Brain, la barra laterale mostra una sezione „Brain": una voce per ogni Brain collegato più „Tutti i Brain (rete)" — un clic cambia il Brain attivo, proprio come tra i dischi nel Finder. SideBrain ricorda l'ultimo Brain scelto anche dopo un riavvio. Nella vista rete, elenco e ricerca vengono eseguiti su ogni Brain collegato, ogni voce porta un chip di origine. L'apertura, la modifica, i tag e i collegamenti agiscono automaticamente sul Brain di origine della nota. La panoramica mostra inoltre la cifra chiave della rete („X di Y Brain raggiungibili · N pagine in totale").

• Ricerca nel testo completo su tutte le note; senza un termine di ricerca le pagine aggiornate più recentemente.
• Barra laterale delle categorie: a sinistra nell'Explorer come nel Finder — „Tutte le note" e le categorie (persone, aziende, progetti, appuntamenti, offerte, concetti, fonti) con il numero di risultati, categorie vuote nascoste. Un clic filtra l'elenco, la selezione rimane invariata passando da una scheda all'altra e cambiando Brain; completamente utilizzabile con Tab e i tasti freccia.
• Elenco a colonne: le note appaiono in colonne come nel Finder — Nome, Tipo e Modificato. Un clic sull'intestazione di colonna Nome o Modificato ordina in senso crescente o decrescente, un'icona a freccia indica la colonna e la direzione attiva; anche le intestazioni di colonna sono utilizzabili da tastiera. La ricerca nel testo completo continua a mostrare gli snippet dei risultati invece delle colonne.
• Tag nella barra laterale: sotto le categorie la barra laterale mostra i tag più usati del Brain attivo, ordinati per frequenza („Mostra altri" per ulteriori). Un clic filtra l'elenco sulle note con quel tag e può essere combinato con la categoria; un nuovo clic rimuove il filtro. Nella vista rete „Tutti i Brain" compare qui una nota che indica che i tag sono disponibili solo per singolo Brain; un Brain del tutto privo di tag non mostra affatto la sezione.
• Anteprima invece della finestra: un clic su una voce dell'elenco mostra la nota direttamente in una terza colonna a destra dell'elenco — titolo, tipo, tag, meta, Markdown reso con [[Wikilinks]] cliccabili e le relazioni („Riferito a" / „Menzionato in") sono disponibili lì, mentre l'elenco rimane visibile e utilizzabile. Così si possono scorrere più note una dopo l'altra senza aprire o chiudere una finestra. Senza selezione l'anteprima mostra uno stato vuoto; con una finestra stretta sostituisce completamente la barra laterale e l'elenco, e un percorso „Torna all'elenco" riporta indietro.
• Completamente utilizzabile da tastiera: freccia su/giù sposta la selezione nell'elenco — l'anteprima segue immediatamente, la riga scorre nell'area visibile. Invio mette a fuoco anche l'anteprima, Esc riporta all'elenco. Tab attraversa barra laterale → elenco → anteprima in un ordine comprensibile, i tasti freccia navigano all'interno della barra laterale (Brain, categorie, tag). Digitando una lettera/l'inizio di una parola si salta con il typeahead alla prima nota corrispondente, ⌘F mette a fuoco la ricerca. La messa a fuoco è ben visibile in entrambi i temi, l'elenco porta ruoli ARIA appropriati per gli screen reader.

Cura e pulisci

Modifica (editor Markdown)

Modifica direttamente titolo, tipo, tag e contenuto con l'interruttore "Modifica/Anteprima": l'anteprima rende Markdown live, compresi quelli selezionabili [[Wikilinks]]. La lumaca rimane stabile, i riferimenti non si rompono; Viene richiesto Annulla con modifiche non salvate. La zona della timeline automatica (riga di origine, trascrizioni) non viene visualizzata nell'editor ed è garantita per essere conservata durante il salvataggio: una nota pieghevole la mostra di sola lettura.

Tag e collegamenti

Rimuovi i tag con ✕ e aggiungili con “+ tag”; Imposta i collegamenti utilizzando "+ collegamento" e rimuovi utilizzando ✕ - direttamente nella vista nota, senza modalità di modifica.

Unisci

Combina due note: il contenuto viene unito, i riferimenti vengono modificati, il duplicato viene eliminato.

Recensione duplicata

SideBrain suggerisce coppie sospettosamente simili (stessa base di lumache, titoli inclusi, titoli fortemente sovrapposti nella stessa categoria). Per ogni coppia scegli quale nota restare; La coppia ricorda permanentemente "Nessun duplicato". Non succede nulla senza un clic.

Dimentica i fatti

Elimina singoli fatti errati o obsoleti dall'elenco dei fatti di una nota senza eliminare la nota: contrassegnati chiaramente e sopravvivono alla ricostruzione.

Pulisci i titoli

Backfill esistente: le pagine con titoli senza significato ("Immagine (3)") ricevono titoli descrittivi derivati dal contenuto - con un'anteprima (vecchio → nuovo) prima dell'applicazione.

Versioni e cestino

Versioni: Il dettaglio della nota mostra le versioni precedenti (ora + anteprima); "Ripristina" ripristina la nota dopo la conferma: lo stato corrente viene salvato come versione; un rollback non comporta mai una perdita di dati. Spazzatura: Le note cancellate rimangono recuperabili per 72 ore.

Grafico, esperti e traiettorie

Visualizzazione grafico

Mappa interattiva dei collegamenti: la nota al centro, relazioni radialmente attorno ad essa, codificate a colori per tipo: riferimenti in uscita solidi, menzioni in entrata tratteggiate. Cliccando su un vicino lo si centra (esplora con il percorso indietro).

Ricerca di esperti

"Chi lo sa?" — Inserisci l'argomento, SideBrain mostra le persone (e le entità) che hanno contribuito maggiormente al Brain con la percentuale di pertinenza. Particolarmente prezioso nel cervello della squadra.

Traiettorie

Le note con le cifre chiave registrate (progetti, accordi) mostrano un elenco cronologico di "sviluppo nel tempo" - ad es. B. Storico del budget e tappe fondamentali.

Dossier cliente

Per il quarto d'ora prima dell'appuntamento con il cliente: Il pulsante "Fascicolo" Quando si apre una persona o un'azienda, viene creato un file a vista unica: una panoramica, le ultime interazioni e i punti aperti come sintesi con le fonti, nonché i fatti registrati e tutti i documenti collegati. Ogni componente si carica individualmente e si degrada da solo; Se uno fallisce (ad esempio perché al momento non è disponibile alcuna sintesi), gli altri rimangono comunque visibili: un componente morto non impedisce mai l'intero dossier. Il dossier si apre come una finestra di dialogo sopra l'Explorer e può essere esportato come file Markdown con un clic (finisce in Download, poi il Finder mostra direttamente il file); un pulsante Annulla termina la creazione in qualsiasi momento. Viene eseguita solo una richiesta lunga alla volta: anche la chat, il pannello delle domande e l'overlay attendono fino al completamento o all'annullamento del dossier. Disponibile anche tramite riga di comando/abilità: --dossier "Name".

Accompagnare gli appuntamenti ⌥T

Una finestra per l'incontro: note, allegati, trascrizioni e partecipanti - quando viene chiusa, viene creata una nota di appuntamento collegata e discutibile.

• Precompilazione dal calendario: Se un appuntamento è attualmente in corso, la finestra del titolo e dei partecipanti prende automaticamente il sopravvento. Dalla scheda panoramica “Prossimi Appuntamenti”, “Accompagnamento agli Appuntamenti” avvia la finestra specificatamente con un appuntamento selezionato per i prossimi 7 giorni.
• Note e allegati: Testo libero più file e screenshot allegati tramite drag & drop: gli allegati vengono inviati e collegati alla nota dell'appuntamento; I partecipanti sono connessi come persone.
• Trascrizione (locale): "Avvia registrazione" trascrive ciò che viene detto completamente sul Mac (Voxtral Mini tramite il server Llama in bundle, 8 lingue incluso il tedesco, una tantum ~3,2 GB, opt-in). Il testo appare live in sezioni e può essere corretto immediatamente. La modifica delle pause vocali e i filtri del silenzio prevengono le allucinazioni; il modello viene caricato solo quando necessario (~4 GB RAM solo durante l'appuntamento). Niente va online.
• Riepilogo dell'evento: Durante la finalizzazione, l'IA combina note e trascrizioni in un'intestazione del protocollo: riepilogo, decisioni, punti in sospeso, ciascuno con persone responsabili e date. Il riepilogo si trova nella parte superiore della nota dell'appuntamento (preferito dalla ricerca), la trascrizione completa va nella zona della sequenza temporale. Se la chiamata dell'IA fallisce, salva senza riepilogo, mai con un blocco.
• Preparazione dell'appuntamento: "Cosa ne sa il mio cervello di tutto questo?" chiede prima dell'appuntamento con titolo + partecipanti come contesto e mostra fatti rilevanti, punti aperti e fonti.
• Il design sopravvive a tutto: Lo stato della finestra viene continuamente salvato localmente e sopravvive ai riavvii delle app e alla chiusura accidentale. I punti aperti rilevati con le date confluiscono nel file Punti dovuti.

L'accesso al calendario richiede l'approvazione di macOS una volta (Preferenze di Sistema › Privacy e sicurezza › Automazione). Senza approvazione, la precompilazione rimane semplicemente vuota: nulla si blocca o si blocca.

Automazione e report

Rapporti pianificati

Domande ricorrenti al Cervello ad un orario prestabilito (Impostazioni → “Rapporti Programmati”): es. B. “Stato del progetto Nordstern, settimanale lunedì ore 8”. All'ora impostata verrà visualizzata una notifica, la risposta, incluso l'elenco delle fonti, è disponibile come file Markdown in Download. "Prova ora" controlla immediatamente un rapporto. Ogni rapporto è una decisione consapevole (domanda + pianificazione creata da te): SideBrain non pianifica mai da solo le chiamate AI a pagamento.

Rapporto sulla conoscenza invece della domanda: Per ciascun rapporto pianificato, scegli il tipo: "Rapporto sulle domande" (come sopra) o “Rapporto conoscitivo”. Non riporta una domanda posta, ma il tuo cervello stesso: inventario, nuovo/aggiornato (totale e per tipo, i cinque aumenti maggiori), domande poste dall'app (contate localmente - chat, panoramica, sovrapposizione di domande, dossier cliente, workshop documentale; le domande di MCP/clienti con competenze esterne non contano) e contraddizioni aperte, ciascuna rispetto al periodo precedente (il primo rapporto non aveva ancora il periodo precedente), oltre a un breve paragrafo "È successo, fatto" dal tuo cervello. Se manca un blocco, viene visualizzato "non disponibile" - il rapporto arriva comunque. Consegna come qualsiasi report (notifica + file Markdown, Teams/Slack opzionale); "Prova ora" funziona anche per il rapporto conoscitivo senza che venga inserita una domanda. Il conteggio delle domande rimane interamente locale (60 giorni), senza telemetria.

Facoltativamente, pubblica su Teams o Slack: Uno per rapporto (e quando si guarda indietro). URL del webhook in entrata deposito: l'indirizzo che Teams emette in "Aggiungi connettore" o "Flussi di lavoro" o Slack in "Webhook in entrata" per un canale. Se viene inserito un URL, SideBrain pubblicherà all'ora stabilita una versione abbreviata (max. 3.000 caratteri) oltre alla notifica, indicando che il report completo si trova in SideBrain. URL "Flussi di lavoro" di Teams (logic.azure.com) SideBrain riconosce e formatta automaticamente il messaggio come una Scheda Adattiva; tutti gli altri target (connettori Slack, Mattermost, classici Teams) ottengono JSON in testo semplice. L'ultimo stato di consegna di ogni report è direttamente nelle impostazioni; “Prova ora” controlla anche la consegna. Solo il contenuto del report ordinato autonomamente va all'URL immesso autonomamente: nessuna telemetria, nessun flusso di dati aggiuntivo.

Schema URL sidebrain://

Rende SideBrain incorporabile nelle scorciatoie, nelle automazioni della tastiera e negli script Apple:

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

Revisione (Digest) e Ciclo dei sogni

IL Revisione riassume ciò che è venuto in mente su base giornaliera o settimanale: gli elementi costitutivi (contraddizioni, punti dovuti) possono essere attivati individualmente, notifica come opt-in, esportazione come Markdown. Proprio come con i report pianificati, la recensione può facoltativamente essere pubblicata su un URL webhook Teams/Slack (abbreviato, con un collegamento alla versione completa in SideBrain); "Mostra ora" controlla anche la consegna. IL Ciclo dei sogni (Opt-in) consente al cervello locale di consolidarsi di notte (scansione delle entità, correzioni delle quote, consolidamento della memoria) - al massimo una volta ogni circa 20 ore finché l'app è in esecuzione, più in qualsiasi momento con la semplice pressione di un pulsante con un'opzione di prova.

Connessione AI

SideBrain non ha un modello obbligatorio e non è legato ad alcun fornitore. Tre livelli sono configurabili separatamente: estrazione, risposte e ricerca.

Profili AI (estrazione)

In Impostazioni → Endpoint AI, l'accesso al modello viene archiviato come profili: Claude antropico (direttamente o tramite gateway con il proprio URL di base/token di autenticazione) e Endpoint compatibili con OpenAI con modelli già pronti per OpenAI, Azure OpenAI / AI Foundry, Google Vertex AI, LiteLLM, Ollama, LM Studio, vLLM, OpenRouter e Groq. Sono possibili più profili in parallelo; Regole sul tipo di file assegnare il proprio profilo a determinate desinenze (es. “.pdf → Haiku, Resto → Sonetto”).

Risposte / Sintesi (Pensa)

L'endpoint della risposta può essere selezionato indipendentemente dall'estrazione:

• Claude (predefinito) — utilizza automaticamente il profilo AI compresi i dati di accesso completi (comprese le costellazioni di gateway).
• Compatibile con OpenAI - Qualunque /v1-Entpoint chat con gli stessi modelli di cui sopra.
• SideBrain a livello locale — il modello incluso risponde completamente sul Mac, senza tasto, anche in modalità aereo. È lo stesso modello della trascrizione dell'appuntamento: il download va fatto una sola volta, il server è condiviso.
• Inizia gratuitamente — Accesso con un clic a OpenRouter (modello openrouter/free) o LLM Gateway (credito gratuito).

Ricerca: Incorporamenti e Reanchor

La ricerca semantica del cervello locale è attiva e aperta ai fornitori:

• In bundle localmente (consigliato): Server lama incluso con modello di incorporamento bge-m3 multilingue e bge-reranker-v2-m3: ~880 MB una volta, poi completamente offline. Offerto durante la configurazione e offerto attivamente una volta alle installazioni esistenti.
• In alternativa: Ollama (locale), OpenAI, Azure OpenAI, ZeroEntropy (zembed-1) e Voyage AI, alcuni con dimensioni vettoriali selezionabili (Matryoshka: meno memoria per una precisione leggermente inferiore). Oppure esegui consapevolmente ricerche pure per parole chiave.
• Cambio di modello robusto: Prima di ogni modifica, SideBrain controlla ciò che è necessario: stessa larghezza del vettore: ricalcolo senza perdite; Un'altra dimensione: la ricostruzione con backup automatico. La conferma dice in anticipo quale caso si verificherà.
• Riancoraggio: riordina i risultati della ricerca tramite cross-encoder prima della risposta (leva della qualità): da, locale (in bundle) o ZeroEntropy.

Delega aziendale

SideBrain legge automaticamente il proxy del sistema macOS e lo trasmette a tutte le chiamate di rete (configurazione, estrazione, ricerca, risposte), anche quando il motore viene avviato da Claude Desktop o come server HTTP MCP. NO_PROXY protegge localhost e le eccezioni di sistema. Senza un proxy configurato, non cambia nulla; le configurazioni URL PAC pure non vengono valutate.

Licenza e fase di test

SideBrain rende invisibili le domande sulla licenza durante la fase di test e rimane onesto anche dopo: i tuoi dati rimangono accessibili, solo le nuove conoscenze necessitano di una licenza adeguata.

30 giorni senza chiave di licenza

Il periodo di prova inizia al primo avvio dell'installazione e dura 30 giorni. Durante questo periodo, l'acquisizione, la modifica, la ricerca e tutte le funzioni AI sono completamente disponibili. Non è prevista alcuna attivazione, nessun account e nessun controllo online.

Cosa succede dopo la scadenza

Senza una licenza valida, SideBrain blocca la creazione di nuova conoscenza: nuova acquisizione, scrittura e sintesi AI non sono possibili. La cronologia, la lettura, la ricerca e l'esportazione dei dati esistenti rimangono accessibili. L'app non cancella i propri dati e mostra il motivo del blocco ed entrambe le vie d'uscita.

Licenza di deposito

L'uso privato e non commerciale rimane permanentemente gratuito. Domanda sotto sidebrain.eu/licenza privata Dopo un unico accesso a Google, richiedi una licenza privata, copia la chiave firmata e incollala in SideBrain Impostazioni → Licenza UN. L'esame si svolge quindi completamente offline. L'uso commerciale richiede una licenza commerciale; per questo si prega di contattare vertrieb@incubateit.de.

Lo stesso modello vale per MCP e Skill: la scrittura e la sintesi vengono rifiutate dopo la scadenza senza licenza, ma la ricerca e la consultazione rimangono possibili. I dettagli sono arrivati Contratto di licenza per l'utente finale.

Etichettatura IA UE

SideBrain utilizza l'IA per l'estrazione e le risposte — l'app lo segnala di conseguenza nel piè di pagina.

In conformità con gli obblighi di etichettatura dell'AI Act dell'UE, SideBrain mostra permanentemente nel piè di pagina della panoramica l'immagine ufficiale di etichettatura per i contenuti generati dall'IA. In modalità scura viene invertita automaticamente; un testo alternativo localizzato rende l'etichettatura accessibile anche ai lettori di schermo.

Sicurezza dei dati

Progettato per dati aziendali riservati: elaborati localmente, senza requisiti di account, senza telemetria e, se lo si desidera, dimostrabili offline al 100%.

• Elaborazione locale: L'estrazione e l'indicizzazione del testo vengono eseguite sul dispositivo. Il testo normale e le e-mail vengono sempre estratti localmente; Documenti sul profilo AI memorizzato, con un percorso di fallback locale in caso di errori.
• Stato della privacy: La panoramica mostra in tempo reale e in modo onesto quale livello (estrazione/ricerca/risposte) è attualmente in esecuzione localmente e quale è in esecuzione tramite il cloud.
• 100% offline possibile: Con il cervello locale, la ricerca locale e il modello di risposta locale, l’intera catena di archiviazione → ricerca → risposta funziona senza rete. Un test automatizzato della modalità di volo nella pipeline di sviluppo lo dimostra ad ogni versione: Push + Question funziona in un ambiente senza dati di accesso al cloud.
• Nessuna telemetria: nessuna radio domestica, nessun tracciamento, nessun account obbligatorio.
• Sovranità dei dati: Tutta la conoscenza è disponibile come Markdown e può essere completamente esportata come ZIP in qualsiasi momento, senza vincoli.
• Solo tu decidi dove vanno i prompt: Le chiamate AI arrivano solo all'endpoint configurato e solo quando qualcuno lo chiede o spinge attivamente. Le chiamate AI temporizzate esistono solo dove sono state create esplicitamente (rapporti pianificati).

Licenza: SideBrain è un software proprietario di IncubateIT (EULA sotto sidebrain.eu/license). Ogni installazione viene eseguita completamente senza chiave di licenza per i primi 30 giorni. L'area licenza delle impostazioni controlla una chiave inserita completamente offline (nessun server di attivazione, nessun telefono di casa) e, se è valida, mostra immediatamente nome, email, tipo di licenza (privata/commerciale) e durata - se c'è un problema, un motivo comprensibile senza scartare la voce. Senza chiave, la stessa area mostra il periodo di prova rimanente e il percorso verso una licenza privata permanentemente gratuita. Li ottieni sidebrain.eu/licenza privata: accedi una volta con il tuo account Google, richiedi la chiave, copiala, incollala nelle impostazioni - fatto. La chiave rimane quindi completamente valida offline; Visitando nuovamente la pagina si restituisce esattamente la stessa chiave, non vengono creati duplicati. Anche questo è puramente un punto di riferimento per la conformità, non per un'applicazione tecnica. A partire dai 7 giorni rimanenti, una barra discreta e non modale nella finestra principale integra questo avviso con l'esatto stato rimanente e un percorso con un clic verso la licenza privata gratuita - selezionabile a distanza, ritorna al più presto il giorno successivo e non interrompe mai la registrazione in corso. Se i 30 giorni senza chiave sono scaduti, SideBrain blocca nuove registrazioni, modifiche e tutte le funzioni AI (domande, risposte di gruppo, curatela, aumento della qualità, ecc.) - in modo rigido, senza periodo di grazia. Resta espressamente possibile la lettura e la ricerca di quanto già registrato; Una vista bloccata spiega esattamente questo e offre entrambe le vie d'uscita (inserire la chiave o ottenere una licenza privata gratuita).

Cervelli di squadra e cervelli multipli

Dall'archiviazione personale alla conoscenza condivisa del progetto, con una netta separazione tra i cervelli.

• Endpoint multipli: Qualsiasi numero di profili Gbrain in parallelo (locale + remoto). Un profilo è la destinazione push predefinita; Panoramica, chat ed esploratore consentono al cervello intervistato di scegliere liberamente.
• Connessione di squadra: "Connetti al Team Brain..." nelle impostazioni ti guida durante l'adesione: URL + token dell'operatore, la connessione viene verificata prima della creazione e il Brain privato rimane esplicitamente la destinazione push predefinita. Le autorizzazioni di lettura/scrittura dipendono dall'ambito del token.
• Router del progetto: Le cartelle di controllo possono essere inviate a un cervello diverso: cartella del progetto → cervello del progetto, tutto il resto → cervello privato, ordinato automaticamente.
• Identità affidabile: Il riquadro Cervello mostra il tipo di motore, la versione e il numero di pagina anche senza un token di amministrazione.
• Domande composite: “All Brains (Verbund)” chiede conoscenza privata e aziendale allo stesso tempo - con fonti etichettate per ciascun cervello (vedi Domande e risposte).

MCP per sviluppatori

La tua conoscenza come server del protocollo di contesto del modello: per Claude Desktop, Codex e ogni client MCP.

SideBrain fornisce il suo cervello in due modi:

• Server HTTP locale (HTTP streaming): http://127.0.0.1:8765/mcp — porta impostabile, per impostazione predefinita solo localhost (se si desidera anche raggiungibile in rete, vedi „Mac come Brain-Server in rete"), viene eseguito come processo figlio gestito finché SideBrain è aperto. Accensione/spegnimento, protezione tramite token e stato live nelle impostazioni.
• comando di avvio stdio per i client che avviano i processi da soli (ad es. Claude Desktop): installazione con un clic della configurazione del desktop inclusa.

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

Strumenti disponibili: Push (feed di file/testo), Search and Think: lettura/scrittura in base all'ambito del token. Se sono presenti più Cervelli compaiono anche gli strumenti composti: think_all chiede a tutti i Brain in parallelo (rispondi con sezione e fonti per ogni Brain), e ogni Brain ha il suo think_-Strumento per domande mirate - in modo che l'assistente possa indirizzarsi da solo. context_for (quando attivato Strumento di contesto MCP): fornisce le note appropriate su un argomento da tutti i cervelli collegati come contesto immediato finito; tramite CLI in qualsiasi momento --context-for "Thema" - indipendentemente dall'interruttore. Entrambi i trasporti condividono la stessa spedizione; I server di lunga durata rilasciano il cervello locale quando sono inattivi in modo che l'app e i client MCP non si blocchino a vicenda. Uno esportabile Abilità descrive gli strumenti per i client agente. Se la fase di test di 30 giorni è scaduta senza licenza memorizzata, vale lo stesso blocco dell'app: scrittura e sintesi (push, think/think_all) risposta con un errore strutturato contenente un riferimento alla licenza privata gratuita, la ricerca e la consultazione rimangono possibili senza restrizioni.

Per impostazione predefinita il server HTTP locale risponde a ogni processo sullo stesso Mac — pratico nell'uso quotidiano, ma su un computer con più account utente ogni account raggiunge così il Brain tramite localhost. Nelle impostazioni (sezione „Server MCP locale (HTTP)") è quindi possibile attivare una protezione tramite token Bearer: un clic su „Genera nuovo token" crea un token casuale, che si può visualizzare e copiare. Se la protezione è attiva, ogni richiesta — anche il controllo di integrità — richiede l'intestazione Authorization: Bearer <Token>; senza token o con un token errato il server risponde con 401, senza eseguire alcuno strumento MCP:

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

Protezione disattivata (impostazione predefinita) non cambia nulla nel comportamento odierno — i client esistenti continuano a funzionare senza modifiche. Il comando di avvio stdio non necessita di token: si avvia come processo figlio locale senza accesso alla rete.

Mac come Brain-Server in rete

Per impostazione predefinita il server HTTP locale si collega esclusivamente a 127.0.0.1 — nessun altro dispositivo vi accede. Chi vuole usare consapevolmente un Mac come piccolo Brain-Server per un team (un computer ospita la conoscenza, i colleghi vi accedono dalla LAN) modifica nelle impostazioni, sotto „Server MCP locale (HTTP)", la raggiungibilità: „Tutte le reti di questo Mac" si collega a 0.0.0.0, „Indirizzo IP specifico" a un indirizzo fisso di questo computer. Entrambe le opzioni richiedono obbligatoriamente la protezione tramite token Bearer descritta sopra — viene attivata automaticamente al momento del cambio; non esiste una condivisione in rete senza protezione. La riga di stato mostra poi l'indirizzo effettivamente utilizzabile da copiare (con „Tutte le reti" l'IP LAN del Mac invece di 0.0.0.0) — i colleghi lo inseriscono insieme al token nel loro client, esattamente come descritto sopra.

A dire il vero: il server vive solo finché SideBrain è aperto — se l'app si chiude, anche il Brain del team non è più raggiungibile (nessun daemon, nessun avvio automatico). Al primo avvio con una condivisione in rete, macOS chiede una volta se le connessioni in entrata per SideBrain sono consentite (finestra di dialogo del firewall) — senza conferma il server rimane irraggiungibile per gli altri dispositivi. Un indirizzo IP non valido o non presente su questo Mac viene mostrato dalla riga di stato come un errore chiaro invece di un guasto silenzioso. Nessun TLS in questo passaggio — la condivisione è pensata per la rete locale, non per l'Internet aperto.

Utilizzo di SideBrain negli assistenti AI

Passo dopo passo: il tuo cervello come fonte di conoscenza in Claude, ChatGPT, Codex e altri strumenti - sulla base del server MCP, che viene eseguito localmente finché SideBrain è aperto.

Prerequisito per le seguenti istruzioni MCP: SideBrain è in esecuzione, il server MCP locale è attivo (impostazione predefinita; on/off, porta e stato live in Impostazioni → "Server MCP locale"). Gli indirizzi sono disponibili per la copia nella panoramica (scheda “Indirizzi MCP”). Se non vuoi una configurazione MCP (o hai bisogno anche di un modo rapido), usa il chip di contesto.

Chip di contesto ⌃⌥C

Il modo più rapido senza alcuna configurazione: la combinazione di tasti può essere attivata nelle impostazioni (sezione “Context chip”, standard off). ⌃⌥C (può essere regolato in "Combinazione di tasti" - una modifica ha effetto solo dopo il riavvio di SideBrain) un piccolo pannello con note appropriate per la finestra attualmente attiva. Per fare ciò, SideBrain legge il titolo della finestra in primo piano (macOS richiede una volta il permesso di automazione in Impostazioni di sistema → Protezione e sicurezza dati); Senza questa autorizzazione, il campo dell'argomento rimane vuoto e mostra una nota: dovrai semplicemente digitare tu stesso l'argomento. L'argomento riconosciuto (o digitato) rimane modificabile in qualsiasi momento. “Cerca” cerca tutti i cervelli connessi nella rete; I risultati vengono visualizzati con brain chip e snippet nell'ordine di posizionamento nel motore: l'annuncio stesso non mostra un punteggio numerico. Facendo clic su una nota si apre in Brain Explorer, "Copia tutto" inserisce l'intera lista dei risultati come blocco Markdown negli appunti, pronto per essere incollato in Claude, ChatGPT o qualsiasi altro chatbot. Quando la funzione è attivata, il chip contestuale appare anche come voce nel simbolo della barra dei menu.

Privacy: il titolo della finestra non viene mai registrato o salvato; La ricerca invia l'argomento esclusivamente come query al tuo cervello. Il chip di contesto non dispone di un elenco di esclusioni specifico per l'app: questo è disponibile con Agenti del contesto.

Strumento di contesto MCP

Per client AI esterni che si connettono tramite MCP (Claude, Codex, qualsiasi host MCP): può essere attivato nelle impostazioni (sezione "Strumento contesto MCP", disattivato per impostazione predefinita), il server SideBrain MCP offre quindi anche lo strumento context_for A. L'assistente lo richiama con un argomento, SideBrain cerca tutti i cervelli collegati nella rete e restituisce la lista dei risultati direttamente come contesto di prompt finito: un blocco Markdown più un elenco strutturato per ogni nota (titolo, cervello, slug, snippet). Anche qui: nessun punteggio numerico, l'ordine dei colpi è la rilevanza. Se al momento non è disponibile un cervello, lo dice onestamente il contesto invece di limitarsi a non trovare nulla. L'impostazione ha effetto immediato per le nuove richieste MCP, senza dover riavviare. Chiunque acceda all'app utilizzando uno script anziché un assistente utilizza la stessa ricerca indipendentemente dall'interruttore --context-for "Thema" (Dettagli in Sezione MCP per sviluppatori).

Agente di contesto

Il terzo componente funziona completamente da solo, senza che tu debba avviare nulla: può essere attivato nelle impostazioni (sezione "Context Agent", disattivato per impostazione predefinita), SideBrain monitora quindi automaticamente il titolo della finestra attiva (intervallo di query 1/3/5/10 secondi, regolabile) e quando una finestra cambia - dopo una breve fase di calma - controlla automaticamente tutti i Brain collegati per il nuovo argomento. Se viene trovata almeno una nota adatta, arriva una notifica silenziosa senza suono: "{n} note su 'argomento'" - se è attivato anche il chip di contesto, SideBrain aggiunge la scorciatoia configurata come testo normale (ad esempio "ctrl+alt+c") per i dettagli; Senza un chip di contesto attivato, questa aggiunta viene omessa. Un elenco di esclusione (ID bundle, precompilato con gestori di password comuni) garantisce che le app sensibili non vengano mai visualizzate: SideBrain stesso si esclude automaticamente. L'ultimo contesto acquisito viene archiviato localmente in un file di cache ed è disponibile anche tramite lo strumento quando lo strumento di contesto MCP è attivato latest_context disponibile (fresco = più giovane di 60 secondi). Alla prima accensione viene visualizzata una finestra di dialogo di conferma con la nota sulla protezione dei dati di seguito: l'agente viene attivato solo se sei d'accordo; L'interruttore funziona immediatamente, non è necessario riavviare.

Protezione dei dati (la finestra di dialogo di conferma all'accensione dice la stessa cosa): SideBrain riconosce quindi continuamente la tua app attiva e il titolo della finestra - solo localmente, mai registrato. L'argomento corrente viene automaticamente inviato al tuo cervello come query di ricerca, proprio come con qualsiasi altra ricerca; L'ultimo contesto viene memorizzato localmente nella cache (eliminato allo spegnimento del dispositivo - recuperato anche se nel frattempo SideBrain è stato riavviato). Sono escluse le app presenti nell'elenco di esclusione. Inoltre, onestamente: al primo sondaggio, macOS richiede una volta il permesso di automazione (Impostazioni di sistema → Protezione dati e sicurezza) - senza di esso l'agente non fa nulla. Come qualsiasi notifica macOS, una notifica attivata rimane visibile nel Centro notifiche, incluso l'argomento rilevato. Non esiste un punteggio numerico come soglia: il messaggio arriva dal primo hit, coerentemente con il chip di contesto e lo strumento di contesto MCP.

Claude Desktop e collaborazione

Il modo più veloce: Configurazione con un clic in Impostazioni → Integrazioni → “Integra nel desktop Claude” — SideBrain scrive la voce nella configurazione del desktop Claude; quindi riavviare Claude Desktop. In alternativa manualmente nel file claude_desktop_config.json:

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

Gli strumenti SideBrain sono quindi disponibili in ogni conversazione: “Cerca nel mio cervello l’offerta dei servizi comunali”, “Salva questo riepilogo come nota” o “Cosa sa il mio cervello di Anna Schmidt?” — Claude invoca lui stesso Cerca, Pensa e Spingi. Claude vede anche diversi cervelli think_all (tutti i cervelli in parallelo, fonti per cervello) e per cervello think_strumento: "chiedi a tutto il mio cervello" funziona letteralmente. Gli agenti di cowork utilizzano la stessa connessione e possono effettuare ricerche E Riscrivi i risultati nel cervello.

Codice Claude (Terminale)

Un comando registra SideBrain come server MCP per le sessioni di codifica:

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

Ciò consente a Claude Code di interrogare il tuo cervello mentre lavori (decisioni sul progetto, contesto per clienti/sistemi) e archiviare i risultati come note. Anche l'abilità lo sa --think-all: una domanda a tutti i cervelli memorizzati in parallelo, con assegnazione dei cervelli per fonte. Quello esportabile Abilità (Impostazioni → Integrazioni) ne fornisce anche uno SKILL.md, che spiega le configurazioni dell'agente come utilizzare gli strumenti.

ChatGPT

ChatGPT supporta i propri connettori MCP (Impostazioni → Connettori, Modalità sviluppatore). Importante: ChatGPT funziona nel cloud e raggiunge 127.0.0.1 sul tuo Mac non — il connettore necessita di un endpoint raggiungibile da Internet:

• Cervello della squadra: Se il tuo gbrain viene eseguito come endpoint centrale (server proprio), inserisci il suo URL direttamente come connettore: il modo naturale per le configurazioni aziendali.
• Cervello locale: Rendilo accessibile solo tramite un tunnel che controlli (VPN/Tailscale o simile) - considera consapevolmente se lo desideri; senza tunnel, il cervello locale rimane inaccessibile a ChatGPT.

Dall'inizio del 2026: le funzioni dei connettori dei fornitori cambiano costantemente; La loro documentazione attuale è decisiva.

Codice

Ci sono anche quelli qui Configurazione con un clic (Impostazioni → Integrazioni → “Integra con Codex”) — aggiunge il comando SideBrain stdio alla configurazione del Codex (~/.codex/config.toml) UN. Le sessioni del Codex possono quindi cercare e popolare il cervello utilizzando gli stessi strumenti di Claude.

Altri clienti MCP e propri agenti

Qualsiasi strumento che parla MCP su Streamable HTTP (cursori, LM Studio, framework di agenti personalizzati) si connette all'URL locale http://127.0.0.1:8765/mcp; I client che avviano i processi da soli utilizzano il comando stdio dalla panoramica. I permessi di lettura/scrittura seguono l'ambito del token del rispettivo cervello: un assistente con token di lettura può cercare e chiedere, ma non può modificare nulla.

Importa ed esporta

Cartella Markdown/Ossidiana

Importa un'intera cartella (ad esempio Obsidian Vault): ogni file passa attraverso la normale pipeline, i progressi vengono mostrati in tempo reale.

Applicazione Note

Le note di Apple (opzionalmente una singola cartella) vengono esportate localmente tramite AppleScript e importate come un Vault. Richiede l'approvazione dell'automazione una volta; Tutti i timeout sono limitati in modo che la mancata approvazione non blocchi mai l'app.

Esportazione ZIP

L'intero cervello come un ZIP di tutte le note Markdown: completa sovranità dei dati, in qualsiasi momento.

Esportazione di risposte/digest

Le risposte individuali e la recensione possono essere esportate come file Markdown per i download.

Manutenzione e diagnostica

diagnosi

Impostazioni → Cervello locale → “Diagnostica” esegue il controllo dello stato di salute del cervello e mostra il valore della salute compresi i punti evidenti con suggerimenti fissi. Sola lettura.

Pannello dello schema

Mostra il pacchetto di schemi attivo (tipi, tipi di relazione), la distribuzione dei tipi delle proprie pagine e il controllo orfano. Sola lettura.

Corso

Ogni push viene registrato (stato, metodo, carattere) - con ricerca testuale, filtro di stato e visualizzazione dettagliata; Le voci possono essere cancellate insieme alla pagina Brain.

Errori comprensibili

Le immagini degli errori più comuni vengono tradotte anziché visualizzate grezze: Cervello occupato, Diritti del token mancanti, Cervello non accessibile, Accesso al modello mancante - ciascuno con il successivo passo sensato.

Pacchetto di supporto

Esportazione diagnostica per segnalazioni di errori (configurazione senza segreti, stati di versione).

Scorciatoie da tastiera

Cronologia delle versioni

Ogni versione rilasciata dal primo traguardo: prima la più recente. I dettagli su ciascuna versione possono essere trovati nel registro delle modifiche dell'app.

Questa documentazione viene aggiornata con ogni rilascio di funzionalità: le nuove funzioni appaiono qui nel capitolo appropriato e in questa cronologia.