explaingit

oyekamal/mnemo-agent

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

TLDR

An AI memory tool that lets Claude Code remember facts, people, and dates across separate sessions using a graph database.

Mindmap

mindmap
  root((mnemo-agent))
    What it does
      Persistent memory
      Cross session recall
      Cites sources and dates
    Tech stack
      Python
      FalkorDB
      Graphiti
      Docker
    Use cases
      Remember project facts
      Track ownership over time
      Auto summarize sessions
    Audience
      Claude Code developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a Claude Code coding assistant persistent memory of project decisions across sessions.

USE CASE 2

Track who owns a project, what it depends on, and when facts changed over time.

USE CASE 3

Automatically summarize and save context when a coding session ends.

What is it built with?

PythonFalkorDBGraphitiDockerMCP

How does it compare?

oyekamal/mnemo-agent0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Docker for the FalkorDB database plus an Anthropic API key.

In plain English

Mnemo is an AI assistant built to remember things across separate Claude Code sessions. Normally, when you close a chat with an AI assistant, everything you told it disappears. Mnemo fixes that by storing facts in a memory database that persists on disk, so you can tell it something today and ask about it again next week, in a brand new conversation, and it will recall the answer along with who said it and when it was true. Under the hood, Mnemo pairs a graph database called FalkorDB with a tool called Graphiti that turns plain text into a network of connected facts: people, projects, and the relationships between them. When you tell Mnemo something, it extracts the entities and links them together with dates attached. When you ask a question, it searches that graph using a mix of keyword matching, vector similarity, and relationship traversal, then answers in the voice of an archivist, always citing where and when a fact came from. Mnemo connects to Claude Code through the Model Context Protocol, exposing simple remember and recall tools, plus hooks that automatically start the memory database when a session begins and summarize the conversation into memory when it ends. This means a developer does not have to manually save notes. The embeddings used for search run locally on your machine, so no separate API key is needed for that part, though Claude itself is still used to extract facts and generate answers. To try it, you clone the repository, add your Anthropic API key to a config file, start the memory database with Docker, install the Python dependencies, and run the included test suite to confirm everything works. The project is explicitly described as an experiment rather than a finished product: it supports only a single local user, has no hosted or multi-user version, and its automatic session summaries can be uneven in quality. It is aimed at developers who already use Claude Code and want their coding assistant to remember context between sessions instead of starting from zero every time.

Copy-paste prompts

Prompt 1
Help me set up Mnemo so Claude Code remembers facts between sessions.
Prompt 2
Explain how Mnemo's remember and recall MCP tools work together.
Prompt 3
Walk me through configuring the FalkorDB Docker container for Mnemo.
Prompt 4
Show me how to add a custom entity type to Mnemo's graph schema.

Frequently asked questions

What is mnemo-agent?

An AI memory tool that lets Claude Code remember facts, people, and dates across separate sessions using a graph database.

What language is mnemo-agent written in?

Mainly Python. The stack also includes Python, FalkorDB, Graphiti.

How hard is mnemo-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mnemo-agent for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.