Repolode
Enviar
oleksiijko

oleksiijko/pmb

Memória persistente e local-first para agentes de programação com IA, como Claude Code, Cursor e Codex, disponibilizada via MCP a partir de um arquivo SQLite no seu disco.

Ver no GitHubSite
Estrelas
283
Forks
32
Issues abertas
10
Último commit
mês passado

O que é?

Agentes de programação com IA esquecem decisões, aprendizados e o contexto dos projetos entre sessões, então os desenvolvedores precisam explicar as mesmas restrições repetidamente. O PMB armazena essas informações como memória duradoura em um workspace local: o SQLite é a fonte da verdade, com índices vetoriais recriáveis do LanceDB ao lado. O agente acessa a memória por ferramentas MCP, como prepare(message) e recall(query), que combinam BM25, busca vetorial, um grafo de entidades e reranking opcional.

No Claude Code e no Codex, o PMB pode instalar hooks de ciclo de vida que inserem memórias relevantes antes de o modelo responder e registram as ações do agente depois. Também indexa código de projetos, PDFs, Markdown e exportações de conversas, além de incluir um painel web local em 127.0.0.1 para consultar entidades, aprendizados e métricas de desempenho. O modelo de embeddings padrão abrange mais de 50 idiomas, então uma consulta em um idioma pode encontrar um fato armazenado em outro.

A ferramenta funciona offline por padrão e não exige chaves de API. Sua CLI oferece suporte a snapshots, verificação e exportação para Markdown ou JSON. Ela é escrita em Python, pode ser instalada com pip e está licenciada sob Apache 2.0.

Recursos principais

  • 01Armazena decisões, aprendizados, fatos e a estrutura do projeto em um arquivo SQLite local.
  • 02Conecta-se ao Claude Code, Cursor, Codex, Windsurf, Zed e VS Code via MCP.
  • 03Recuperação híbrida que combina BM25, busca vetorial, grafo de entidades e reranking opcional.
  • 04Hooks de ciclo de vida inserem memórias relevantes antes de o modelo responder nos agentes compatíveis.
  • 05Indexa código de projetos, PDFs, Markdown e exportações do ChatGPT.
  • 06Painel local para consultar memórias, além de snapshots verificados com opção de restauração.

Casos de uso

  • Manter decisões de arquitetura e restrições do projeto disponíveis entre sessões de programação.
  • Dar ao Claude Code ou ao Cursor contexto persistente sobre uma base de código sem enviar dados para um serviço na nuvem.
  • Pesquisar anotações pessoais, PDFs e conversas anteriores com agentes pelo terminal.

Início rápido

  1. 1

    Instale o pacote pelo PyPI

    pip install pmb-ai
  2. 2

    Integre o PMB ao agente de IA detectado

    pmb setup
  3. 3

    Pré-carregue o modelo de embeddings para que a primeira recuperação seja rápida

    pmb warmup
  4. 4

    Reinicie o agente e confirme se tudo está integrado com a verificação doctor

    pmb doctor

Antes de usar

  • O modelo de embeddings padrão tem cerca de 450 MB e precisa ser baixado antes do primeiro uso.
  • Alguns recursos, como hooks e o reranking opcional com cross-encoder, se aplicam apenas a agentes ou configurações específicos.

Em coleções

Memória de longo prazo para agentes de IAFrameworks e apps de agentes de IA open sourceServidores MCPFerramentas de privacidade e local-firstBancos de dados e ferramentas SQL

Tópicos

#ai-agents#mcp#local-first#sqlite#memory#vector-search#rag#privacy#ai-memory#bm25

Perguntas frequentes

O que é pmb?
Memória persistente e local-first para agentes de programação com IA, como Claude Code, Cursor e Codex, disponibilizada via MCP a partir de um arquivo SQLite no seu disco. Agentes de programação com IA esquecem decisões, aprendizados e o contexto dos projetos entre sessões, então os desenvolvedores precisam explicar as mesmas restrições repetidamente. O PMB armazena essas informações como memória duradoura em um workspace local: o SQLite é a fonte da verdade, com índices vetoriais recriáveis do LanceDB ao lado. O agente acessa a memória por ferramentas MCP, como prepare(message) e recall(query), que combinam BM25, busca vetorial, um grafo de entidades e reranking opcional.
pmb é gratuito? Qual é a licença?
pmb é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
pmb ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de pmb foi em 23 de set. de 2026.
Para que posso usar pmb?
Manter decisões de arquitetura e restrições do projeto disponíveis entre sessões de programação. Dar ao Claude Code ou ao Cursor contexto persistente sobre uma base de código sem enviar dados para um serviço na nuvem. Pesquisar anotações pessoais, PDFs e conversas anteriores com agentes pelo terminal.
Como instalar pmb?
Instale o pacote pelo PyPI: pip install pmb-ai Integre o PMB ao agente de IA detectado: pmb setup Pré-carregue o modelo de embeddings para que a primeira recuperação seja rápida: pmb warmup Reinicie o agente e confirme se tudo está integrado com a verificação doctor: pmb doctor
Onde consigo pmb?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/oleksiijko/pmb

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados