Documentação do brethof-brain

Início Rápido

Três passos, um deles opcional

Uma conta alimenta todos os agentes que você executa, em cada máquina na qual os executa.

1

Obtenha uma chave

Crie sua conta em brethof.ai/account, escolha onde sua memória será armazenada — local (em sua própria máquina) ou hospedada (em nossa nuvem, criptografada, na Alemanha) — defina sua senha, comece com o plano gratuito e crie uma chave API. Não é necessário cartão de crédito. A escolha entre armazenamento local ou hospedado é feita uma única vez; os planos e pacotes podem ser alterados a qualquer momento.

2

Conecte seu agente

Escolha sua plataforma abaixo. A maioria delas é de uma única linha — e em qualquer uma delas você pode simplesmente digitar “install brethof-brain” e deixar o agente fazer o trabalho. Edição local: Docker ou Podman no computador, além de aproximadamente 3 GB de espaço em disco, incluindo o modelo de memória, que é baixado uma única vez; não são necessários privilégios elevados.

3

Verifique, se quiser.

Peça ao seu agente que procure na memória por qualquer coisa, mesmo algo trivial. Uma resposta bem formulada — mesmo “sem resultados” — significa que você está conectado. Esse é todo o teste.

um plugin — instalado em um único passo, sem clonar, sem pip

Testado em Linux e Windows

# No Claude Code:
/plugin marketplace add BrethofAI/brethof-brain-client
/plugin install brethof-brain@brethof
# Então a janela de conexão do plugin abre na sua tela: cole a sua chave
# (hospedado: e a sua frase-passe). O seu agente nunca vê nenhum dos dois.
# Recomendado: adicione o bloco de memória do README do plugin a
# ~/.claude/CLAUDE.md, para que "lembre disto" fique no Brain.
# Feito — informado no início da sessão, memória a cada pedido, cada
# troca arquivada e usada como aprendizado.

Instalado, mas aparentemente não utilizado? Nos casos em que a plataforma aceita hooks, a memória é enviada ao agente e nada precisa ser ensinado. Nos casos em que não aceita, a configuração grava uma seção de memória no arquivo de contexto da própria plataforma, para que o agente saiba buscar. Se a memória parecer conectada, mas o agente nunca a acessar, esse arquivo é o primeiro a ser verificado.

O que é gravado no Claude Code

No Claude Code, o pip install (brethof-brain install-hooks) mantém um bloco gerenciado no seu CLAUDE.md, reescrito a cada início de sessão. É um ponteiro, não uma cópia do ensino — ele informa ao seu agente que a memória é o Brain, como acessá-la, e que, quando você diz “lembre-se disso”, o conteúdo vai para o Brain, e não para os arquivos de memória do próprio Claude Code em uma máquina. O ensino real chega no início da sessão. Ele nunca toca em nada fora do bloco: suas próprias convenções continuam suas. Para desativá-lo, defina BRETHOF_BRAIN_NO_CLAUDE_MD=1. O plugin nunca o grava: com uma instalação via plugin, cole o bloco do README do plugin em ~/.claude/CLAUDE.md, ou peça ao seu agente para fazê-lo.

Comandos e versões

O plugin Claude Code vem com três comandos: /recall (pesquisar agora), /onboard (o primeiro minuto de um projeto) e /curate (fechar uma sessão). Não há nada que precise ser executado manualmente — a memória organiza e arruma os registros à medida que eles chegam.

Chaves e projetos

Duas coisas que você precisa saber antes de começar

🔑

Chaves

As chaves hospedadas são criadas, editadas e revogadas no painel da conta; criar uma requer autenticação de dois fatores ou um login com GitHub ou Google. Uma chave pode atender a muitos agentes em muitas máquinas. Uma chave hospedada pode ter escopo restrito: limitada a projetos escolhidos, somente leitura ou leitura e escrita. Esse é o formato ideal para um contratado ou um agente de propósito único. A edição local tem uma chave de acesso total, criada pelo seu instalador.

Projetos

Apenas nomes. Ao salvar ou buscar um projeto, ele passa a existir a partir daquele momento — sem configuração, sem limite de quantos, em qualquer plano, incluindo o gratuito. Use um por código-fonte, cliente ou empreendimento. Seus agentes podem buscar dentro de um projeto ou em todos eles, e uma camada compartilhada acima deles armazena os poucos dados válidos para todos os casos.

Como funciona

Ela aprende sem ser solicitada.

Ninguém resume as sessões aqui, e você nunca realiza o ritual de “salvar meu contexto”. Quando você corrige seu agente na terça-feira, todo agente fica sabendo na terça-feira.

Um curador que lê a conversa, não a mensagem

Corrija o seu agente uma vez e nunca mais precisará corrigi-lo — a próxima sessão desse agente fica a saber, todas as outras sessões ficam a saber, em todas as máquinas. A memória lê a sua conversa em blocos de cinco trocas, por isso guarda o que a conversa consolidou, não cada pensamento a meio do caminho: decisões guardadas, afirmações desatualizadas retiradas. Um registo pode ficar algumas trocas atrás de si — as últimas trocas de uma sessão tornam-se memória quando compacta ou quando a próxima sessão desse projeto começa. Nunca arquiva nada. Quando quiser mesmo que algo seja guardado na hora, diga-o — o seu agente guarda-o diretamente, o que é útil quando a precisão importa ou quando um facto pertence a outro projeto.

Duas lojas: a verdade e a gravação

Memória salva é a verdade atual — selecionada, detalhada, atualizada. Histórico de conversas É a gravação completa e bruta de tudo o que já foi dito. Quando seu agente precisa do que a equipe acredita ser atualmente, ele procura na memória; quando precisa da mensagem de erro exata de três semanas atrás, ele procura no histórico. As declarações antigas no histórico são instantâneos de seus respectivos momentos. A memória é o que é verdadeiro hoje.

O gráfico é a memória das decisões

O grafo de decisões atribui a cada movimento uma linha com a data — decidido, tentado, rejeitado, descartado —, cada uma com seu motivo, conforme consta na conversa. Uma reversão gera uma nova linha; o método anterior permanece registrado como tal. Assim, quando uma busca aborda o tópico, a linha indicando que a ideia foi descartada em março é exibida com a data e o motivo, e seu agente não a propõe novamente. Isso é algo que os arquivos AGENTS.md e CLAUDE.md nunca conseguem fazer: eles não sabem que uma ideia foi descartada, então ela permanece lá como verdade atual, aguardando que um novo agente a analise. O grafo remonta à data em que sua memória começou a registrar informações, e faz parte de todos os planos, em ambas as versões.

A capacidade de recall nunca é medida e nunca para em um limite. A busca, o contexto de início de sessão, o recall por solicitação e as linhas de histórico do gráfico não são contabilizados como parte da cota permitida, e você nunca será cobrado pela busca — em nenhum plano, incluindo o gratuito. Os planos medem apenas duas coisas: quanto sua memória armazena e quanto ela aprende a cada mês. Se qualquer um desses recursos for esgotado, ocorrerá uma pausa na gravação ou no aprendizado — mas sua memória armazenada continuará respondendo.

Dia a dia

A resposta honesta: você não precisa.

Uma vez que o plugin esteja instalado, não há nenhum ritual a ser aprendido nem comando a ser memorizado. O melhor sinal de que ele está funcionando é você parar de pensar nele.

O que muda é a maneira como você fala com seu agente. Agora você pode dizer coisas como O que decidimos a respeito das tentativas de pagamento? or Lembre-se de que a caixa de encenação é aquela com o certificado antigo. — Em linguagem simples, durante a conversa. Seu agente escolhe a ferramenta certa; você nunca precisa nomeá-la.

O que seu agente pode alcançar

Você não precisa desta lista. Ela está aqui para que saiba o que é possível quando solicitar algo específico.

Encontrar coisas — Consulte sua memória organizada ou o histórico completo das conversas quando precisar das palavras exatas de uma sessão anterior.
Lembre-se das coisas — Salve um fato em um projeto ou na camada compartilhada que abrange todos eles.
Ensinar coisas — Salve uma regra ou inicie um projeto com uma frase que descreva o que é importante nele.
Inspecionar itens — liste seus projetos, liste o que um projeto sabe, liste suas regras ou leia um registro.
Remover itens — excluir um único registro. A remoção de uma frase específica ou a exclusão de todo um projeto é feita no painel da conta.
Revise o Ledger — veja o conjunto de intenções ainda não decididas de um projeto e remova as linhas à medida que as decidir.
Mantenha os livros de procedimentos — Salve um procedimento uma vez, para toda a conta; baixe e execute-o de qualquer projeto; liste o que existe; exclua o que está inativo.

Uma coisa que um agente deliberadamente não pode fazer: excluir um projeto inteiro. Esse ato único afeta o arquivo bruto, portanto ele permanece no painel da sua conta, onde uma pessoa digita o nome.

O Livro-Razão Brain

Nada do que você disse se perde.

Como suas conversas são arquivadas, o Brain as monitora para intenções — As coisas que você disse que faria e não fez. Cada uma se torna uma linha no registro desse projeto: pendente, aguardando por você. Sem status, sem arquivamento. Uma linha espera, é descartada ou se torna tarefa.

A resenha

Diga “verifique o livro contábil” em qualquer sessão. Seu agente traz as linhas uma a uma e você responde em palavras únicas. As linhas decididas são removidas na hora. As linhas que o trabalho posterior mostrar como concluídas, descartadas ou ultrapassadas já saíram por conta própria.

🏃

De linhas ao plano

Uma linha que ainda importa torna-se um item no plano do projeto — Next ou Parked — e sai do Ledger; o resto morre. O plano abre a próxima sessão, para que o trabalho esteja diante do seu agente quando ele começar. Como o plano funciona.

Dois hábitos fazem com que isso cante. Revise com frequência — Uma pilha visitada diariamente permanece com apenas algumas fileiras. E excluir de forma brutal — Nada se perde, pois uma ideia que ainda é importante será dita novamente, arquivada de novo e avaliada de forma renovada em relação ao projeto naquele momento.

Guias Brain

Procedimentos que todo agente compartilha

Um playbook é um procedimento escrito em formato de documento Markdown e armazenado uma única vez para toda a sua conta. Qualquer um dos seus agentes, em qualquer projeto, em qualquer máquina, pode obtê-lo e executá-lo em seu próprio ambiente — o Brain armazena e fornece; o seu agente executa.

✍

Escrever um

Peça ao seu agente que salve um playbook, estruturando-o como um manual de operações: títulos para as etapas, blocos de código delimitados para os comandos exatos, e uma anotação de uma linha indicando o que cada comando faz — é essa linha que é exibida quando os agentes consultam a lista. Ao salvar sob o mesmo nome, a versão anterior é substituída, de modo que há sempre apenas um documento atual.

▶

Executar um

“Execute o playbook de implantação.” É toda a interface: o agente a obtém e a segue até onde ela se encontra. Combine isso com um cronograma para obter o efeito completo — um agente que funciona “Pegue o manual de relatório semanal e execute-o.” Em um cron, torna-se um trabalho que você escreveu uma vez em linguagem simples e nunca precisa procurar novamente.

Regras

Ensinar sua memória

Tudo o mais que sua memória guarda é encontrado ao. Uma regra é diferente: uma instrução permanente que é carregada automaticamente em cada sessão, sem que ninguém precise consultá-la.

As regras são o meio de evitar repetições — as convenções, restrições e correções adquiridas com esforço que seus agentes nunca devem esquecer. As boas regras soam como leis: “nunca implemente na sexta-feira”, “este projeto usa tabulações, não espaços”, “o nome do cliente é escrito como Brethof, nunca Brefoth”. Curtas, claras e ainda válidas no mês que vem.

Peça ao seu agente para salvar uma regra, e ele lhe perguntará uma coisa: isso se aplica a tudo o que você faz, ou apenas a este projeto?

🌎

Cada projeto

Uma lei que rege todo o seu trabalho, onde quer que ele ocorra.

📌

Este projeto apenas

Uma lei para um único código-fonte, cliente ou empreendimento.

💡

Nem um nem outro — é conhecimento

Útil, mas não precisa estar sempre à sua frente. Ainda assim é salvo e pode ser encontrado no momento em que alguém o procurar.

Essa terceira opção é a importante, e é escolhida com mais frequência do que as outras duas. Uma regra é dispendiosa: ocupa espaço em cada sessão para sempre e ensina ao curador o que é importante. Arquivar conhecimentos comuns como regras é exatamente como a memória se torna entupida, até que nada mais se destaque.

As regras ensinam o curador, não apenas o agente

Um projeto com algumas regras claras lembra notavelmente melhor do que um sem nenhuma — pois as regras indicam ao curador o que é importante nele. Salve uma, e, em poucos minutos, a memória desse projeto terá reaprendido o que ele é.

Mantê-los afiados

Uma regra deve ser curta o suficiente para que se possa pronunciá-la em voz alta — se não couber, provavelmente é conhecimento disfarçado de regra. Combine os duplicados em um só e elimine as regras que se tornaram obsoletas; nada as elimina por você, pois nada mais deve ter permissão para decidir quais são as suas leis. Uma dúzia de regras nas quais você acredita vale mais do que cinquenta que você parou de ler.

Projetos na prática

A única decisão realmente importante é como dividi-los: um por código-fonte, cliente ou projeto é o padrão que funciona. Poucos demais e tarefas não relacionadas se misturam; muitos demais e o contexto se dispersa. Começar um projeto com um objetivo definido em uma única frase – o que ele é e o que deve ser lembrado nele – é o minuto de maior valor que se pode dedicar. Isso ensina ao responsável pelo gerenciamento desde o primeiro dia, em vez de deixá-lo tentando deduzir suas intenções a partir de fragmentos de informação.

Espaço e uso

O que é que um limite impede — e o que ele nunca toca

Sua memória armazenada continua respondendo, não importa quais outros recursos estejam limitados. A lembrança é algo que os limites nunca podem tirar — assim como o resumo que abre cada sessão, as regras e registros que chegam a cada solicitação, o histórico completo de conversas, o gráfico, as anotações e os playbooks.

Três coisas diferentes são medidas de maneira diferente, e vale a pena saber qual é qual. Gravação É limitado pelo armazenamento. Aprender é limitado pelo seu limite mensal. Lembrar não é limitado por nada — a busca, as informações da sessão e a recuperação por solicitação continuam funcionando enquanto sua memória estiver em nossos sistemas ativos.

Quando o tempo de estudo do mês acaba

Sua história continua sendo gravado, e tudo isso continua pesquisável. O Recall continua funcionando — informado no início da sessão, comparando a memória em cada solicitação, o gráfico. O que para é aprender: Nenhuma nova memória é criada a partir de suas conversas, e o gráfico deixa de crescer. Um pacote de recarga ou uma atualização faz com que ele comece a crescer novamente.

🗃

Quando o armazenamento está cheio

Nada de novo é salvo — esse é o significado de “completo”. A função de lembrança continua funcionando em todos os dados já armazenados, de modo que seu agente permanece informado e se lembra do que sabia ontem. Adicione espaço de armazenamento ou passe para um plano superior, e a gravação retoma de onde parou.

⏹

Quando ambos mordem ao mesmo tempo

Sem gravação, sem aprendizado — e sem lembrança Ainda funciona.. Se você ouvir que seu Brain está desligado, ele está desligado para nova memória Só isso. Tudo já está nele, respondendo exatamente como antes, e seu agente continua a usá-lo.

Se a assinatura expirar

O Brain é pausado imediatamente — não há período de carência. Sua memória é arquivada após o dia 7; você recebe um aviso por volta do dia 23, e ela é removida no dia 30. Uma conta ativa e paga nunca é afetada. O cronograma completo, bem como os e-mails associados, estão na Política de Privacidade.

O espaço que um limite deixa, e por que nunca o preenchemos

Embora haja um limite, nenhuma nova memória é formada. Isso deixa uma lacuna na sua memória para aquele período. nós não voltamos para preenchê-lo depois. Essa é uma lei de design deliberada, e você deve conhecê-la.

Uma memória é criada apenas a partir de uma conversa. como acontece. Um registro escrito posteriormente, com base em informações já antigas, substituiria o que tem sido verdadeiro desde então – e sua memória começaria a afirmar, com certeza, coisas que deixaram de ser verdadeiras. Preferimos deixar um vazio a criar uma mentira convincente.

Em outras palavras: a lacuna é permanente como memória. Seu histórico de conversas bruto daquela época ainda está lá e pode ser pesquisado, portanto o registro não foi perdido — apenas a camada resumida apresenta o vazio. Quanto mais tempo um limite permanece ativo, mais sua memória se afasta do trabalho que você está realmente realizando. E ela não se repara sozinha quando você retoma as atividades: seu agente corrige as memórias desatualizadas à medida que as encontra, e a memória concilia novos registros com os antigos à medida que eles chegam, descartando aqueles que contradizem suas memórias mais recentes. Ambos os processos avançam para frente, nunca para trás.

Ninguém é cortado em silêncio. Você recebe um e-mail quando se aproxima de um limite e outro quando ele é atingido, um aviso dentro da sessão do seu agente quando ele começa e uma linha curta em cada prompt enquanto o limite estiver ativo.

Limpar a história antiga

Seu histórico bruto permanece protegido onde importa: o histórico recente não pode ser removido por ninguém, e mensagens individuais não podem ser apagadas em silêncio — mas você pode ocultar uma frase exata, excluir um único registro por meio do seu agente ou remover todo um projeto no painel da conta, onde uma pessoa digita o nome. Excluir qualquer coisa é gratuito.

⇆

Mudando os planos

Os upgrades são aplicados imediatamente. Os downgrades são aplicados assim que sua memória se adequar ao plano menor — elimine recursos ou mantenha os complementos até que isso aconteça. Nada é excluído por nós em nenhuma alteração de plano.

Perguntas Frequentes

Perguntas frequentes

No serviço hospedado, sua memória é criptografada com uma senha que somente você possui: enquanto trancada, ela fica em texto cifrado para todos, incluindo nós. Ela é armazenada e pesquisada na Alemanha; a etapa de processamento é executada em servidores seguros na Suíça; e uma etapa de modelo é enviada, temporariamente, a um provedor que se comprometeu por contrato a não reter nem treinar com o que passa por ele — declaramos isso como o compromisso deles. No modo local, sua memória permanece em sua máquina. Nosso hub processa partes dela à medida que são enviadas e não armazena nada — as únicas coisas que ele mantém são suas regras permanentes e uma linha por projeto. A memória e as buscas permanecem em sua máquina.

É exatamente esse o ponto. Todos os agentes que usam suas chaves leem e escrevem a mesma memória, mantida consistente turno a turno — cinco agentes em um projeto veem uma única verdade. Na memória hospedada, chaves com escopo permitem dar a uma pessoa ou a um agente acesso apenas aos projetos escolhidos, somente leitura ou leitura e escrita.

Claude Code, Codex, Qwen Code, OpenClaw, DeepSeek Harness (dsh), Cline, OpenCode, Kilo Code e Hermes Agent. Uma plataforma é listada somente quando todo o ciclo funciona nela — briefing no início da sessão, a memória correspondente é carregada em cada solicitação, e a conversa é arquivada. Não existe nível de suporte parcial, pois uma plataforma que funcione apenas parcialmente seria a única opção de alguém. Há outras em desenvolvimento, aguardando confirmação nas contas dos fornecedores; elas serão listadas aqui no dia em que forem comprovadas, e não antes.

Não. Uma chave brethof-brain é tudo o que qualquer agente precisa, e seu agente pode instalar tudo sozinho — basta digitar “install brethof-brain” e está pronto. Em modo hospedado, nós cuidamos de tudo. Em modo local, ele roda em um único contêiner em sua máquina.

Sim — pergunte ao seu agente ou use o painel da sua conta. Essas são as duas maneiras de acessar sua memória, e a exclusão pode ser feita por meio de ambas: exportar todo o histórico, excluir um projeto, remover uma frase específica ou excluir a conta — pelo painel, sob sua própria identidade, mesmo sem a senha. Algumas funcionalidades são intencionalmente limitadas: as proteções que impedem que um agente apague seu histórico também se aplicam a você, e a Página de Segurança indica exatamente onde estão esses limites.

O monte de intenções não decididas de cada projeto — coisas que você disse que faria numa conversa mas não fez. Peça ao seu agente para "verificar o registro", decidir cada linha em uma palavra e mover o que vale a pena para o plano do projeto. A seção acima tem os detalhes.

Fique por dentro das novidades

Ouça quando for enviado

Novos lançamentos, benchmarks reais e análises aprofundadas ocasionais. Sem spam, cancelamento de assinatura com um clique.

A rede Brethof

Documentos