cursor-chat-recovery 0.2.0__tar.gz

cursor_chat_recovery-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+      - run: uv python install ${{ matrix.python }}
+      - run: uv sync --dev
+      - run: uv run pytest
+      - run: uv run ruff check
+      - run: uv run mypy src/

cursor_chat_recovery-0.2.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.venv/
+
+# harness-local
+.claude/
+LAUNCH.md

cursor_chat_recovery-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kuba Kwiecien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cursor_chat_recovery-0.2.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: cursor-chat-recovery
+Version: 0.2.0
+Summary: Inventory, view, reassign, and export Cursor chats
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: prompt-toolkit>=3.0.43
+Description-Content-Type: text/markdown
+
+# cursor-chat-recovery
+
+[![CI](https://github.com/kwiscion/cursor-chat-recovery/actions/workflows/ci.yml/badge.svg)](https://github.com/kwiscion/cursor-chat-recovery/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
+
+Did your Cursor chats disappear after you moved, renamed, or re-opened a project? They're not gone. This is an interactive terminal UI to **recover, browse, move, and export Cursor AI chat history** — across all your projects.
+
+## Why chats "disappear"
+
+Cursor identifies each workspace by a hash of its identifier URI. Reopening a project from a different path, or saving an Untitled multi-folder workspace as a `.code-workspace` file, mints a new workspace identity and detaches all prior chats from the sidebar. The conversations are still in `globalStorage/state.vscdb` keyed by `composerId` — they just need their `workspaceIdentifier` rewritten to point at the new workspace. That's what this tool does, with backups at every step.
+
+It's also useful when nothing is broken: browse every chat you've ever had in any project, move chats between workspaces, and export conversations to Markdown.
+
+## Install
+
+Requires Python 3.10+. With [uv](https://docs.astral.sh/uv/):
+
+    uv tool install git+https://github.com/kwiscion/cursor-chat-recovery
+
+or with pipx:
+
+    pipx install git+https://github.com/kwiscion/cursor-chat-recovery
+
+Both install the `cursor-chat-recovery` executable (and a short alias, `ccr`).
+After `uv tool install`, ensure `~/.local/bin` is on your PATH (run `uv tool update-shell` once if needed).
+
+To run from a clone without installing: `uv run cursor-chat-recovery`.
+
+## Use
+
+    cursor-chat-recovery                # interactive TUI  (or: ccr)
+    cursor-chat-recovery --readonly     # TUI with mutations disabled
+    cursor-chat-recovery --list         # workspaces table to stdout
+    cursor-chat-recovery --list --json
+    cursor-chat-recovery --export <COMPOSER_ID> --format markdown -o chat.md
+    cursor-chat-recovery --reassign <COMPOSER_IDS,COMMA,SEP> <TARGET_WS_ID> --yes
+    cursor-chat-recovery --merge <SRC_WS_ID> <TARGET_WS_ID> --yes
+
+Close Cursor before any mutation. The tool refuses to write while Cursor is running.
+
+## Keys
+
+### Global
+
+| Key | Action |
+|-----|--------|
+| `?` | Open help screen |
+| `q` | Quit |
+| `esc` | Back / cancel (clears an active filter first) |
+| `ctrl-c` | Force quit |
+
+### Workspaces (project list)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down` | Move selection |
+| `pgup` / `pgdn` | Page up / down |
+| `home` / `end` | Jump to first / last |
+| `enter` | Open workspace's chats |
+| `s` | Cycle sort order (last activity → chat count → name → health) |
+| `/` | Filter by name or path (`enter` keeps filter, `esc` clears) |
+
+### Chats (within a workspace)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down` | Move selection |
+| `pgup` / `pgdn` | Page up / down |
+| `enter` | View messages |
+| `space` | Select / deselect chat for bulk actions |
+| `a` | Select all chats |
+| `A` | Deselect all chats |
+| `m` | Move selected (or highlighted) chats to another workspace (`r` is a legacy alias) |
+| `e` | Export selected (or highlighted) chats to Markdown files |
+
+### Messages (within a chat)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down`, `pgup` / `pgdn`, `home` / `end` | Scroll |
+| `e` | Export this chat |
+
+### Moving chats
+
+Press `m` on the chats screen to open the move-target picker. Workspaces are
+identified by name, path, chat count, and last activity so ambiguous short
+names are distinguishable. Type `/` to filter the list; the current workspace
+is marked and cannot be selected as a target. After you confirm, a timestamped
+backup is written to `~/.cursor-chat-recovery/backups/` before any data is
+touched. Cursor must be closed before the move is attempted; the tool refuses
+to write while Cursor is running.
+
+## Safety
+
+- Per-session full DB backup written next to `state.vscdb` on first mutation.
+- Per-op headers backup under `~/.cursor-chat-recovery/backups/`.
+- Read-only mode auto-engages on schema mismatch or detected Cursor-running.
+- Reassign is reversible: the per-op backup restores the prior `composer.composerHeaders`.
+
+## Schema drift
+
+When Cursor changes its schema, the tool detects the mismatch on startup and shows a copy-pastable prompt you can paste into a coding agent to adapt the tool. The agent prompt names the affected files and what to change.
+
+## Development
+
+    uv sync --dev
+    uv run pytest
+    uv run ruff check
+    uv run mypy src/
+
+## License
+
+[MIT](LICENSE)

cursor_chat_recovery-0.2.0/README.md

@@ -0,0 +1,114 @@
+# cursor-chat-recovery
+
+[![CI](https://github.com/kwiscion/cursor-chat-recovery/actions/workflows/ci.yml/badge.svg)](https://github.com/kwiscion/cursor-chat-recovery/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
+
+Did your Cursor chats disappear after you moved, renamed, or re-opened a project? They're not gone. This is an interactive terminal UI to **recover, browse, move, and export Cursor AI chat history** — across all your projects.
+
+## Why chats "disappear"
+
+Cursor identifies each workspace by a hash of its identifier URI. Reopening a project from a different path, or saving an Untitled multi-folder workspace as a `.code-workspace` file, mints a new workspace identity and detaches all prior chats from the sidebar. The conversations are still in `globalStorage/state.vscdb` keyed by `composerId` — they just need their `workspaceIdentifier` rewritten to point at the new workspace. That's what this tool does, with backups at every step.
+
+It's also useful when nothing is broken: browse every chat you've ever had in any project, move chats between workspaces, and export conversations to Markdown.
+
+## Install
+
+Requires Python 3.10+. With [uv](https://docs.astral.sh/uv/):
+
+    uv tool install git+https://github.com/kwiscion/cursor-chat-recovery
+
+or with pipx:
+
+    pipx install git+https://github.com/kwiscion/cursor-chat-recovery
+
+Both install the `cursor-chat-recovery` executable (and a short alias, `ccr`).
+After `uv tool install`, ensure `~/.local/bin` is on your PATH (run `uv tool update-shell` once if needed).
+
+To run from a clone without installing: `uv run cursor-chat-recovery`.
+
+## Use
+
+    cursor-chat-recovery                # interactive TUI  (or: ccr)
+    cursor-chat-recovery --readonly     # TUI with mutations disabled
+    cursor-chat-recovery --list         # workspaces table to stdout
+    cursor-chat-recovery --list --json
+    cursor-chat-recovery --export <COMPOSER_ID> --format markdown -o chat.md
+    cursor-chat-recovery --reassign <COMPOSER_IDS,COMMA,SEP> <TARGET_WS_ID> --yes
+    cursor-chat-recovery --merge <SRC_WS_ID> <TARGET_WS_ID> --yes
+
+Close Cursor before any mutation. The tool refuses to write while Cursor is running.
+
+## Keys
+
+### Global
+
+| Key | Action |
+|-----|--------|
+| `?` | Open help screen |
+| `q` | Quit |
+| `esc` | Back / cancel (clears an active filter first) |
+| `ctrl-c` | Force quit |
+
+### Workspaces (project list)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down` | Move selection |
+| `pgup` / `pgdn` | Page up / down |
+| `home` / `end` | Jump to first / last |
+| `enter` | Open workspace's chats |
+| `s` | Cycle sort order (last activity → chat count → name → health) |
+| `/` | Filter by name or path (`enter` keeps filter, `esc` clears) |
+
+### Chats (within a workspace)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down` | Move selection |
+| `pgup` / `pgdn` | Page up / down |
+| `enter` | View messages |
+| `space` | Select / deselect chat for bulk actions |
+| `a` | Select all chats |
+| `A` | Deselect all chats |
+| `m` | Move selected (or highlighted) chats to another workspace (`r` is a legacy alias) |
+| `e` | Export selected (or highlighted) chats to Markdown files |
+
+### Messages (within a chat)
+
+| Key | Action |
+|-----|--------|
+| `up` / `down`, `pgup` / `pgdn`, `home` / `end` | Scroll |
+| `e` | Export this chat |
+
+### Moving chats
+
+Press `m` on the chats screen to open the move-target picker. Workspaces are
+identified by name, path, chat count, and last activity so ambiguous short
+names are distinguishable. Type `/` to filter the list; the current workspace
+is marked and cannot be selected as a target. After you confirm, a timestamped
+backup is written to `~/.cursor-chat-recovery/backups/` before any data is
+touched. Cursor must be closed before the move is attempted; the tool refuses
+to write while Cursor is running.
+
+## Safety
+
+- Per-session full DB backup written next to `state.vscdb` on first mutation.
+- Per-op headers backup under `~/.cursor-chat-recovery/backups/`.
+- Read-only mode auto-engages on schema mismatch or detected Cursor-running.
+- Reassign is reversible: the per-op backup restores the prior `composer.composerHeaders`.
+
+## Schema drift
+
+When Cursor changes its schema, the tool detects the mismatch on startup and shows a copy-pastable prompt you can paste into a coding agent to adapt the tool. The agent prompt names the affected files and what to change.
+
+## Development
+
+    uv sync --dev
+    uv run pytest
+    uv run ruff check
+    uv run mypy src/
+
+## License
+
+[MIT](LICENSE)