OpenMemory Auto Manager

How It Works

Terminal 1: type claude → OpenMemory auto-starts (refcount = 1)
Terminal 2: type gemini → shares same server (refcount = 2)
Terminal 3: type codex → shares same server (refcount = 3)
Terminal 1: exits → still running (refcount = 2)
Terminal 2: exits → still running (refcount = 1)
Terminal 3: exits → auto stops (refcount = 0)

Architecture

┌──────────────────────────────────────────────────────┐
│ Your Machine │
│ │
│ ┌─────────────┐ ┌────────────┐ ┌──────────────┐ │
│ │ Claude Code │ │ Gemini CLI │ │ Codex CLI │ │
│ │ │ │ │ │ │ │
│ │ HTTP MCP ───┼──┼── HTTP MCP │ │ STDIO only │ │
│ └─────────────┘ └────────────┘ │ │ │
│ │ │ │ Python Proxy │ │
│ │ │ │ STDIO→HTTP │ │
│ ▼ ▼ └──────┬───────┘ │
│ ┌──────────────────────────────────────────┐ │
│ │ OpenMemory MCP Server │ │
│ │ localhost:8080 │ │
│ │ │ │
│ │ • Synthetic embeddings (no API keys) │ │
│ │ • SQLite vector store │ │
│ │ • HSG tiered memory architecture │ │
│ │ • MCP tools: store, query, list, delete │ │
│ └──────────────────────────────────────────┘ │
│ │
│ Lifecycle managed by openmemory-manager.sh │
│ ┌──────────────────────────────┐ │
│ │ _om_ensure_running() │ │
│ │ _om_ref_incr() / _om_decr() │ │
│ │ zshexit cleanup hook │ │
│ └──────────────────────────────┘ │
└──────────────────────────────────────────────────────┘

Features

Prerequisites

Install OpenMemory Server

git clone https://github.com/CaviraOSS/OpenMemory.git ~/OpenMemory
cd ~/OpenMemory/packages/openmemory-js
npm install
npm run build

Install

git clone git@github.com:vancelin/openmemory.git ~/dev/memory
cd ~/dev/memory
# Create Python venv and install proxy dependency
uv venv .venv --python 3.11
uv pip install fastmcp --python .venv/bin/python
# Install shell hooks
chmod +x install.sh openmemory-manager.sh openmemory-codex-proxy.py
./install.sh

Files

MCP Configuration

Claude Code — .mcp.json

{
 "mcpServers": {
 "openmemory": {
 "type": "http",
 "url": "http://localhost:8080/mcp"
 }
 }
}

Gemini CLI — ~/.gemini/settings.json

{
 "mcpServers": {
 "openmemory": {
 "httpUrl": "http://localhost:8080/mcp",
 "trust": true
 }
 }
}

Codex CLI — ~/.codex/config.toml

[mcp_servers.openmemory]
command = "/path/to/.venv/bin/python"
args = ["/path/to/openmemory-codex-proxy.py"]

Available MCP Tools

Usage

Storing Memories

You: Remember that I prefer dark mode in all editors
Claude: *calls openmemory_store* → Stored!

You: 我喜歡用 Python 寫後端,前端用 React
Gemini: *calls openmemory_store* → Stored!

You: Note that the production DB port is 5433, not 5432
Codex: *calls openmemory_store* → Stored!

Searching Memories

You: What's my editor preference?
Claude: *calls openmemory_query("editor preference")* → "You prefer dark mode in all editors"

You: 生產環境的 DB port 是多少?
Gemini: *calls openmemory_query("production DB port")* → "5433"

Cross-Tool Recall

# Stored in Claude Code
You (Claude): Remember my project uses PostgreSQL 16
# Recalled in Gemini CLI
You (Gemini): What database does my project use?
Gemini: *calls openmemory_query* → "Your project uses PostgreSQL 16"

Screenshots

Environment Variables

Uninstall

sed -i '' '/# ── OpenMemory auto-start/,/# ── End OpenMemory hooks/d' ~/.zshrc

License

繁體中文版

OpenMemory 自動管理器

運作原理

終端機 1: 輸入 claude → OpenMemory 自動啟動 (refcount = 1)
終端機 2: 輸入 gemini → 共用同一個伺服器 (refcount = 2)
終端機 3: 輸入 codex → 共用同一個伺服器 (refcount = 3)
終端機 1: 關閉 → 仍然運行 (refcount = 2)
終端機 2: 關閉 → 仍然運行 (refcount = 1)
終端機 3: 關閉 → 自動停止 (refcount = 0)

架構

┌──────────────────────────────────────────────────────┐
│ 你的電腦 │
│ │
│ ┌─────────────┐ ┌────────────┐ ┌──────────────┐ │
│ │ Claude Code │ │ Gemini CLI │ │ Codex CLI │ │
│ │ │ │ │ │ │ │
│ │ HTTP MCP ───┼──┼── HTTP MCP │ │ 僅支援 STDIO │ │
│ └─────────────┘ └────────────┘ │ │ │
│ │ │ │ Python Proxy │ │
│ │ │ │ STDIO→HTTP │ │
│ ▼ ▼ └──────┬───────┘ │
│ ┌──────────────────────────────────────────┐ │
│ │ OpenMemory MCP 伺服器 │ │
│ │ localhost:8080 │ │
│ │ │ │
│ │ • 合成式嵌入(不需要 API Key) │ │
│ │ • SQLite 向量資料庫 │ │
│ │ • HSG 分層記憶架構 │ │
│ │ • MCP 工具:儲存、查詢、列表、刪除 │ │
│ └──────────────────────────────────────────┘ │
│ │
│ 生命週期由 openmemory-manager.sh 管理 │
│ ┌──────────────────────────────┐ │
│ │ _om_ensure_running() │ │
│ │ _om_ref_incr() / _om_decr() │ │
│ │ zshexit 清理鉤子 │ │
│ └──────────────────────────────┘ │
└──────────────────────────────────────────────────────┘

特色

系統需求

安裝 OpenMemory 伺服器

git clone https://github.com/CaviraOSS/OpenMemory.git ~/OpenMemory
cd ~/OpenMemory/packages/openmemory-js
npm install
npm run build

安裝

git clone git@github.com:vancelin/openmemory.git ~/dev/memory
cd ~/dev/memory
# 建立 Python 虛擬環境並安裝 Proxy 依賴
uv venv .venv --python 3.11
uv pip install fastmcp --python .venv/bin/python
# 安裝 Shell 鉤子
chmod +x install.sh openmemory-manager.sh openmemory-codex-proxy.py
./install.sh

檔案說明

MCP 設定

Claude Code — .mcp.json

{
 "mcpServers": {
 "openmemory": {
 "type": "http",
 "url": "http://localhost:8080/mcp"
 }
 }
}

Gemini CLI — ~/.gemini/settings.json

{
 "mcpServers": {
 "openmemory": {
 "httpUrl": "http://localhost:8080/mcp",
 "trust": true
 }
 }
}

Codex CLI — ~/.codex/config.toml

[mcp_servers.openmemory]
command = "/path/to/.venv/bin/python"
args = ["/path/to/openmemory-codex-proxy.py"]

可用的 MCP 工具

使用方式

儲存記憶

你: 記住我所有編輯器都偏好暗色模式
Claude: *呼叫 openmemory_store* → 已儲存!

你: 我喜歡用 Python 寫後端,前端用 React
Gemini: *呼叫 openmemory_store* → 已儲存!

你: 記一下 production DB port 是 5433,不是 5432
Codex: *呼叫 openmemory_store* → 已儲存!

搜尋記憶

你: 我的編輯器偏好是什麼?
Claude: *呼叫 openmemory_query("編輯器偏好")* → "你所有編輯器都偏好暗色模式"

你: 生產環境的 DB port 是多少?
Gemini: *呼叫 openmemory_query("production DB port")* → "5433"

跨工具記憶共享

# 在 Claude Code 中儲存
你 (Claude): 記住我的專案使用 PostgreSQL 16
# 在 Gemini CLI 中讀取
你 (Gemini): 我的專案用什麼資料庫?
Gemini: *呼叫 openmemory_query* → "你的專案使用 PostgreSQL 16"

示意圖

環境變數

解除安裝

sed -i '' '/# ── OpenMemory auto-start/,/# ── End OpenMemory hooks/d' ~/.zshrc

授權