gonzaroman/IHMT-MEMORY

Long-term memory for your AI coding agents. Tell your agent something once — a decision, how
your setup works, a correction — and it remembers it in every future session, in any project, with
any of your agents.
## What IHMT does
Remembers across sessions. Decisions and their reasons, your environment, your preferences,
people and projects, corrections. Your agent searches the memory before answering and saves what
lasts, so you stop repeating yourself.
One memory for all your agents and models. Claude Code, Codex and opencode can share the same
memory: what one saves, the others find. Tested with models from Anthropic, OpenAI, Google and Meta.
Saves tokens. Instead of pasting your notes or re-explaining context every session, the agent
retrieves only what the question needs — typically 200–900 tokens, whether the memory holds 50
entries or 50,000, because search walks a tree instead of reading everything.
Honest numbers, including where it does not save.
Understands time. When something changes ("I moved to Valencia", "staging is on PostgreSQL 17
now"), the old memory is kept as history, flagged OUTDATED, and searches answer with the current
one first. Where you live, where you work and your stack are tracked automatically; any other
correction is linked when the agent saves it with replaces. When a question is ambiguous ("Luis"
— which one?), it asks instead of guessing.
Portable. Your memory is one folder of plain text files. Copy it to another computer, back it
up, or put it under version control — it works wherever you put it.
Local, private and readable. No cloud, no database, no account: IHMT stores everything on your
disk and sends nothing anywhere. (The memories your agent retrieves reach its model like any other
context.) Every memory is a text file you can open, and each person who installs IHMT starts with
their own, empty memory.
> Compatibility. Officially supported: Claude Code. Also tested: Codex (CLI and the
> ChatGPT desktop app — setup) and opencode
> (setup). IHMT is a standard stdio MCP server, so any
> agent that supports local MCP servers should work — GitHub Copilot, Antigravity, Cursor, Windsurf,
> Gemini CLI, Claude Desktop… — and INSTALL.md knows how to configure them, but we have
> not tested those yet. All of them can share one memory.
## Install
### Before you start
| You need | Why |
| Python 3.10 or newer | IHMT is written in Python |
| git | to download IHMT and keep it updated |
| An AI agent that can run commands (Claude Code, Codex, opencode, Copilot in agent mode…) | it installs IHMT and then uses the memory |
| Internet, during the installation | to download the code and the MCP package; not needed afterwards |
Missing Python or git? Your AI agent installs them for you (it is instructed to ask you first).
Python goes in your user folder, with no administrator password, so nothing system-wide changes. On a brand-new Mac, git may need one click:
Apple shows a window asking to install its command-line tools.
On a Mac, note that the python3 that comes with macOS is version 3.9, which is too old — that is why
your agent may say Python is missing even though python3 exists.