Mycelium
nxoim/mycelium
Memória persistente associativa para agentes de IA com MCP
Ver no GitHubSistema de memória persistente baseado em nós para agentes de IA, construído em Swift. Oferece armazenamento de memórias com associações contextuais, recuperação eficiente e integração via MCP (stdio e HTTP) com servidor WebSocket para observação.
Instalação
npx convez-ai nxoim/mycelium1 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
- Agentes que precisam manter contexto de conversas longas
- Sistemas que aprendem e refinam conhecimento ao longo do tempo
- Debugging assistido por IA com recuperação de contexto histórico
Veredito

Ferramenta sólida para criar agentes com memória autônoma e associativa. Exige compreensão profunda de prompts e design de sistemas para ativar efetivamente o potencial de recall contextual do modelo.
README
A tradução para o português deste README ainda está na fila.
mycelium
Simple node based memory system for AI agents built in Swift. CLI, MCP (stdio and HTTP), and observation server.
The concept
The core idea is to give LLMs a persistent, association-based memory system they can manage autonomously. Memories are presented as summaries and associated memories, for minimal impact on context window usage. The model is expected to memorize relevant information unprompted and recall it when it deems it's needed.
For example, while debugging a problem, the model might search its memory for something adjacent to the topic at hand, then find a relevant memory, then read it fully, and then shift the direction of the conversation.
The setup
Docker, Podman, etc.
See docker/README.md for build and run instructions.
Or native build
-
Install the Swift toolchain, if you don't already have it. Make sure it's 6.3+.
-
Build the binaries:
scripts/build-and-package-release-macos-aarch64.sh -
Copy the output binaries from
.tmp/release/wherever you need. Prebuilt binaries are not yet published. -
Add the mcp to your harness. You can either launch
mcp-serverto host locally, or you can use themcp-stdiobinary normally.
Upon launch an sqlite memory database will be created in the folder containing the executable, unless specified otherwise via --db.
How it works in practice
With newer qwen models it works... somewhat... if directed via rules/skills. For example:
You have persistent memory.
Before each reply you should ask yourself whether you know anything about the topic of the conversation, or any of the details, and then you should try to recall any relevant information by keywords.
You should memorize anything you learn with the user, and when you memorize something you should also memorize the context - the when, the how, the why of your decision to memorize.
A memory guide can be provided for memorization to the model to help guide its memory tool usage. See MEMORY-GUIDE.md. I've found, anecdotally, that better results are achieved when memory labels are predictable, for example, by containing prefixes ("Document:", "Goal:", etc.), and when associations contain memories that act like topic tags and definitions ("Swift Programming Language", "#prefixes", etc.).
What the model sees
Memories are divided into 2 parts - summary with associations, and the full contents. Recalling a summary, individually or by searching, outputs something like:
# Label of the Memory
## Associated with:
- **Associated Memory** (id: UUID)
-- **Nested Associated Memory** (id: UUID)
-- **Nested Associated Memory** (id: UUID)
--- **Nested Associated Memory** (id: UUID)
- **Associated Memory** (id: UUID)
id: UUID
When searching, the list of memories is preceded by information about the search, like:
#### 3 memories of 12 found, starting from 0
To remember the full contents of a memory the model has access to a separate tool.
While recalling, via search or otherwise, the model can choose the depth of associations to retrieve. By default, at depth 0, direct associations are retrieved, and at depth 1 and more the associations of associations will be retrieved.
When memorizing, the associations are built omnidirectionally - between all of the provided memories.