memory-bank-skill

Долгосрочная память проекта + dev-тулкит для 8 AI-агентов. AI запоминает проект между сессиями, соблюдает единые инженерные правила и продолжает работу ровно с того места, где остановился.

Поддерживаемые агенты: Claude Code · Cursor · Windsurf · Cline · Kilo · OpenCode · Codex · Pi Code.

Какую проблему решает

Каждая новая сессия AI-агента начинается с амнезии. Вы снова объясняете проект, снова описываете план, снова перечисляете выполненное. Правила забываются. Архитектура расползается. Компактизация контекста стирает всё, что агент наконец усвоил.

memory-bank-skill решает эту проблему, превращая память AI в полноценный инструмент — простую директорию .memory-bank/ внутри проекта, которую агент читает в начале каждой сессии и обновляет по ходу работы.

Эта директория хранится рядом с кодом (можно коммитить, шарить с командой или добавить в .gitignore — на ваш выбор).

Установка

Выберите подходящий способ:

Вариант 0: CLI skills.sh (самый быстрый)

Копирует бандл скилла (SKILL.md + скрипты + команды + агенты) в локальную директорию скиллов. Подходит для быстрого тестирования на одном хосте (Claude Code, Cursor или любой хост, читающий ~/.claude/skills/ или ~/.cursor/skills/). Для кросс-агентной настройки (хуки Codex / Windsurf / OpenCode, управляемые блоки в AGENTS.md, CLI memory-bank, хуки, глобально установленные slash-команды) используйте вариант 1 или 2.

Вариант 1: pipx (рекомендуется, кроссплатформенно)

pipx install memory-bank-skill           # стабильная версия
# или последний релиз-кандидат:
pipx install --pip-args='--pre' memory-bank-skill

memory-bank install                      # глобальная установка для Claude Code + Cursor + подсказки Codex + OpenCode
# опционально: явно указать язык установленных правил
memory-bank install --language ru

Требования: Python 3.11+, pipx, jq.

Вариант 2: Homebrew (macOS / Linuxbrew)

brew tap fockus/tap
brew install memory-bank
memory-bank install

Вариант 3: git clone (для разработчиков)

git clone https://github.com/fockus/skill-memory-bank.git ~/.claude/skills/skill-memory-bank
cd ~/.claude/skills/skill-memory-bank
./install.sh

Добавление кросс-агентной поддержки (Cursor, Windsurf, OpenCode и др.)

Три способа — выберите подходящий:

A. Интерактивное меню (из любого терминала — рекомендуется, если не уверены, какие клиенты нужны):

cd your-project/
memory-bank install                     # мультивыбор для всех 8 клиентов
# в TTY-режиме также спросит, какой язык использовать для правил

B. Флаги CLI (скрипты / CI / однострочник):

cd your-project/
memory-bank install --clients claude-code,cursor,windsurf
memory-bank install --clients claude-code,cursor --language en

C. Из агента с командной поверхностью (Claude Code / OpenCode):

Claude Code/OpenCode может использовать /mb install, после чего выполняется memory-bank install --clients <selected> для текущего проекта. В Codex используйте CLI напрямую; Codex получает глобальное обнаружение скиллов и подсказки ~/.codex/AGENTS.md, но не нативную командную поверхность /mb.

Поддерживаемые имена клиентов: claude-code, cursor, windsurf, cline, kilo, opencode, pi, codex. Поддерживаемые языки правил: en (по умолчанию), ru (полный перевод), es/zh (заготовки — приветствуются PR от сообщества, см. docs/i18n.md). Также можно задать MB_LANGUAGE=en|ru|es|zh.

Подробности по каждому клиенту: docs/cross-agent-setup.md.

Быстрый старт за 5 минут

1. Установите (см. выше).

2. Откройте проект в AI-агенте (Claude Code, Cursor и др.) и выполните:

   /mb init

   Команда создаёт .memory-bank/ со всеми файлами выше, определяет стек и генерирует CLAUDE.md (или эквивалент для вашего агента) с инструкциями по использованию памяти.

3. Работайте как обычно. Агент будет читать и обновлять память автоматически.

4. В следующей сессии агент загрузит контекст из .memory-bank/ и продолжит с того места, где остановился.