claude-replay

claude-replay

constripacityMIT
1 звёзд
Claude Replay — это слой наблюдаемости для Claude Code. Встроенные команды --continue и /rewind восстанавливают текущую сессию, но не дают доступа к истории. Claude Replay решает задачу, которую они не закрывают: он пассивно записывает каждую сессию в локальную базу SQLite. Запись происходит через хуки PreToolUse, PostToolUse и Stop. Вы можете искать по всем проектам, анализировать метрики, сравнивать сессии и экспортировать их. Данные не покидают вашу машину — всё хранится в каталоге ~/.claude-replay.
ClaudeDevelopmentSearch
Открыть на GitHub

Установка

uvx claude-replay

Характеристики

Общее

  • СтатусСообщество
  • Разработчикconstripacity
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

Сервер даёт набор инструментов для работы с историей сессий:

  • Полнотекстовый поиск по всем записанным сессиям Claude Code.
  • Детальная статистика по каждой сессии: количество шагов, затраченные токены и время.
  • Классификация причин завершения сессии (death-cause): ошибка, отмена пользователем или лимит токенов.
  • Сравнение двух сессий (diff) с наглядной разницей в контексте и цепочке действий.
  • Экспорт любой сессии в чистый HTML, JSON или Markdown.
  • Добавление тегов к сессиям для удобной каталогизации.
  • Добавление пользовательских заметок к сессиям.
  • Фильтрация сессий по проекту, дате, статусу и тегам.
  • Веб-дашборд на порту :8766 для визуализации таймлайна всех сессий.
  • Терминальный интерфейс (TUI) для быстрой навигации без выхода из терминала.
  • Восстановление (resume) произвольной сессии по чекпоинту.

Как подключить

Убедитесь, что у вас установлен Python 3.10 или новее.

Установите сервер через uvx:

uvx claude-replay

Добавьте конфигурацию в файл настроек вашего MCP-клиента (например, claude_desktop_config.json):

{ "mcpServers": { "claude-replay": { "command": "uvx", "args": ["claude-replay"] } } }

Перезапустите клиент. Сервер запустится автоматически при старте Claude Code или Claude Desktop. Все новые сессии начнут записываться в ~/.claude-replay/sessions.db.

Примеры запросов

  • «Найди все сессии за вчера, где упоминалась интеграция с PostgreSQL.»
  • «Покажи причину завершения последней сессии — она упала с ошибкой или я сам её закрыл?»
  • «Сравни сессию #10 и сессию #11. В чём разница в решениях?»
  • «Экспортируй сессию по работе над проектом frontend-v2 в формат Markdown.»
  • «Открой веб-дашборд Replay на порту 8766.»

Технические детали

  • Архитектура: пассивные хуки пишут в SQLite, MCP-инструменты и дашборд читают из неё.
  • Язык: Python 3.10+
  • Транспорт: stdio
  • Лицензия: MIT
  • База данных: SQLite (хранится в ~/.claude-replay/sessions.db)
  • Совместимость: Claude Desktop, Claude Code (CLI), любой MCP-клиент
  • Установка: uvx claude-replay

Поделиться