Per gli agenti e per chi li costruisce
Gli agenti perdono il contesto tra una sessione e l’altra. Non hanno un posto dove tenere note durature, né un’identità propria, né una memoria a lungo termine. blackbear dà loro tutto questo: crittografato, local-first, con attribuzione, e raggiungibile dalla riga di comando bb o come server MCP che il tuo agente sa già usare. Una sola installazione e il tuo agente ha una casa.
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} Ogni sessione di un agente parte da zero. Le finestre di contesto scadono, la cronologia delle conversazioni viene troncata e non c’è un posto privato e duraturo dove conservare ciò che conta. Il tuo agente è brillante per 30 minuti, poi dimentica tutto.
Note, decisioni, preferenze degli utenti, contesto dei progetti: salvati in locale, crittografati e ricercabili. bb file search riporta tutto a galla. Il tuo agente riprende da dove si era fermato, tra sessioni, riavvii e cambi di modello.
Qui gli agenti non sono ospiti. bb profile create dà al tuo un profilo a tutti gli effetti, con una sua chiave di firma per verificarne la paternità. Ogni nota, attività ed evento che scrive porta il suo nome.
Ogni comando supporta --json per un output leggibile dalle macchine. Codici di uscita prevedibili. Gli ID accettano prefissi univoci. Niente HTML da interpretare, niente scraping: solo dati puliti.
La stessa crittografia XChaCha20-Poly1305 dell’app. La chiave della cassaforte non lascia mai il computer. Il cloud vede solo dati cifrati. I pensieri del tuo agente restano suoi, anche nei nostri confronti.
Un database SQLite locale, crittografato a riposo, senza dipendere dal cloud. Funziona offline, su macchine isolate dalla rete, sul tuo runner di CI. La sincronizzazione è esplicita: bb sync quando vuoi.
Note, attività, calendario, fogli, documenti, presentazioni, file: tutto blackbear. Ciò che il tuo agente scrive compare nell’app su qualsiasi dispositivo, attribuito al suo profilo. Stessa cassaforte, stessa crittografia, stessa sincronizzazione.
brew install xavi-group/tap/bb, oppure scarica un binario. macOS, Linux, Windows.
bb auth login apre il browser, dove scegli gli scope da dare alla chiave API di questo computer; poi bb vault unlock. La chiave della cassaforte resta al sicuro nel portachiavi del sistema (un file crittografato sui runner senza interfaccia), quindi ogni comando successivo funziona e basta. Niente variabili d’ambiente, niente richieste ripetute.
bb profile create claude: il tuo agente ottiene un suo profilo e una sua chiave di firma. Ogni sua scrittura ha un autore, e bb profile export-key gli fornisce una chiave in formato SSH per firmare i commit git.
Una riga aggiunge il server MCP: claude mcp add blackbear -- bb mcp (oppure codex mcp add, o qualsiasi client MCP). Oppure chiama bb da qualsiasi sistema di strumenti, function calling o sottoprocesso, con JSON strutturato in entrata e in uscita. Altro su MCP
Apri blackbear su qualsiasi dispositivo e trovi tutto ciò che il tuo agente ha scritto: note, attività, eventi, ognuno attribuito al suo profilo. Modifica qualcosa nell’app, sincronizza, e la CLI vede le tue modifiche. Persona e agente condividono un solo spazio di lavoro.
Server MCP
bb mcp offre gli strumenti di Pax tramite MCP, dal tuo computer. Il tuo agente può cercare, leggere e (se lo permetti) modificare note, documenti, fogli, presentazioni, lavagne, pagine, attività e calendario con gli stessi strumenti e lo stesso motore che Pax usa nell’app. Nulla è ospitato altrove.
Un’unica ricerca tra file, attività ed eventi, poi apertura, struttura e modifica per ID: note Markdown, documenti, fogli, presentazioni, lavagne e pagine, oltre alle attività e alla tua agenda. I risultati tornano leggibili e strutturati, e una chiamata non riuscita spiega il perché con un codice stabile e un suggerimento.
bb mcp da solo si limita a leggere. --writes aggiunge creazione, modifica e spostamento nel cestino; gli elementi eliminati finiscono nel Cestino, da cui puoi ripristinarli. Ciò che hai impostato in sola lettura per Pax resta tale, e tutto ciò che nell’app richiederebbe la tua approvazione qui viene rifiutato.
Il server gira via stdio sul tuo computer e lavora sulla copia crittografata del tuo spazio di lavoro che è già lì. Si sincronizza all’avvio e poco dopo ogni modifica; --no-sync lo tiene completamente offline.
Oppure installa il plugin Blackbear, che configura lo stesso server e aggiunge una breve skill che insegna al tuo agente a trovare prima le cose e poi ad agire per ID. In Claude Code: /plugin marketplace add xavi-group/blackbear-plugins, poi /plugin install blackbear@blackbear. In Codex: codex plugin marketplace add xavi-group/blackbear-plugins, poi installalo da /plugins. Vedi su GitHub Le conversazioni di Pax restano nell’app e non vengono mai esposte.
Chiavi API
Ogni computer e ogni agente riceve una propria chiave API dell’account, con i soli scope che scegli tu. bb auth login apre il browser e lì confermi l’elenco; ogni chiave si può revocare singolarmente senza toccare le altre.
sync Leggere e scrivere nel tuo spazio di lavoro sincronizzato e sbloccare la cassaforte. È l’unico scope che aggiunge il computer come dispositivo.
account:read Vedere account, dispositivi e chiavi. Non modifica mai nulla.
media Caricare e scaricare allegati.
messaging Inviare e ricevere messaggi con crittografia end-to-end.
collab Partecipare alla modifica condivisa in tempo reale.
inference mostrato come AI models I modelli gestiti di Blackbear, la generazione di immagini e la ricerca web. Consuma crediti, quindi non è mai preselezionato.
Settings › Account › API keys elenca ogni chiave con i suoi scope. Creane una da lì (la conferma la tua cassaforte; la chiave viene mostrata una sola volta), oppure revoca qualsiasi chiave appena smetti di usarla.
bb auth login --api-key accede con una chiave che hai creato, letta da $BLACKBEAR_API_KEY, da un input in pipe o da un prompt nascosto, così resta fuori dalla cronologia della shell. --no-browser stampa il link di accesso invece di aprirlo.
Il Web Clipper ha un suo tipo di chiave: può solo depositare ritagli sigillati per uno dei tuoi dispositivi, e nient’altro può farlo.
bb discover Il web aperto, strutturato: arXiv, Hacker News, le tendenze di GitHub, qualsiasi feed RSS. Recuperato come Markdown pulito che il tuo agente può leggere e archiviare.
bb store Store: portachiavi, chiave-valore e database. Uno stato strutturato per il tuo agente, oltre a documenti e note.
bb file template Modelli: note quotidiane, verbali di riunione, diari. Crea file dai modelli con --template.
Tutto ciò che serve al tuo agente. Ogni comando supporta --json.
bb file md create "Title" -c "…" Crea una nota Markdown, o passa il contenuto con --stdin
bb file search "query" Ricerca full-text in tutti i file della cassaforte
bb file cat <id> Stampa su stdout il contenuto di qualsiasi file, di qualsiasi tipo
bb file list --type md Elenca i file, filtrando per tipo, tag o cartella
bb file update <id> --content "…" Sostituisci il contenuto; sposta, tagga, fissa o archivia
bb task create "Title" --due tomorrow Crea un’attività con --priority, --tags, date relative
bb task list --open Elenca le attività: --open, --done, --archived
bb event create "Standup" --at "9am" Pianifica in linguaggio naturale, oppure in ISO 8601
bb event list La settimana che arriva di default; --from e --to per un intervallo
bb profile create claude Un’identità d’agente a tutti gli effetti, con una sua chiave di firma
bb sync Pull + push: sincronizzazione E2EE completa nei due sensi
bb status Autenticazione, cassaforte, sincronizzazione, profilo e dispositivo a colpo d’occhio
bb mcp Gli strumenti di Pax come server MCP locale, in sola lettura
bb mcp --writes In più crea, modifica, sposta e cestina
bb auth login --scopes sync,account:read Preseleziona gli scope proposti dall’accesso nel browser
bb auth login --api-key Accedi senza interfaccia con una chiave creata in Settings
Gli ID accettano prefissi univoci. E c’è altro: tag, cartelle, store, modelli, esportazioni. bb help
Account gratuito. Archiviazione locale crittografata. Un’identità tutta sua. Accesso a tutto tramite CLI e MCP.