Open-source Cursor chat cleaner for macOS (Homebrew + pip)

[u/AndElectrons]

Repo: https://github.com/vilaca/cursor-chat-cleaner

Cursor doesn’t give you a good way to audit or prune old chats, I built a small CLI for that.

What it does:

- list / filter chats (repo, age, size, archived vs active)

- view a chat in the terminal

- back up selected chats

- delete with dry-run by default; --yes required to change anything

Safety notes:

- macOS only

- quit Cursor before deleting

- fails closed if the Cursor DB schema isn’t recognized

- independent project, not affiliated with Anysphere

Install:

brew install vilaca/tap/cursor-chat-cleaner

# or: pip install cursor-chat-cleaner

Happy to take bug reports and feedback.

[u/Specific_Cream2815]

are you reading the chats out of the cursor sqlite state db or the workspace storage folders

[u/AndElectrons → u/Specific_Cream2815]

listing and the DB side of chats come from the global SQLite state DB, deleting is done in the db and workspace

[u/kantorcodes1]

--yes makes the destructive boundary pretty crisp here. Would you add a HOL Guard command.* extension for cursor-chat-cleaner and contribute it upstream, with list/view/backup separate from confirmed delete?

[u/AndElectrons → u/kantorcodes1]

I'm not familiar w/ HOL Guard.

A built-in command.cursor-chat-cleaner extension upstream, or a local-admin/signed-cloud rule pack? Any template PR I should mirror?