Aletheia
Free, local memory and rules hub for AI coding tools: persistent memory for Claude Code, Codex, Cursor and Gemini CLI. One SQLite store over MCP, REST and CLI. Rules sync to CLAUDE.md and AGENTS.md.…
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Bun >=1.1
install Bun 1.4.4 runtime
curl -fsSL https://bun.sh/install | bash 2>&1; ~/.bun/bin/bun --versionRuns a downloaded script: read it before you run it.
npm install -g aletheia-mem
export PATH="$HOME/.bun/bin:$HOME/.local/bin:$PATH" npm install -g aletheia-mem
Check that it works
export PATH="$HOME/.bun/bin:$HOME/.local/bin:$PATH"; aletheia --version 2>&1The output should contain “0.1.11”.
First thing to try
export PATH="$HOME/.bun/bin:$HOME/.local/bin:$PATH"
timeout 5 aletheia install --listAdd it to your agent
claude mcp add aletheia-mem -- aletheia-mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"aletheia-mem": {
"command": "aletheia-mcp",
"args": []
}
}
}Run aletheia install --list to see which coding tools Aletheia can connect to, then add the aletheia-mcp server to your MCP client.
What it does
- Share saved memory across your coding toolsTested
How to use it
- Add
aletheia-mcpas an MCP server in your coding tool. - Call the
save_memorytool with your text to store a memory. - Call the
searchtool with a query to find saved memories.
- Add
- Use one memory store over MCP, REST or CLINot shown working
- Sync rules to your tools' instruction filesNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 1 of 3 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- share persistent memory across Claude Code, Codex, Cursor and Gemini CLI
- write rules once and sync to tool instruction files
- search shared memory
- save a memory
- load session start context
An alternative to claude-mem, Mem0, Zep/Graphiti, Supermemory and Basic Memory.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 0.1.11
An MCP client handshake over stdio listed 13 tools, and a call to search returned a result.
Differences the test machine hit
- README: Bun >=1.1 required, then npm install -g aletheia-mem
In the test: Bun must be installed manually first via bun.sh/install script - README: MCP launch command bun bin/mcp.mjs
In the test: installed package provides aletheia-mcp binary (bun wrapper) for on-PATH stdio server - README: install step 1 runs https://bun.sh/install straight from the network
In the test: nothing to change; a note: the box ran it without saving or reading it first, so pickfit did not inspect it