explaingit

ozankasikci/global-agent-memory

Analysis updated 2026-05-18

13PythonAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

PythonSQLiteObsidianMCPOllama

How does it compare?

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 get it running?

Difficulty · easy Time to first run · 30min

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

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.