EchoesVault for OpenCode — плагин

EchoesVault ведет память проекта страницами markdown в git: решения и исправления читают OpenCode, Codex и Claude Code.

  • 159 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Расширенный доступ

Почему такой уровень

  • Плагин пишет файлы в репозиторий и меняет страницы знаний; запись идет только после явных команд.
Все причины и проверки

psinetron/echoes-vault-opencode

Установка

Работает в

Ручная установка

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["echoes-vault-opencode"]
}

Установка через конфигурацию OpenCode из README. После перезапуска выполните `/echoes-init` в нужном репозитории.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Плагин пишет файлы в репозиторий и меняет страницы знаний; запись идет только после явных команд.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

EchoesVault для OpenCode, плагин памяти, хранит архитектурные решения, проверенные исправления и ежедневные заметки в markdown-файлах самого репозитория. Версия 2 стала тонким адаптером протокола EchoesVault 1.0.0: OpenCode, Codex, Claude Code и скрипты записывают через одну общую программу `.echoes-vault/echoes_vault.py` и читают одну базу. Команды: `/echoes-init` создает или переносит хранилище, `/echoes-start` загружает индекс и три последних дневных записи, `/echoes-status` показывает состояние без изменений, `/echoes-end` пишет итог сессии. Плагин добавляет инструменты поиска по страницам, хеширования и защищенного обновления страниц.

Для кого. Командам, которые работают в одном репозитории с разными агентами и хотят хранить знания о проекте рядом с кодом, а не в чужой базе.

Подходит, если

  • Новая сессия OpenCode должна знать прошлые решения по архитектуре без пересказа.
  • В репозитории работают Codex и Claude Code, и знания нужны в одном общем месте.
  • Исправление с причиной хочется записать в страницу, чтобы не повторять ошибку.
  • Здоровье хранилища проверяют перед ревью: конфликты, метаданные, готовность Git.

Не подходит, если

  • Репозиторий нельзя засорять служебными каталогами `EchoesVault` и `.echoes-vault`.
  • OpenCode старше 1.16.0 или нет `python3`.
  • Знания нужны в общей вики вне репозитория.

Пример запроса к агенту

Загрузи индекс хранилища и три последние записи, затем найди страницы про выбор очереди сообщений и подскажи, что я решил в прошлый раз.

Ограничения

Нужны OpenCode 1.16.0 или новее и Python 3.9 под именем `python3`; другое имя задают переменной `ECHOES_VAULT_PYTHON`. Установка плагина ничего не создает в репозитории: хранилище появляется только после команды `/echoes-init`. Она же переносит распознанные старые команды и навыки OpenCode, а незнакомые пользовательские файлы адаптера сохраняет и сообщает о них. Итог сессии `/echoes-end` пишется только по явной команде, а замена существующей страницы требует свежего хеша SHA-256.

Как отключить. Уберите `echoes-vault-opencode` из списка `plugin` в конфигурации OpenCode и перезапустите его. Каталоги `EchoesVault` и `.echoes-vault` вместе с заметками остаются в репозитории, удалите их вручную, если не нужны.

Частые вопросы

Как установить плагин?

Через OpenCode: Ctrl+P, пункт Install plugin, имя `echoes-vault-opencode`, перезапуск. Либо добавьте его в список `plugin` конфигурации.

Какие инструменты добавляет плагин?

Среди них `echoes_activate_vault`, `echoes_start_session`, `echoes_vault_status`, `echoes_append_to_daily_log`, `echoes_search_vault_pages`, `echoes_hash_vault_page` и `echoes_create_or_update_page`.

Что обязательно в метаданных страницы?

Frontmatter с полями `type`, `stack`, `status` и `summary`. Сводка `summary` пишется одной строкой не длиннее 160 символов.

Нужен ли сетевой сервис или ключ?

Нет. По README не требуются сетевой сервис, база данных, ключ API и сторонние пакеты Python.

Создает ли плагин хранилище сам?

Нет. Установка ничего не создает в репозитории, хранилище появляется после команды `/echoes-init`.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Плагин Codex ведет в репозитории вики проекта на markdown и поднимает ее в начале сессий, в том числе для OpenCode и Claude Code.

ПлагинРасширенный доступ127Звезды репозитория

Плагин OpenCode хранит решения и договоренности проекта между сжатиями контекста и сессиями, без лишних вызовов модели.

ПлагинРасширенный доступ199Звезды репозитория

Плагин памяти для Claude Code и Codex: знания команды из вики, тикетов и чатов с цитатами и проверкой устаревшего.

ПлагинРасширенный доступ103Звезды репозитория

Honcho для OpenCode

Honcho Plugin for OpenCode

Долгая память для OpenCode: предпочтения и решения по проекту переживают перезапуск, сброс контекста и новый чат.

ПлагинРасширенный доступ62Звезды репозитория

Общий слой долгой памяти: агент ведет заметки в обычных markdown-файлах, а индекс MEMORY.md подгружается в начале каждой сессии.

СкиллРасширенный доступ204Звезды репозитория

Руководство и готовые файлы: Claude Code помнит решения между сессиями через хранилище Obsidian и команды /save и /resume

ВоркфлоуШирокий доступ1,1 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
EchoesVault for OpenCode (эта карточка)нет159
agent-memoryнет4 315хранит память агента в отдельном хранилище; EchoesVault держит знания markdown-страницами в самом репозитории рядом с кодом
Episodic Memoryнет499ищет по прошлым разговорам Claude Code; EchoesVault ведет курируемые страницы решений и дневные записи с защитой от перезаписи

Коротко о README

Плагин подключают через интерфейс OpenCode или список `plugin`. Хранилище создается командой `/echoes-init`, знания лежат страницами в `EchoesVault/pages`, а дневные записи получают разные имена, чтобы ветки Git не конфликтовали.

Бейдж для README

Сообщить о проблеме