Substrate-memory/Substrate-memory-plugins

Give your agents a memory that follows you across Claude, ChatGPT, Codex and Hermes.
AI memory for your team, editable, permissioned, owned.
trysubstrate.co: a context layer for your team and agents.
Gemini CLI: gemini extensions install https://github.com/Substrate-memory/Substrate-memory-plugins
MCP registry name: co.trysubstrate/memory (remote server https://app.trysubstrate.co/mcp)
Substrate remembers your decisions, preferences, people and projects. Connect once, and every supported agent recalls what matters before each turn and saves what matters after it. One connection screen, one review step, one approval. No API keys. No tokens to paste. No secrets to manage.
## What you get
Recall before every turn. Relevant memories are injected as context before the agent answers.
Automatic capture of every completed turn. User messages, assistant answers and bounded redacted tool calls and results are saved.
Session boundaries. Starts, resumes, resets, compacts and ends are recorded, so memory stays scoped to the right session.
Subagent capture. Work done by subagents is routed to the parent session.
Durable delivery. Nothing is stored twice. Hermes uses a profile-local write-ahead spool. Claude and Codex treat the host transcript as the spool: the server reports missing turns and the plugin sync re-imports them with deterministic ids.
Explicit remember and forget. Say "remember this" to keep a fact. Retract one fact without deleting its evidence trail.
Evidence. Check the source behind a recalled fact before you rely on it.
Import past conversations. Asked once, after connection. Only with your confirmation.
## How it works
text
Claude (Cowork, Claude Code) --> plugins/substrate-claude --\
ChatGPT (Work, Codex app, Codex CLI) --> plugins/substrate-codex --\
Hermes --> plugins/substrate-hermes --------------------------------+--> one server-side
Other MCP-capable agent --> plugins/substrate-mcp (fallback only) --/ MCP contract (v2)
recall + capture + memory store
Each package is a thin client. The server owns storage, ranking, redaction checks and the memory contract. Every host speaks the same contract (docs/mcp-contract.md, version 2): memoryturncontext opens the turn and returns recall, memorycapturetool records tool use, memorycaptureturn closes the turn, memorysessionboundary marks lifecycle events, memoryimport replays missed or past turns, and memorysearch, memoryexpand, memoryevidence, memoryremember, memoryforget read and write memory. The legacy Hermes /api/v1 wire stays supported on the server during the rollout.
## Install
Paste this into the agent you want to connect:
text
Install Substrate memory in this agent by following https://trysubstrate.co/install.md
The agent follows docs/install.md (the same file served at that link). It identifies its host and installs the right package. From this repository, the same request works too:
text
Install the memory plug-in at https://github.com/Substrate-memory/Substrate-memory-plugins
The flow is the same everywhere: Install → Sign in → Review → Approve connection → Connected to Substrate. Only report Connected to Substrate. after an authenticated memory smoke test (memorysearch) succeeds. The browser's Connection approved state is consent only; it is not proof that the agent finished connecting. Never paste or request API keys, manual tokens, or client secrets.