cursor-helper
| Crates.io | cursor-helper |
| lib.rs | cursor-helper |
| version | 0.1.1 |
| created_at | 2026-01-19 08:49:19.950067+00 |
| updated_at | 2026-01-23 03:04:47.977817+00 |
| description | CLI helper for Cursor IDE operations not exposed in the UI |
| homepage | |
| repository | https://github.com/lucifer1004/cursor-helper |
| max_upload_size | |
| id | 2054035 |
| size | 202,552 |
Gabriel Wu (lucifer1004)
documentation
README
cursor-helper
Stop losing your Cursor chat history. This CLI fixes the things Cursor doesn't expose in the UI.
The Problem
When you rename or move a project folder, Cursor loses all your chat history. Weeks of conversations, context, and problem-solving — gone.
The Solution
cursor-helper rename /old/project /new/project
Your chat history, workspace settings, and MCP cache stay intact.
Installation
# From crates.io (recommended)
cargo install cursor-helper
# Or from source
git clone https://github.com/lucifer1004/cursor-helper
cd cursor-helper
cargo install --path .
Requires Rust 1.70+. Works on macOS, Linux, and Windows.
Pre-built binaries for major platforms are available on the Releases page.
Key Commands
rename — Move Projects Without Losing History
# Move/rename a project
cursor-helper rename /path/to/old-project /path/to/new-project
# Copy instead of move
cursor-helper rename --copy /path/to/project /path/to/project-copy
# Preview changes first
cursor-helper rename -n /path/to/old /path/to/new
export-chat — Export Everything Cursor Hides
Cursor's built-in export omits thinking blocks and tool calls. This doesn't.
# Full export with thinking, tools, and token counts
cursor-helper export-chat /path/to/project -v
# Just the conversations
cursor-helper export-chat /path/to/project
# Export to JSON
cursor-helper export-chat /path/to/project --format json -o export.json
| Flag | What it adds |
|---|---|
--with-thinking |
AI reasoning/thinking blocks with duration |
--with-tools |
Tool calls (file reads, edits, shell commands) |
--with-stats |
Model name and token counts |
-v |
All of the above |
--include-archived |
Include archived sessions |
list — See All Your Projects
# List all projects (most recent first)
cursor-helper list
# Sort by chat count
cursor-helper list --sort chats --limit 10
# Filter by type
cursor-helper list --filter remote # SSH/tunnel projects
cursor-helper list --filter local # Local projects
clean — Reclaim Disk Space
Remove workspace data for deleted projects.
cursor-helper clean --dry-run # Preview
cursor-helper clean --yes # Delete without confirmation
Other Commands
| Command | Description |
|---|---|
stats |
Show chat count and storage size for a project |
backup |
Create a portable backup of project metadata |
restore |
Restore metadata to a new location |
clone |
Duplicate a project with independent chat history |
How It Works
Cursor stores metadata in platform-specific locations:
| Platform | Location |
|---|---|
| macOS | ~/Library/Application Support/Cursor/User/workspaceStorage/ |
| Linux | ~/.config/Cursor/User/workspaceStorage/ |
| Windows | %APPDATA%\Cursor\User\workspaceStorage\ |
Each project has a unique ID derived from its path. When you rename a folder, the ID changes and Cursor can't find the old data. This tool updates the necessary references.
Note: Linux support is experimental. Workspace hash computation depends on filesystem birthtime support, which varies by filesystem and kernel version.
Disclaimer
This tool is not affiliated with or endorsed by Anysphere, Inc. (Cursor).
It reads your local data files for personal backup and portability. It does not access Cursor's servers, APIs, or source code. See DISCLAIMER.md for details.
License
MIT — see LICENSE.