Para agentes y para quienes los crean
Los agentes pierden el contexto entre sesiones. No tienen dónde guardar notas persistentes, ni una identidad propia, ni memoria a largo plazo. blackbear les da todo eso: cifrado, local-first, con autoría y al alcance desde la línea de comandos bb o como un servidor MCP con el que tu agente ya sabe hablar. Una instalación y tu agente tiene un hogar.
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} Cada sesión de un agente empieza de cero. Las ventanas de contexto caducan, el historial de la conversación se recorta y no hay un lugar privado y persistente donde guardar lo importante. Tu agente es brillante durante 30 minutos y luego lo olvida todo.
Notas, decisiones, preferencias del usuario, contexto del proyecto: guardado en local, cifrado y con búsqueda. bb file search lo recupera todo. Tu agente retoma lo que dejó a medias, entre sesiones, reinicios y cambios de modelo.
Aquí los agentes no son invitados. bb profile create le da al tuyo un perfil de pleno derecho con su propia clave de firma para verificar la autoría. Cada nota, tarea y evento que escribe lleva su nombre.
Todos los comandos admiten --json para una salida legible por máquinas. Códigos de salida predecibles. Los ID aceptan prefijos únicos. Nada de analizar HTML ni de hacer scraping: solo datos limpios.
El mismo cifrado XChaCha20-Poly1305 que la app. La clave de la bóveda nunca sale del equipo. La nube solo ve datos cifrados. Los pensamientos de tu agente siguen siendo suyos, incluso frente a nosotros.
Base de datos SQLite local, cifrada en reposo y sin depender de la nube. Funciona sin conexión, en entornos aislados y en tu runner de CI. La sincronización es explícita: bb sync cuando tú quieras.
Notas, tareas, calendario, hojas, documentos, presentaciones, archivos: todo blackbear. Todo lo que escribe tu agente aparece en la app en cualquier dispositivo, atribuido a su perfil. La misma bóveda, el mismo cifrado, la misma sincronización.
brew install xavi-group/tap/bb, o descarga un binario. macOS, Linux y Windows.
bb auth login abre tu navegador, donde eliges los permisos que tendrá la clave de API de este equipo; después, bb vault unlock. La clave de la bóveda se guarda de forma segura en el llavero del sistema (un archivo cifrado en runners sin interfaz), así que a partir de ahí todos los comandos funcionan sin más. Sin variables de entorno, sin volver a pedirte nada.
bb profile create claude: tu agente recibe su propio perfil y su clave de firma. Todo lo que escribe queda a su nombre, y bb profile export-key le entrega una clave en formato SSH para firmar commits de git.
Una línea añade el servidor MCP: claude mcp add blackbear -- bb mcp (o codex mcp add, o cualquier cliente MCP). O llama a bb desde cualquier sistema de herramientas, con function calling o como subproceso, con JSON estructurado de entrada y de salida. Más sobre MCP
Abre blackbear en cualquier dispositivo y ahí está todo lo que escribió tu agente: notas, tareas y eventos, cada uno atribuido a su perfil. Edita algo en la app, sincroniza y la CLI verá tus cambios. Persona y agente comparten un mismo espacio de trabajo.
Servidor MCP
bb mcp ofrece las propias herramientas de Pax por MCP, desde tu equipo. Tu agente puede buscar, leer y (si se lo permites) cambiar tus notas, documentos, hojas, presentaciones, lienzos, páginas, tareas y calendario con las mismas herramientas y el mismo motor que Pax usa en la app. Nada está alojado en servidores.
Una sola búsqueda en archivos, tareas y eventos, y luego abrir, ver el esquema y editar por ID: notas de Markdown, documentos, hojas, presentaciones, lienzos y páginas, además de tareas y tu agenda. Los resultados llegan legibles y estructurados, y cuando una llamada falla explica por qué con un código estable y una pista.
bb mcp a secas solo lee. --writes añade crear, editar y mover a la papelera; lo que se borra va a la Papelera, desde donde puedes restaurarlo. Lo que hayas marcado como solo lectura para Pax se queda así, y lo que en la app necesitaría tu aprobación aquí se rechaza.
El servidor funciona por stdio en tu equipo, sobre la copia cifrada de tu espacio de trabajo que ya tienes ahí. Se sincroniza al arrancar y un momento después de cada cambio; --no-sync lo mantiene completamente sin conexión.
O instala el plugin de Blackbear, que configura el mismo servidor y añade una breve skill que enseña a tu agente a encontrar primero las cosas y después actuar sobre ellas por ID. En Claude Code: /plugin marketplace add xavi-group/blackbear-plugins y luego /plugin install blackbear@blackbear. En Codex: codex plugin marketplace add xavi-group/blackbear-plugins y luego instálalo desde /plugins. Ver en GitHub Las conversaciones de Pax se quedan en la app y nunca se exponen.
Claves de API
Cada equipo y cada agente tiene su propia clave de API de la cuenta, con solo los permisos que elijas. bb auth login abre tu navegador y ahí confirmas la lista; cada clave se puede revocar por separado sin tocar las demás.
sync Leer y escribir tu espacio de trabajo sincronizado y desbloquear tu bóveda. Es el único permiso que añade el equipo como dispositivo.
account:read Ver tu cuenta, tus dispositivos y tus claves. Nunca cambia nada.
media Subir y descargar archivos adjuntos.
messaging Enviar y recibir mensajes cifrados de extremo a extremo.
collab Unirse a la edición colaborativa en tiempo real.
inference aparece como AI models Los modelos gestionados de Blackbear, la generación de imágenes y la búsqueda web. Consume créditos, así que nunca viene marcado de antemano.
Settings › Account › API keys muestra todas las claves con sus permisos. Crea una ahí (tu bóveda la confirma; la clave se muestra una sola vez) o revoca cualquiera en cuanto dejes de usarla.
bb auth login --api-key inicia sesión con una clave que hayas creado, leída de $BLACKBEAR_API_KEY, de una entrada por tubería o de un prompt oculto, para que no quede en el historial de tu shell. --no-browser muestra el enlace de inicio de sesión en lugar de abrirlo.
El Web Clipper tiene su propio tipo de clave: solo puede dejar recortes sellados para uno de tus dispositivos, y ninguna otra clave puede hacerlo.
bb discover La web abierta, estructurada: arXiv, Hacker News, GitHub trending o cualquier feed RSS. Todo llega como Markdown limpio que tu agente puede leer y archivar.
bb store Stores: llaveros, clave-valor y bases de datos. Estado estructurado para tu agente, más allá de documentos y notas.
bb file template Plantillas: notas diarias, actas de reuniones, diarios. Crea archivos a partir de plantillas con --template.
Todo lo que tu agente necesita. Todos los comandos admiten --json.
bb file md create "Title" -c "…" Crea una nota de Markdown, o pasa el contenido con --stdin
bb file search "query" Búsqueda de texto completo en todos los archivos de la bóveda
bb file cat <id> Imprime el contenido de cualquier archivo en stdout, sea del tipo que sea
bb file list --type md Lista archivos, con filtro por tipo, etiqueta o carpeta
bb file update <id> --content "…" Sustituye el contenido; mueve, etiqueta, fija o archiva
bb task create "Title" --due tomorrow Crea una tarea con --priority, --tags y fechas relativas
bb task list --open Lista tareas: --open, --done, --archived
bb event create "Standup" --at "9am" Programa en lenguaje natural; ISO 8601 también funciona
bb event list La próxima semana por defecto; --from y --to para el intervalo
bb profile create claude Una identidad de agente de pleno derecho con su propia clave de firma
bb sync Pull + push: sincronización E2EE completa en ambos sentidos
bb status Sesión, bóveda, sincronización, perfil y dispositivo de un vistazo
bb mcp Las herramientas de Pax como servidor MCP local, de solo lectura
bb mcp --writes También crear, editar, mover y enviar a la papelera
bb auth login --scopes sync,account:read Preselecciona los permisos que ofrece el inicio de sesión en el navegador
bb auth login --api-key Inicia sesión sin interfaz con una clave de Settings
Los ID aceptan prefijos únicos. Y hay más (etiquetas, carpetas, stores, plantillas, exportaciones): bb help
Cuenta gratuita. Almacenamiento local cifrado. Una identidad propia. Acceso a todo por CLI y MCP.