Grepathy автодокументує архітектурні рішення Claude Code прямо у Git
Grepathy аналізує локальні сесії Claude Code через git-хуки, витягує недокументовані рішення та зберігає їх у Markdown. Це вирішує проблему 30-денного ліміту зберігання логів Claude, надаючи команді та наступним агентам контекст архітектури.
Вплив: Високий
Чому це важливо
Тепер ви можете переглядати та зберігати кожне приховане рішення вашого кодинг-агента, не перериваючи свій процес вайб-кодингу.
TL;DR
- 01Claude Code видаляє історію чатів через 30 днів, втрачаючи контекст рішень.
- 02Grepathy автоматично витягує та структурує ці рішення під час git push.
- 03Історичні файли рішень повертаються майбутнім агентам через хуки.
Ключові факти
- Залежності виконання
- 0 (чистий TypeScript)
- Збереження логів
- 30 днів (за замовчуванням у Claude Code)
- Підтримувані інструменти
- Claude Code (незабаром Codex)
Проблема зникнення історії
Кодинг-агенти, такі як Claude Code, приймають десятки мікрорішень під час розробки. За замовчуванням Claude Code видаляє локальні сесії через 30 днів, залишаючи розробників без жодного контексту, коли колеги запитують причини обраного архітектурного шляху.
Як Grepathy автоматизує контекст
Замість того, щоб змушувати LLM писати логи під час роботи, Grepathy інтегрується в git push. Він парсить локальні чати, фільтрує конфіденційні дані та зберігає суть рішень у директорії .ai/why/. Якщо агент редагує файл, шлях до якого зафіксовано, хук PreToolUse автоматично додає історичні аргументи в активний контекст промпту.
Результати оцінювання та інтеграція
У сліпих тестах агенти, які мали доступ до файлів рішень Grepathy, показали значно кращі результати за базовий рівень, уникаючи галюцинацій щодо логіки недокументованого коду. Утиліта не потребує серверів, написана на чистому TypeScript і має нуль залежностей виконання.
Спробуй за 2 хвилини
npm install -g grepathy
grepathy initbash
✓ Коли використовувати
- При використанні Claude Code для автономної розробки
- Для передачі контексту рішень агента колегам під час рев'ю коду
- Для запобігання втраті локальних логів розробки
✕ Коли НЕ варто
- Якщо ви використовуєте лише веб-інтерфейс чатів
- Для проектів без системи контролю версій Git
Що зробити сьогодні
- Встановіть grepathy глобально
- Запустіть grepathy init у вашому поточному проекті з Claude Code
- Перевірте налаштування pre-push хука
Що каже спільнота
“Amazing to me how little these companies respect the historic value of the transcripts. Most of my work is captured in them now.”
Джерела