claude-ltm

Долгосрочная память для Claude Code. Сохраняет решения по проекту между сессиями, чтобы контекст никогда не терялся.

Проблема

При больших объёмах работы контекст и решения, принятые в начале проекта, теряются по мере заполнения сессий Claude Code и ротации контекстного окна. Команды перестают понимать, почему были сделаны те или иные выборы, что было решено и что изменилось.

Как это работает

claude-ltm добавляет в проект постоянную память решений — структурированный Markdown-файл, который Claude читает при каждом старте сессии и обновляет по мере принятия решений.

По аналогии с человеческой памятью:

• Основной файл (.memory/DECISIONS.md) хранит краткие контрольные точки решений — то, что вспоминается сразу
• Файлы деталей (.memory/details/) хранят углублённый контекст для сложных решений — воспоминания, к которым обращаются при необходимости

Chester инструктируется через CLAUDE.md:

1. Читать память при старте сессии
2. Обновлять её при принятии значимых решений в ходе работы
3. Компактировать перед завершением — финальный проход для фиксации всего пропущенного

Никаких хуков, никаких внешних сервисов. Только Markdown-файлы и поведенческие инструкции.

Установка

1. Добавьте маркетплейс

Добавьте следующее в ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "claude-ltm-marketplace": {
      "source": {
        "source": "git",
        "url": "https://github.com/LaserPhaser/claude-ltm.git"
      }
    }
  }
}

2. Установите плагин

В любой сессии Claude Code:

3. Инициализируйте в проекте

В каждом проекте, где нужна долгосрочная память:

Это создаст .memory/DECISIONS.md и добавит инструкции в ваш CLAUDE.md.

Команды

/ltm:init

Инициализирует систему памяти в проекте. Создаёт директорию .memory/ и добавляет поведенческие инструкции в CLAUDE.md.

/ltm:compact

Вручную запускает проход компактирования. Claude просматривает текущую сессию и извлекает незафиксированные решения в .memory/DECISIONS.md.

Используйте в середине сессии, когда нужно создать контрольную точку решений.

/ltm:save

Явно сохраняет конкретное решение:

Claude форматирует его и добавляет в соответствующий раздел файла памяти.

Формат файла памяти

Основной файл (.memory/DECISIONS.md)

# Project Memory

> Auto-maintained by claude-ltm. Last updated: 2026-03-30

## Architecture

### REST API with Express.js [2026-03-28]
Chose REST over GraphQL because:
- Team has more REST experience
- Client is a simple SPA, no complex nested queries
- Easier to cache at the CDN level

### PostgreSQL for storage [2026-03-30]
Was: MongoDB. Switched because reporting features need JOINs
and the data turned out to be more relational than expected.

## Status
- **Focus**: User authentication flow
- **Blockers**: Waiting on payment provider API key
- **Open**: JWT vs session-based auth?

## Changelog
- 2026-03-30: Switched MongoDB → PostgreSQL

Правила:

• Каждое решение получает заголовок ### с датой
• До ~10 строк контекста на запись
• Разделы произвольные — Claude создаёт новые по мере необходимости
• Устаревшие решения обновляются на месте с пометками об изменениях

Файлы деталей (.memory/details/)

Для сложных решений, требующих более 10 строк:

---
decision: API Architecture
date: 2026-03-28
status: ACTIVE
---

## Context
[Why this decision was needed]

## Decision
[What was chosen and why]

## Alternatives Considered
- Option B: [why rejected]

## Impact
- [Key consequences]

Удаление

Удаление из конкретного проекта

Удалите секцию LTM из CLAUDE.md проекта — удалите всё между <!-- BEGIN claude-ltm --> и <!-- END claude-ltm -->. При желании удалите .memory/.

Глобальное удаление

Миграция с v0.1

Если ранее установка выполнялась через npx claude-ltm init:

1. Удалите из проекта следующие файлы (теперь они предоставляются системой плагинов глобально):
   • .claude/commands/ltm-init.md
   • .claude/commands/ltm-compact.md
   • .claude/commands/ltm-save.md
2. Директория .memory/ и инструкции в CLAUDE.md остаются без изменений — миграция не требуется
3. Установите плагин, как описано выше

Лицензия

MIT