Cursor-history: управление историей чатов Cursor AI без предварительной настройки
Cursor-history — инструмент для управления историей чатов Cursor AI: поиск, экспорт и резервное копирование.
Он позволяет удобно просматривать и обрабатывать разговоры, которые могут быть разбросаны по различным рабочим пространствам и базам данных IDE. Основное отличие от альтернатив — это возможность работать с уже существующей историей без необходимости предшествующей настройки. Все операции происходят локально, без API-ключей и других внешних зависимостей. Это удобно для тех, кто часто использует Cursor AI и активно работает с его данными.
Проект написан на Node.js и требует его версии 20.x или 22.x–26.x. Установить можно через npm, а для быстрого тестирования доступна команда npx. Учти, что приложение предназначено для пользователей, у которых уже есть локальные данные Cursor, без предварительной обработки или индексации.
Cursor History
Проект Cursor History предоставляет единый интерфейс для доступа к всей истории взаимодействий с инструментом Cursor. Он объединяет данные, рассеянные по рабочим пространствам, базам данных IDE, отчетам агентов и новым хранилищам сессий CLI/ACP. С помощью библиотеки и командной строки `cursor-history` можно исследовать, управлять и экспортировать разговоры, создавать резервные копии и восстанавливать историю, а также мигрировать сессии между проектами.
Одной из ключевых особенностей является то, что поиск осуществляется локально, без необходимости в настройке индексирования или использования API-ключей.
Быстрый Старт
Чтобы установить проект, выполни следующую команду:
npm install -g cursor-history
После установки можешь использовать команду:
cursor-history list --all
Другие примеры команд:
cursor-history search "authentication"— поиск по истории.cursor-history show 1— просмотр сессии под номером 1.cursor-history export 1— экспорт сессии в файл.cursor-history backup— создание резервной копии истории Composer.
Основные требования: Node.js версии 20.x или от 22.x до 26.x, а также наличие локальной истории Cursor.
Причины создания
Проект создан для упрощения доступа к разговорным записям, которые могут быть scattered across различных проектах, сессиях и интерфейсах Cursor. При использовании инструмента сложно найти нужную информацию, особенно когда разговоры ведутся в разных рабочих пространствах. Теперь с помощью ключевых слов можно быстро находить нужные разговоры и взаимодействия.
Поддерживаемые источники данных
Инструмент автоматически обнаруживает следующие локальные источники данных:
- Legacy / Composer: хранит записи и глобальные данные о беседах.
- Agent transcripts: текст бесед и вызовы инструментов из отчётов агентов.
- Store / CLI: данные о беседах в пoрядке сессий.
- ACP sessions: данные сессий, найденные под корнем ACP.
Загрузка и установка
Рекомендуется устанавливать через NPM:
npm install -g cursor-history
Также есть возможность установить из исходников:
git clone https://github.com/S2thend/cursor_chat_history.git
cd cursor_chat_history
npm install
npm run build
node dist/cli/index.js list
Ограничения
Некоторые ограничения включают:
- Поддерживаются только данные из Composer, Store или транскрипты, не все данные могут быть перемещены или скопированы.
- Бэкапы содержат только данные Composer, а не Store или транскрипты.
- Требуется Node.js 20.x или версии от 22.x до 26.x.
Функции
- Использование как CLI-инструмента или встраивание в Node.js проекты.
- Поиск бесед по ключевым словам.
- Экспорт сессий в Markdown или JSON.
- Резервное копирование и восстановление истории Composer.
- Кроссплатформенная поддержка (macOS, Windows, Linux).
Проект активно развивается, и в будущем планируется расширение возможностей.
Радар проекта: 60 из 100 — крепкий проект
- Импульс 0 ≈ 0 звёзд в месяц
- Темп разработки 53 20 коммитов за 12 недель
- Зрелость 76 проекту 11 месяцев, 17 релизов
- Сообщество 36 6 участников, 18 форков
- Свежесть 90 последний коммит — 17 дней назад
- Быстрый старт 75 есть: команда установки, сайт/демо, примеры
- Готовность к продакшену 85 релиз v0.18.0, автосборка, тесты
- Безопасность и доверие 40 лицензия MIT
- Документация 97 README 45.2 тыс. знаков, 103 раздела, папка docs
- Экосистема 50 4 подписчика на обновления, 18 тем
Как считаем
Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: S2thend/cursor-history →
RepoRadar