Cursor-history: управление историей чатов Cursor AI без предварительной настройки

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).

Проект активно развивается, и в будущем планируется расширение возможностей.