OKF Agent Memory
Git-родная постоянная память проекта для агентов на базе Open Knowledge Format: один бинарник на Go, встроенный MCP-сервер и поиск BM25
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает и пишет файлы памяти проекта под git
- Запускает локальный процесс MCP-сервера
Установка
Ручная установка
git clone https://github.com/okf-memory/okf-agent-memory.git
cd okf-agent-memory
make build
./bin/okf mcp knowledgeСобирает бинарник bin/okf и запускает встроенный MCP по stdio. Есть формула Homebrew.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OKF Agent Memory хранит знания проекта в git-родном формате Open Knowledge Format вместо раздувания CLAUDE.md или вектора. Архитектура двойной памяти делит нормативную рабочую память, которую агент держит всегда, и семантическую память домена, которая занимает ноль токенов в базовом состоянии и запрашивается по требованию через okf_search и okf_show. Инструмент собран на Go в один бинарник без зависимостей и рассчитан на частые вызовы в цикле агента. Он умеет валидировать и искать по знанию, создавать и обновлять записи, разворачивать структуру памяти в проект и запускать встроенный MCP-сервер по stdio.
Для кого. Для разработчиков, которым нужна быстрая, читаемая и хранимая в git память проекта без внешней базы.
Подходит, если
- Нужна память проекта в git, а не в векторном хранилище
- CLAUDE.md или AGENTS.md раздулись и агент теряет инструкции
- Нужен быстрый поиск по знанию прямо в цикле агента
Не подходит, если
- Нужен готовый семантический поиск на эмбеддингах, а не BM25 по markdown
- Не готовы собирать бинарник из исходников на Go
Пример запроса к агенту
Запиши решение по схеме авторизации в память OKF и найди связанные записи по слою архитектурыОграничения
Инструмент собирается из исходников на Go, готового пакета в стандартных менеджерах может не быть, есть формула Homebrew. Память это markdown в формате OKF v0.2, поиск идет по BM25, а не по эмбеддингам. Опциональная синхронизация через Hub требует токена и ключа.
Как отключить. Снимите запись MCP из конфига агента и удалите собранный бинарник, папку knowledge/ в проекте можно оставить или убрать вручную.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| OKF_HUB_TOKEN секрет | Токен для опциональной синхронизации памяти через Hub. |
Проверка безопасности
- Читает и пишет файлы памяти проекта под git
- Запускает локальный процесс MCP-сервера
Коротко о README
README описывает OKF Agent Memory как git-родную постоянную память проекта на базе Open Knowledge Format v0.2. Архитектура двойной памяти делит нормативную рабочую память и семантическую память домена, которая занимает ноль токенов в базе и запрашивается через okf_search и okf_show. Инструмент собран на Go в один бинарник без зависимостей, быстрый в цикле агента, с поддержкой провенанса и уровней доверия. Он валидирует и ищет по знанию, создает и обновляет записи, разворачивает структуру в проект и запускает встроенный MCP-сервер по stdio.
Частые вопросы
Где хранится память?
В папке knowledge/ проекта в формате OKF v0.2, это обычный markdown под git, читаемый и без инструмента.
Это поиск по смыслу?
Поиск идет по BM25 по knowledge-бандлу, быстро и без эмбеддингов, с учетом провенанса и уровней доверия записей.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything