Documentation

12 documents, generated from the Markdown in docs/. The Markdown is canonical.

Core

1. Architecture — claude-mem is a memory plugin for coding agents. Its worker (scripts/worker-service.cjs, a 4.2 MB Bun bundle) records every prompt, tool call, observation and session summary in...
2. Data model — Opened with readonly: true, PRAGMA queryonly = ON, busytimeout = 1500. Every SELECT goes through a helper that turns "no such table" and "no such column" into an empty result, s...
3. HTTP API — Base: http://127.0.0.1:<port>. All JSON responses carry Cache-Control: no-store. Pages carry Content-Security-Policy: frame-ancestors 'none' and X-Frame-Options: DENY.
6. Frontend — Aletheia has one app page at /. It is plain HTML, CSS and JavaScript: no framework, no build step, no font file, no CDN and no dependency. It works offline. The older claude-mem...
7. Operations — bun bin/aletheia-server.mjs

25. Installers and automatic capture — Status: implemented and validated 2026-10-26. This page records what each installer writes, which hook fields it reads, and what is verified on this machine. Five more hosts and...
29. Aletheia Sync — Status: implemented, 2026-10-26 (T-102, T-103, T-104, T-108; E2EE T-117). This page describes the code that exists.
30. The private remote MCP endpoint — Status: implemented, 2026-10-26 (T-107, on top of T-067 and T-104/T-108). This page describes the code that exists and is tested by test/remote-mcp.test.mjs.

31. Team mode — Status: implemented and tested, 2026-10-26 (T-112). This page describes what the code does. It does not claim SSO, SCIM, compliance certificates or an SLA; none of those are built.
32. Requests, goals, story and economics — Status: implemented, 2026-10-27. This page describes the code that exists: src/hub/requests.mjs, goals-rollup.mjs, artifacts.mjs, story.mjs, economics.mjs, rule-suggest.mjs, rul...
Claude Desktop and the aletheia MCP server — Claude Desktop speaks MCP over stdio. Aletheia's server is bin/mcp.mjs; one JSON entry under mcpServers is all it needs. No hook and no rules file exist for Claude Desktop, so t...
Dependencies — Aletheia has no required runtime dependencies. It uses the Bun standard library and Bun's built-in SQLite binding only. The audit that enforces this is scripts/audit-deps.mjs: