Para agentes e para quem os cria
Agentes perdem o contexto entre sessões. Eles não têm onde guardar notas persistentes, nem identidade própria, nem memória de longo prazo. O blackbear dá tudo isso a eles: criptografado, local-first, com autoria e acessível pela linha de comando bb ou como um servidor MCP com o qual seu agente já sabe conversar. Uma instalação e seu agente tem um lar.
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} Toda sessão de um agente começa do zero. As janelas de contexto expiram, o histórico da conversa é cortado e não existe um lugar privado e persistente para guardar o que importa. Seu agente é brilhante por 30 minutos e depois esquece tudo.
Notas, decisões, preferências do usuário, contexto do projeto: tudo guardado localmente, criptografado e pesquisável. bb file search traz tudo de volta. Seu agente retoma de onde parou, entre sessões, reinicializações e trocas de modelo.
Aqui os agentes não são visitantes. bb profile create dá ao seu um perfil completo, com chave de assinatura própria para verificar a autoria. Cada nota, tarefa e evento que ele grava leva o nome dele.
Todo comando aceita --json para saída legível por máquina. Códigos de saída previsíveis. IDs aceitam prefixos únicos. Nada de interpretar HTML, nada de scraping: só dados limpos.
A mesma criptografia XChaCha20-Poly1305 do app. A chave do cofre nunca sai da máquina. A nuvem só vê dados cifrados. Os pensamentos do seu agente continuam sendo dele, inclusive para nós.
Banco de dados SQLite local, criptografado em repouso, sem depender da nuvem. Funciona offline, em ambientes isolados e no seu runner de CI. A sincronização é explícita: bb sync quando você quiser.
Notas, tarefas, agenda, planilhas, documentos, apresentações, arquivos: o blackbear inteiro. Tudo o que seu agente grava aparece no app em qualquer dispositivo, atribuído ao perfil dele. O mesmo cofre, a mesma criptografia, a mesma sincronização.
brew install xavi-group/tap/bb, ou baixe um binário. macOS, Linux e Windows.
bb auth login abre seu navegador, onde você escolhe as permissões da chave de API desta máquina; depois, bb vault unlock. A chave do cofre fica guardada com segurança nas chaves do sistema (num arquivo criptografado em runners sem interface), então daqui em diante todo comando simplesmente funciona. Sem variáveis de ambiente, sem pedir de novo.
bb profile create claude: seu agente ganha perfil e chave de assinatura próprios. Tudo o que ele grava tem autoria, e bb profile export-key entrega a ele uma chave no formato SSH para assinar commits no git.
Uma linha adiciona o servidor MCP: claude mcp add blackbear -- bb mcp (ou codex mcp add, ou qualquer cliente MCP). Ou chame o bb de qualquer sistema de ferramentas, por function calling ou subprocesso, com JSON estruturado na entrada e na saída. Mais sobre MCP
Abra o blackbear em qualquer dispositivo e tudo o que seu agente gravou está lá: notas, tarefas e eventos, cada um atribuído ao perfil dele. Edite algo no app, sincronize, e a CLI vê suas mudanças. Pessoa e agente compartilham um só espaço de trabalho.
Servidor MCP
O bb mcp oferece as próprias ferramentas do Pax por MCP, a partir da sua máquina. Seu agente pode buscar, ler e (quando você permitir) alterar suas notas, documentos, planilhas, apresentações, canvas, páginas, tarefas e agenda com as mesmas ferramentas e o mesmo mecanismo que o Pax usa no app. Nada fica hospedado.
Uma busca única em arquivos, tarefas e eventos, e depois abrir, ver a estrutura e editar por ID: notas em Markdown, documentos, planilhas, apresentações, canvas e páginas, além de tarefas e da sua agenda. Os resultados chegam legíveis e estruturados, e uma chamada que falha explica o motivo com um código estável e uma dica.
O bb mcp puro só lê. --writes acrescenta criar, editar e mover para a lixeira; o que for excluído vai para a Lixeira, de onde você pode restaurar. O que você marcou como somente leitura para o Pax continua assim, e o que precisaria da sua aprovação no app é recusado aqui.
O servidor roda via stdio na sua máquina e trabalha sobre a cópia criptografada do seu espaço de trabalho que já está lá. Ele sincroniza ao iniciar e logo depois de cada alteração; --no-sync o mantém totalmente offline.
Ou instale o plugin do Blackbear, que configura o mesmo servidor e adiciona uma skill curta que ensina seu agente a primeiro encontrar as coisas e depois agir sobre elas por ID. No Claude Code: /plugin marketplace add xavi-group/blackbear-plugins e depois /plugin install blackbear@blackbear. No Codex: codex plugin marketplace add xavi-group/blackbear-plugins e depois instale pelo /plugins. Ver no GitHub As conversas do Pax ficam no app e nunca são expostas.
Chaves de API
Cada máquina e cada agente recebe a própria chave de API da conta, só com as permissões que você escolher. bb auth login abre seu navegador e você confirma a lista ali; cada chave pode ser revogada separadamente, sem mexer nas outras.
sync Ler e gravar seu espaço de trabalho sincronizado e desbloquear seu cofre. É a única permissão que adiciona a máquina como dispositivo.
account:read Ver sua conta, seus dispositivos e suas chaves. Nunca altera nada.
media Enviar e baixar anexos.
messaging Enviar e receber mensagens com criptografia de ponta a ponta.
collab Participar da edição colaborativa em tempo real.
inference aparece como AI models Os modelos gerenciados do Blackbear, a geração de imagens e a busca na web. Consome créditos, por isso nunca vem pré-selecionada.
Settings › Account › API keys lista todas as chaves com suas permissões. Crie uma ali (seu cofre confirma; a chave aparece uma única vez) ou revogue qualquer chave assim que parar de usá-la.
bb auth login --api-key entra com uma chave que você criou, lida de $BLACKBEAR_API_KEY, de uma entrada via pipe ou de um prompt oculto, para ela não ficar no histórico do shell. --no-browser mostra o link de login em vez de abri-lo.
O Web Clipper tem um tipo de chave próprio: ele só pode deixar recortes lacrados para um dos seus dispositivos, e nenhuma outra chave pode fazer isso.
bb discover A web aberta, estruturada: arXiv, Hacker News, GitHub trending ou qualquer feed RSS. Tudo chega como Markdown limpo que seu agente pode ler e arquivar.
bb store Stores: chaveiros, chave-valor e bancos de dados. Estado estruturado para o seu agente, além de documentos e notas.
bb file template Modelos: notas diárias, atas de reunião, diários. Crie arquivos a partir de modelos com --template.
Tudo de que seu agente precisa. Todo comando aceita --json.
bb file md create "Title" -c "…" Cria uma nota em Markdown, ou envia o conteúdo via --stdin
bb file search "query" Busca de texto completo em todos os arquivos do cofre
bb file cat <id> Imprime o conteúdo de qualquer arquivo no stdout, seja qual for o tipo
bb file list --type md Lista arquivos, com filtro por tipo, tag ou pasta
bb file update <id> --content "…" Substitui o conteúdo; move, marca com tags, fixa ou arquiva
bb task create "Title" --due tomorrow Cria uma tarefa com --priority, --tags e datas relativas
bb task list --open Lista tarefas: --open, --done, --archived
bb event create "Standup" --at "9am" Agenda em linguagem natural; ISO 8601 também funciona
bb event list A próxima semana por padrão; --from e --to para o intervalo
bb profile create claude Uma identidade de agente completa, com chave de assinatura própria
bb sync Pull + push: sincronização E2EE completa nos dois sentidos
bb status Sessão, cofre, sincronização, perfil e dispositivo num relance
bb mcp As ferramentas do Pax como servidor MCP local, somente leitura
bb mcp --writes Também cria, edita, move e envia para a lixeira
bb auth login --scopes sync,account:read Pré-seleciona as permissões oferecidas no login pelo navegador
bb auth login --api-key Entra sem interface com uma chave criada em Settings
IDs aceitam prefixos únicos. E tem mais (tags, pastas, stores, modelos, exportações): bb help
Conta gratuita. Armazenamento local criptografado. Uma identidade própria. Acesso a tudo pela CLI e pelo MCP.