josephyaduvanshi/claude-history-manager — open-source проект на Swift, который стоит оценить перед внедрением или доработкой.
Для разработчиков, активно использующих Claude Code на macOS. Подойдёт всем, кто работает с десятками и сотнями сессий и хочет быстро находить нужные транскрипты.
Claude Code сохраняет транскрипты каждой сессии в JSONL-файлы в папке ~/.claude/projects/. Через несколько недель реального использования эта папка становится нечитаемой, grep не помогает, и единственный способ найти нужную сессию — вспомнить, в каком проекте она была, и листать ls -lt.
Chronicle читает файлы напрямую из ~/.claude/projects/, индексирует каждую сессию в локальную базу данных SQLite с полнотекстовым поиском (FTS5). Пользователь может искать по тексту, закреплять важные сессии, присваивать им теги и возобновлять любую сессию в любом терминале одной клавишей. Все транскрипты остаются на Mac и никогда не отправляются вовне.
Chronicle — это нативное macOS-приложение и CLI-утилита для управления историей сессий Claude Code. Оно автоматически индексирует все JSONL-транскрипты в SQLite, предоставляет удобный поиск, закрепление и тегирование, а также возможность возобновления сессий в один клик. Поддерживается установка через Homebrew (рекомендуется) или pkg-инсталлятор. Приложение полностью офлайн — данные не покидают устройство. Интерфейс...
Автор написал Chronicle, потому что устал посреди ночи грепать JSONL-файлы в поисках решения конкретной ошибки. Название выбрано не случайно: приложение ведёт летопись всех сессий.
Обязателен к установке, если вы активно используете Claude Code на macOS или Linux. Chronicle превращает хаос из сотен JSONL-файлов в удобную, быстро ищущуюся базу. Проект хорошо структурирован, имеет CLI и GUI, установка в одну команду через Homebrew.
Проект активно развивается, выпускаются стабильные релизы с GUI и CLI, есть поддержка Homebrew.
Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.
Chronicle — это нативное macOS-приложение и CLI-утилита для просмотра и управления историей сессий инструмента Claude Code. Оно индексирует JSONL-транскрипты в локальную базу SQLite и позволяет быстро находить, тегировать и возобновлять сессии.
Проект предназначен для разработчиков, которые пользуются Claude Code и хотят упорядочить историю сессий. Особенно полезен при большом количестве активностей, когда вручную искать транскрипты становится невозможно.
Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.