{"id":37227715,"url":"https://github.com/vitalyis/cursor-chat-recovery-kit","last_synced_at":"2026-04-18T21:06:31.675Z","repository":{"id":331660410,"uuid":"1131720975","full_name":"vitalyis/cursor-chat-recovery-kit","owner":"vitalyis","description":"Recover and migrate your Cursor IDE chat history when workspace folders are renamed or lost","archived":false,"fork":false,"pushed_at":"2026-04-18T19:08:53.000Z","size":1931,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T20:34:45.215Z","etag":null,"topics":["backup-tools","bash","chat-recovery","cursor","cursor-ide","developer-tools","macos","python","sqlite","workspace-management"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"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/vitalyis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":null},"created_at":"2026-01-10T15:13:14.000Z","updated_at":"2026-04-18T19:08:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vitalyis/cursor-chat-recovery-kit","commit_stats":null,"previous_names":["vitalyis/cursor-chat-recovery-kit"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/vitalyis/cursor-chat-recovery-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitalyis%2Fcursor-chat-recovery-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitalyis%2Fcursor-chat-recovery-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitalyis%2Fcursor-chat-recovery-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitalyis%2Fcursor-chat-recovery-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vitalyis","download_url":"https://codeload.github.com/vitalyis/cursor-chat-recovery-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitalyis%2Fcursor-chat-recovery-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31984590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"ssl_error","status_checked_at":"2026-04-18T20:23:29.375Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["backup-tools","bash","chat-recovery","cursor","cursor-ide","developer-tools","macos","python","sqlite","workspace-management"],"created_at":"2026-01-15T03:23:39.285Z","updated_at":"2026-04-18T21:06:31.668Z","avatar_url":"https://github.com/vitalyis.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Chat Recovery Kit\n\n![Cover Image](assets/cover.png)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Platform: macOS](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)\n\nToolkit for recovering, backing up, exporting, and safely relocating Cursor IDE\nworkspace history when project folders are renamed, moved, or corrupted.\n\n## What It Solves\n\nCursor binds chat history to workspace paths and IDs. When a folder is renamed\nor moved, the old conversations usually still exist, but Cursor may stop showing\nthem for the new path.\n\nThis kit helps you:\n\n- migrate chat history after a folder rename\n- back up Cursor workspaces and settings\n- recover from workspace corruption or data loss\n- export chat conversations to Markdown\n- relocate a git-backed repo without losing Cursor context\n\n## Quick Start\n\n```bash\ngit clone https://github.com/vitalyis/cursor-chat-recovery-kit.git\ncd cursor-chat-recovery-kit\nchmod +x bin/*.sh bin/*.py\n./bin/setup_aliases.sh\nsource ~/.zshrc\n```\n\n## Common Workflows\n\n### Recover Chat History After a Folder Rename\n\n```bash\ncursor-migrate 'Old Project Name' 'New Project Name'\n```\n\n### Back Up Cursor State\n\n```bash\ncursor-backup\ncursor-backups\n./bin/export_cursor_chats.sh\n```\n\n### Relocate a Repo Safely\n\n```bash\ncursor-relocate preflight /Users/me/OldRepo /Users/me/Projects/OldRepo\ncursor-relocate move /Users/me/OldRepo /Users/me/Projects/OldRepo --apply\n```\n\nThis relocation workflow:\n\n- backs up matching `workspaceStorage` entries\n- backs up matching `~/.cursor/projects/...` transcript and tool-log folders\n- moves linked git worktrees before the main repo move\n- recreates the old path as a symlink by default for Cursor compatibility\n\n\u003e [!IMPORTANT]\n\u003e Always close Cursor completely before running migration, relocation, or restore operations.\n\n## Commands\n\n### Migration\n\n- `cursor-migrate 'Old' 'New'`\n- `cursor-restore auto \u003cold\u003e \u003cnew\u003e [backup]`\n- `cursor-restore list-backups`\n- `cursor-restore list-workspaces [backup]`\n- `cursor-restore find \u003cpath\u003e`\n\n### Backup and Recovery\n\n- `cursor-backup`\n- `cursor-backups`\n- `cursor-emergency diagnose`\n- `cursor-emergency restore \u003cbackup\u003e`\n\n### Relocation\n\n- `cursor-relocate backup \u003cproject_path\u003e`\n- `cursor-relocate preflight \u003cold\u003e \u003cnew\u003e`\n- `cursor-relocate move \u003cold\u003e \u003cnew\u003e [--apply]`\n\n## Repo Layout\n\n```text\ncursor-chat-recovery-kit/\n├── bin/        # Executable shell + Python tools\n├── docs/       # Guides and reference docs\n├── tests/      # Validation scripts and test notes\n├── examples/   # Example commands\n├── assets/     # Images for GitHub/docs\n└── *.md        # Root docs, changelog, release notes\n```\n\n## What's Included\n\n- 12 executable scripts\n  10 shell scripts\n  2 Python helpers\n- backup, migration, relocation, export, and emergency recovery tooling\n- quick validation and broader test scripts\n- release notes and changelog tracking\n\n## Documentation\n\n- [Quick Start](QUICKSTART.md)\n- [Migration Guide](docs/MIGRATION_GUIDE.md)\n- [Backup Guide](docs/BACKUP_GUIDE.md)\n- [Emergency Recovery](docs/EMERGENCY_RECOVERY.md)\n- [Features and Commands](docs/FEATURES_AND_COMMANDS.md)\n- [Troubleshooting](docs/TROUBLESHOOTING.md)\n- [Repository Structure](REPO_STRUCTURE.md)\n- [Release Notes](RELEASE_NOTES.md)\n- [Changelog](CHANGELOG.md)\n\n## Version\n\nCurrent release: `v2.0.0`\n\n## License\n\n[MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitalyis%2Fcursor-chat-recovery-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvitalyis%2Fcursor-chat-recovery-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitalyis%2Fcursor-chat-recovery-kit/lists"}