Mohamed Ashraf Elsaed

Blog

Practical posts from real work: AI coding agents, MCP, Laravel, Node and Bun, and engineering decisions. Commands and numbers are included, and sources are dated.

RSS · JSON feed · Topics: ai-agents, aletheia, benchmarks, bun, ci, claude-code, frontend, hooks, laravel, loupe, mcp, quality-gate, reliability, sqlite, system-design, testing, tutorial

Aletheia vs claude-mem: reproducible numbers

A retrieval benchmark of Aletheia against claude-mem 15.2.0 on LoCoMo, with the commands to repeat it, the limits of the comparison and where claude-mem is far ahead.

· 3 min read

CI on Linux, macOS and Windows for a Bun project

What broke when I added a Windows runner to a Bun and SQLite project: temp-folder cleanup, path separators, shell assumptions and test timeouts, and how each was fixed.

· 2 min read

Hooks designed to fail open for AI coding agents

A failing hook must not stop your AI coding tool. How Aletheia hooks print nothing and exit 0 on error, spool to disk when the database is busy, and what the tests showed.

· 2 min read

Local-first memory for AI agents: system design

How Aletheia is built: hooks designed to fail open, redaction before storage, one SQLite file, a leased job queue and a bounded session-start block. Choices and trade-offs.

· 10 min read

How to use aletheia-mem: memory for AI agents

Install aletheia-mem, save and search memories, add a rule, see what a new session receives and preview the Claude Code installer. Run in a throwaway folder.

· 6 min read

Why AI coding agents forget between sessions

AI coding agents start every session blank. Here is how Aletheia captures sessions with hooks, stores them in SQLite and feeds context back, all on your machine.

· 2 min read