gitwtfhub

wtf is global-agent-memory?

ozankasikci/global-agent-memory — explained in plain English

Analysis updated 2026-05-18

13PythonAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A local, human-reviewed shared memory system that lets Claude Code, Codex, and other AI agents remember project knowledge over time.

Mindmap

mindmap
  root((global-agent-memory))
    What it does
      Shared agent memory
      Human reviewed
      Local first
    Tech stack
      Python
      SQLite
      Obsidian
      MCP
    Use cases
      Cross agent knowledge
      Approve candidates
      Browse in Obsidian
    Audience
      Claude Code users
      Codex users
      Developers

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

Why would anyone build with this?

REASON 1

Give multiple AI coding agents a shared memory of project conventions and decisions.

REASON 2

Review and approve what an AI agent is allowed to remember before it becomes permanent.

REASON 3

Browse and edit your project's stored knowledge as Markdown notes in Obsidian.

What's in the stack?

PythonSQLiteObsidianMCPOllama

How it stacks up

ozankasikci/global-agent-memory1lystore/awaek47cid/wp2shell-lab
Stars131313
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencedevelopervibe coderresearcher

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

How do you spin it up?

Difficulty · easy Time to first run · 30min

Guided installer handles setup, optional Ollama needed for semantic search.

Wtf does this do

Global Agent Memory gives AI coding assistants like Claude Code and Codex a shared, long-term memory that a human can review and control. Instead of each tool keeping its own scattered notes, this project stores knowledge such as project conventions, past solutions, and preferences in plain Markdown files that live in one central place, called a Vault. When an AI agent learns something worth remembering, it does not save it directly. It proposes the memory as a candidate. A person then reviews the dashboard and decides whether to approve, edit, reject, or mark it as protected before it becomes part of the permanent record. This human-in-the-loop step is meant to stop AI agents from quietly filling your memory with wrong or unwanted information. The system is built around three connected pieces. A local background service, called a daemon, speaks the Model Context Protocol so any compatible AI agent can search and propose memories. The Vault itself is readable in Obsidian, complete with linked notes and templates, for people who want to browse and edit their knowledge base by hand. And a local dashboard offers a simpler review screen for approving candidates, resolving conflicts, and checking system health. All of it runs on your own machine, with the daemon listening only on localhost and requiring an access token, so no data leaves your computer unless you choose to sync it yourself. Search combines simple keyword lookup with an optional local AI model for smarter, meaning-based results, and the whole system keeps working even if that optional piece is offline. Getting started is a single install command followed by a guided setup wizard that detects Claude Code or Codex on your machine and configures everything automatically. It requires Python 3.12 or newer and works on macOS and Linux.

Yoink these prompts

Prompt 1
Help me install and set up Global Agent Memory for Claude Code.
Prompt 2
Explain how the candidate approval workflow protects my memory Vault.
Prompt 3
Show me how to search my Vault using the MCP tools this project exposes.
Prompt 4
How do I protect a sensitive memory so agents cannot read it by default?

Frequently asked questions

wtf is global-agent-memory?

A local, human-reviewed shared memory system that lets Claude Code, Codex, and other AI agents remember project knowledge over time.

What language is global-agent-memory written in?

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

How hard is global-agent-memory to set up?

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

Who is global-agent-memory for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.