OpenCode Session Manager

English

Закрепляй, бэкапь и восстанавливай opencode AI-сессии — больше никогда не потеряешь важный разговор.

🎬 Демо скоро — закрепление, бэкап и восстановление сессии через чат.

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

Терял важный AI-чат? Не можешь найти ту сессию недельной давности? Сессий накопилось столько, что не уследишь, что важно?

OpenCode Session Manager — плагин, дающий AI-агенту слой памяти через управление сессиями. Пишешь обычным языком — «запинть эту сессию», «забэкапь те, что про платежи», «почисти старые» — и агент вызывает нужный tool. Команды учить не надо.

Возможности

• 📌 Pin / unpin — закрепляй важные сессии; закреплённые никогда не удаляются автоматически.
• 💾 Бэкап — одна сессия или все закреплённые; переживает переустановку и перенос на другую машину.
• ♻️ Восстановление — верни сессию из бэкапа одной фразой.
• 🧹 Автоочистка — старые незакреплённые сессии бэкапятся и удаляются (закреплённые всегда защищены).
• 🔍 Поиск — находи сессии по подстроке в названии.
• ⚙️ Настройка — cleanup / retention; настроил и забыл.

Установка

Добавьте scoped-пакет в массив plugin файла ~/.config/opencode/opencode.json — opencode сам установит его из npm:

// ~/.config/opencode/opencode.json
{
  "plugin": ["@enerjizeit/opencode-session-manager"]
}

Перезапустите opencode — плагин загрузится автоматически. Подробности по использованию — см. USAGE.ru.md.

Локальная разработка / установка из исходников (clone + build):

git clone https://github.com/EnerJizeIT/opencode-session-manager.git
cd opencode-session-manager && ./install.sh

Обновление

opencode не обновляет плагины автоматически — он пинит версию при первой установке. Чтобы обновиться до новой версии:

rm -rf ~/.cache/opencode/packages/@enerjizeit/opencode-session-manager
rm -rf ~/.cache/opencode/packages/@enerjizeit/opencode-session-manager@latest

Затем перезапустите opencode — он переустановит @latest из npm. (Или пиньте точную версию в plugin[], напр. "@enerjizeit/[email protected]".)

Архитектура

Хранение

State-файл session-manager.json хранит pinned-список и настройки. Запись атомарная: .tmp → rename. Бэкапы в backups/<id>.json. Всё лежит вне БД opencode — переживёт переустановку.

CLI-first

Все операции с сессиями идут через opencode CLI (Bun shell $), не через прямой SQL. Write-SQL запрещён. parseJson терпит [page-assist]-шум в stdout.

Backup envelope

Формат: {version, exportedAt, backupOf, session}, где session — сырой opencode export (родной round-trip для opencode import). Формализован в backup-schema.json.

Backup-then-delete

Удаление только после успешного бэкапа. Команды opencode session archive не существует, поэтому cleanup = бэкап → opencode session delete.

Protected backups

Pinned-бэкапы и orphaned (сессии уже нет в БД — это единственная копия) защищены навсегда. Corrupt-файлы переименовываются в .corrupt.

Хуки

• session.idle — auto cleanup + backup retention; дебаунс 1 час через lastAutoRun
• session.deleted — уборка удалённой сессии из pinned-списка
• Хуки никогда не роняют opencode (try/catch на каждом уровне)

Миграция

version в state + migrateState (merge-with-defaults) для будущих изменений схемы.

Файлы проекта

| Файл | Описание | |---|---| | session-manager.ts | Плагин (12 tools, 2 hooks) | | backup-schema.json | JSON Schema backup envelope | | README.md | Английский README | | USAGE.ru.md | Пользовательский гайд (RU) |

Детали

Архитектура кратко описана в разделе «Архитектура» выше; полный пользовательский гайд — USAGE.ru.md (English).