Metadata-Version: 2.4
Name: cursor-clean
Version: 0.1.8
Summary: Clean Cursor Roaming data: old chats, orphan session KV, backup, unused agents.
Author: TIZZYONE
License: MIT
Project-URL: Homepage, https://github.com/TIZZYONE/cursor-clean
Project-URL: Repository, https://github.com/TIZZYONE/cursor-clean
Project-URL: Issues, https://github.com/TIZZYONE/cursor-clean/issues
Keywords: cursor,cleanup,disk,sqlite,windows
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# cursor-clean

[![PyPI](https://img.shields.io/pypi/v/cursor-clean.svg)](https://pypi.org/project/cursor-clean/)

Clean Cursor Roaming data on Windows: old chats, orphan session KV, `state.vscdb.backup`, unused agent versions.

```bash
pip install -U cursor-clean

cursor-clean scan --lang zh
cursor-clean clean --lang zh -y
# keep backup:  cursor-clean clean --keep-backup -y
```

**Defaults:** delete `state.vscdb.backup`, delete orphan session KV (`bubbleId` / `composerData` / … whose `composerId` is not in `composerHeaders`), age-based chats (`--keep-days`, default 45), then VACUUM if Cursor is quit and free disk ≥ ~1× DB size.

**agentKv:** do not wipe blindly. In Cursor run `Developer: GC Agent KV Blobs` (Ctrl+Shift+P). Compaction needs about **1× `state.vscdb` free disk** ([forum](https://forum.cursor.com/t/state-vscdb-grows-to-30gb-due-to-bubbleid-agentkv-entries/167641), [temp space](https://forum.cursor.com/t/gc-agent-kv-blobs-temporarily-consumed-62-gb-of-free-space-while-compacting-a-29-gb-state-vscdb/172165)). `scan` / `clean` print free vs need.

**Quit Cursor before VACUUM.** Safe to re-run. MIT License.
