https://github.com/alexy-os/cursorai-chat-reader
This tool helps you preserve and analyze your conversations with CursorAI
https://github.com/alexy-os/cursorai-chat-reader
chatbot cursor cursorai
Last synced: about 2 months ago
JSON representation
This tool helps you preserve and analyze your conversations with CursorAI
- Host: GitHub
- URL: https://github.com/alexy-os/cursorai-chat-reader
- Owner: alexy-os
- License: mit
- Created: 2024-11-08T05:27:56.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-11-08T05:39:34.000Z (6 months ago)
- Last Synced: 2025-01-18T14:47:58.011Z (3 months ago)
- Topics: chatbot, cursor, cursorai
- Language: JavaScript
- Homepage:
- Size: 6.84 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cursor Chat Reader
Read and analyze VSCode CursorAI chat backups.
## Overview
This tool helps you preserve and analyze your conversations with CursorAI. It processes chat history from VSCode's database backups, extracts meaningful content, and saves it in a readable markdown format with added analytics.
### How it works
1. The tool reads SQLite database files from CursorAI backups
2. Analyzes conversations using natural language processing:
- Identifies programming languages and technologies mentioned
- Categorizes discussions (debugging, architecture, learning, etc.)
- Extracts frequent terms while filtering out common words
- Counts code blocks and other content statistics
3. Saves each conversation as a markdown file with metadata and tags
### Analysis Components
- **Content Analysis One**: Tracks code blocks, lists, and text volume in conversations
- **Context Analysis Two**: Detects technologies and conversation categories
- **Term Extraction**: Identifies important terms while filtering out common words using stop-words lists
- **Stop Words**: Maintains lists of common technical terms and words in both English and Russian that should be excluded from analysis to focus on meaningful content
## Setup
Before running the script, copy all `state.vscdb.backup` files from your Cursor backup directory to the `backup` folder:
- Windows: `%AppData%\Cursor\Backups`
- macOS: `~/Library/Application Support/Cursor/Backups`
- Linux: `~/.config/Cursor/Backups`
When copying multiple backup files, allow your system to automatically rename duplicates (e.g., `state.vscdb.backup`, `state.vscdb.backup (1)`, etc.). This ensures all chat history is preserved.
## Usage
```bash
npm install
npm start
```
## Configuration
You can configure the script by editing the `chatreader.config.js` file:
- Adjust minimum text length for saving conversations
- Modify maximum number of terms to extract
- Customize file naming templates
- Configure directories for backups and output
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.