Memory you can read
Every memory is a markdown file in `.tekmemo/`. Read it in your editor, review it in PRs, track it in Git — alongside your source code.
Local-first memory for AI agents — versioned, portable, and always there when the next session starts.
Works with Claude Code·Cursor·Codex·OpenCode·any MCP client
You walk your agent through the auth system. It gets it. Next session — a blank stare. You paste the architecture doc again, and it ships code that contradicts last week's decision. It has no memory of what you chose, because there was nowhere to put it.
Next session, your agent already knows. No repeating yourself. No contradictions. No "what were we working on again?"
Every decision, convention, and note sits in plain text under .tekmemo/. Open it in your editor. Diff it in review. Commit it with your code. Memory stops being a black box.
Stop scrolling through old prompts. TekMemo indexes your memory and returns the fragment that fits the task — semantically, not by keyword. Hybrid recall merges lexical and vector search, then reranks.
See how recall works →Local mode works offline. Hybrid adds a cloud replica so your memory follows you across machines. Managed runtime is on the roadmap. The engine and the API stay the same — you only change how memory is stored and synced.
Explore the cloud client →import { Tekmemo } from "@tekbreed/tekmemo";
// Default. Memory lives in .tekmemo/ as markdown + JSON.
// No API keys, no network. Read it, diff it, commit it.
const memo = new Tekmemo({
mode: "local",
rootDir: "./.tekmemo",
projectId: "my-app",
}); Give your app durable memory. Import @tekbreed/tekmemo — the same API whether memory lives in local files, the cloud, or both. The AI SDK runtime ships recall, context-building, and a tool definition ready to wire into any agent.
Your coding agent finally remembers your project. Install the MCP server, drop one config block into Claude Code, Cursor, or Codex, and your agent gets project context every session — automatically.
Connect your agent → Most memory tools hide your data in a dashboard you can't inspect. TekMemo stores everything as plain text and JSON in your project's .tekmemo/ directory — alongside the code it describes.
| Feature | TekMemo | Hosted Memory Tools |
|---|---|---|
| Where memory lives | ✓ Plain files in your repo | Locked in a remote dashboard |
| Inspect & edit | ✓ Any editor, any diff tool | Vendor UI only |
| Version control | ✓ Git-tracked with your code | Separate system (if at all) |
| Ownership | ✓ You own every byte | Vendor-dependent |
| Offline support | ✓ Full offline by default | Requires internet |
MIT Licensed · 100% open source
npx tekmemo init