explaingit

kedarvartak/memops

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A monitoring and debugging toolkit that tracks health metrics for AI agents with persistent memory.

Mindmap

mindmap
  root((repo))
    What it does
      Tracks memory health
      Detects contradictions
      Replays sessions
    Tech stack
      Python
      SQLite
      Letta framework
    Use cases
      Debug stale AI memory
      Run regression tests on agent memory
      Catch duplicate memory writes
    Audience
      AI agent developers
      Researchers
    Metrics
      Churn rate
      Duplicate rate
      Contradiction score
    Workflow
      Baseline vs candidate
      Delta report
      CI exit codes

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

Monitor an AI agent's memory for stale or contradictory facts.

USE CASE 2

Compare a baseline run against a candidate run to catch memory regressions.

USE CASE 3

Replay an agent session step by step to find where a memory error was introduced.

What is it built with?

PythonSQLiteLetta

How does it compare?

kedarvartak/memops0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Currently built primarily around the Letta agent framework.

In plain English

MemOps is a monitoring and debugging toolkit for AI agents that use persistent memory, the kind of memory that lets an AI remember facts across multiple conversations or sessions. The problem it addresses is that persistent-memory agents can degrade in subtle ways that ordinary infrastructure dashboards do not catch: the agent might return stale or contradictory facts, repeatedly store near-identical memories, or slow down as the memory layer grows. MemOps captures a stream of memory events from an agent, including writes, reads, and rewrites, stores them in a local SQLite database, and computes health metrics from those events. Metrics include churn rate, or how often memories are rewritten, duplicate rate, contradiction score, stale recall rate, empty retrieval rate, and average retrieval latency. These turn invisible memory failures into numbers you can inspect and threshold. The regression analysis feature lets you compare two runs, a known good baseline against a candidate run after a code or policy change, and get a delta report showing which metrics worsened. The tool can return a non-zero exit code, making it usable inside automated test pipelines and continuous integration workflows. Sessions can be replayed step by step to pinpoint exactly which turn introduced a contradiction or loaded a stale memory. A local dashboard surfaces session timelines and root cause hints. The project is currently command-line first and built primarily around the Letta agent framework, though its internal event architecture is designed to support other frameworks through adapters. It is written in Python 3.11 or later.

Copy-paste prompts

Prompt 1
Help me set up MemOps to monitor a Letta-based AI agent's persistent memory.
Prompt 2
Explain how MemOps calculates churn rate and contradiction score from memory events.
Prompt 3
Show me how to use MemOps regression analysis to compare two agent runs in CI.

Frequently asked questions

What is memops?

A monitoring and debugging toolkit that tracks health metrics for AI agents with persistent memory.

What language is memops written in?

Mainly Python. The stack also includes Python, SQLite, Letta.

How hard is memops to set up?

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

Who is memops for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.