{"id":20811627,"url":"https://github.com/alexy-os/cursorai-chat-reader","last_synced_at":"2025-06-29T12:33:13.663Z","repository":{"id":261736699,"uuid":"885180463","full_name":"alexy-os/cursorai-chat-reader","owner":"alexy-os","description":"This tool helps you preserve and analyze your conversations with CursorAI","archived":false,"fork":false,"pushed_at":"2024-11-08T05:39:34.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-18T14:47:58.011Z","etag":null,"topics":["chatbot","cursor","cursorai"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexy-os.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-08T05:27:56.000Z","updated_at":"2024-12-05T14:00:05.000Z","dependencies_parsed_at":"2024-11-08T06:28:44.201Z","dependency_job_id":"647ed4f8-28c9-465a-97df-d1eafd584234","html_url":"https://github.com/alexy-os/cursorai-chat-reader","commit_stats":null,"previous_names":["alexy-os/cursorai-chat-reader"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexy-os%2Fcursorai-chat-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexy-os%2Fcursorai-chat-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexy-os%2Fcursorai-chat-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexy-os%2Fcursorai-chat-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexy-os","download_url":"https://codeload.github.com/alexy-os/cursorai-chat-reader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243158972,"owners_count":20245669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","cursor","cursorai"],"created_at":"2024-11-17T20:45:30.242Z","updated_at":"2025-03-12T04:44:11.222Z","avatar_url":"https://github.com/alexy-os.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Chat Reader\n\nRead and analyze VSCode CursorAI chat backups.\n\n## Overview\n\nThis 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.\n\n### How it works\n\n1. The tool reads SQLite database files from CursorAI backups\n2. Analyzes conversations using natural language processing:\n   - Identifies programming languages and technologies mentioned\n   - Categorizes discussions (debugging, architecture, learning, etc.)\n   - Extracts frequent terms while filtering out common words\n   - Counts code blocks and other content statistics\n3. Saves each conversation as a markdown file with metadata and tags\n\n### Analysis Components\n\n- **Content Analysis One**: Tracks code blocks, lists, and text volume in conversations\n- **Context Analysis Two**: Detects technologies and conversation categories\n- **Term Extraction**: Identifies important terms while filtering out common words using stop-words lists\n- **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\n\n## Setup\n\nBefore running the script, copy all `state.vscdb.backup` files from your Cursor backup directory to the `backup` folder:\n\n- Windows: `%AppData%\\Cursor\\Backups`\n- macOS: `~/Library/Application Support/Cursor/Backups`\n- Linux: `~/.config/Cursor/Backups`\n\nWhen 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.\n\n## Usage\n\n```bash\nnpm install\nnpm start\n```\n\n## Configuration\n\nYou can configure the script by editing the `chatreader.config.js` file:\n- Adjust minimum text length for saving conversations\n- Modify maximum number of terms to extract\n- Customize file naming templates\n- Configure directories for backups and output\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexy-os%2Fcursorai-chat-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexy-os%2Fcursorai-chat-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexy-os%2Fcursorai-chat-reader/lists"}