https://github.com/ibrahim317/cursor-chat-transfer
Transfer your AI chat conversations between Cursor IDE workspaces and devices with an intuitive UI.
https://github.com/ibrahim317/cursor-chat-transfer
chat cursor export extension import share sqlite
Last synced: 14 days ago
JSON representation
Transfer your AI chat conversations between Cursor IDE workspaces and devices with an intuitive UI.
- Host: GitHub
- URL: https://github.com/ibrahim317/cursor-chat-transfer
- Owner: ibrahim317
- License: mit
- Created: 2025-11-11T14:45:05.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-07T19:46:22.000Z (23 days ago)
- Last Synced: 2026-04-07T21:16:56.696Z (23 days ago)
- Topics: chat, cursor, export, extension, import, share, sqlite
- Language: JavaScript
- Homepage:
- Size: 276 KB
- Stars: 40
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cursor Chat Transfer
Transfer your AI chat conversations between Cursor IDE workspaces and devices with an intuitive UI.
## Features
### Export Chats
- Export all chats or select specific ones
- Auto-detects workspace by name and path
- Saves to `.cursor-chat.json` format
- Includes all messages and bubbles
### Import Chats
- Import from exported files
- Creates copies with new IDs (safe for re-importing)
- Auto-detects target workspace
- Preserves all chat data and conversation history
## Usage
1. Open the **Cursor Chat Transfer** view in the Activity Bar (left sidebar)
2. Click any action:
- **Export Chats** → Save chats to file for backup or transfer
- **Import Chats** → Load chats from exported file
3. Follow the prompts to select workspaces and files
### Alternative: Command Palette
You can also access all features through the Command Palette (Cmd/Ctrl+Shift+P):
- `Cursor Chat Transfer: Export Chats`
- `Cursor Chat Transfer: Import Chats`
## Important
**After importing chats, you MUST completely close and reopen Cursor IDE for the chats to appear.** Simply reloading the window (Cmd/Ctrl+R) is not sufficient. Cursor loads chat data on startup, so a full restart is required to see the transferred conversations.
## Why Use This?
- **Switch Devices**: Moving to a new computer? Take your chat history with you
- **Backup Important Conversations**: Save your valuable AI interactions and code discussions
- **Share Context**: Transfer relevant chats to another workspace working on similar problems
- **Workspace Organization**: Reorganize chats across different project workspaces
## Auto-Detection
Works seamlessly across platforms:
- **Windows**: `%APPDATA%/Cursor/User/workspaceStorage`
- **macOS**: `~/Library/Application Support/Cursor/User/workspaceStorage`
- **Linux**: `~/.config/Cursor/User/workspaceStorage`
- **Linux Remote/SSH**: `~/.cursor-server/data/User/workspaceStorage`
- **WSL**: `/mnt/c/Users//AppData/Roaming/Cursor/User/workspaceStorage`
The extension shows workspace names and folder paths (not internal hashes) for easy identification.
## Troubleshooting
### Large Databases
If your global database is very large and export feels slow, try:
1. **Clear old chat history** in Cursor settings
2. **Export specific chats** instead of all at once
3. **Delete old workspace folders** in Cursor's `workspaceStorage` directory
### sqlite3 Required
This extension requires `sqlite3` CLI to be installed for all database operations (read and write). It's usually pre-installed on:
- **Linux**: Most distributions
- **macOS**: Pre-installed
**Windows Installation:**
1. Download `sqlite-tools-win-x64-*.zip` from [sqlite.org](https://sqlite.org/download.html)
2. Extract `sqlite3.exe` to one of these locations (the extension will auto-detect):
- `C:\sqlite3\sqlite3.exe` (recommended)
- `C:\Program Files\sqlite3\sqlite3.exe`
- Any directory in your system PATH
3. Alternatively, install via package manager:
- **Chocolatey**: `choco install sqlite`
- **Scoop**: `scoop install sqlite`
## Requirements
- Cursor IDE with chat composer feature
- `sqlite3` CLI (pre-installed on Linux/macOS, see above for Windows)
## License
MIT
---
*Technical Note: The extension uses the system `sqlite3` CLI for both reading and writing, which handles WAL mode databases while Cursor is running.*