chatsafe

Back up Cursor to a dated archive on disk—one command, one .tar.gz in a folder you choose.

Portable: install once with the command below; `chatsafe` lands on your `PATH` so you can run it from any directory.

Before you run: quit Cursor so files aren’t locked.

macOS / Linux — installs to ~/.local/bin and adds it to your shell config (~/.zshrc, ~/.bashrc, or ~/.profile):

curl -fsSL https://raw.githubusercontent.com/sshehrozali/chatsafe/main/install.sh | sh

Windows (PowerShell) — installs to %USERPROFILE%\bin and updates your user PATH:

irm https://raw.githubusercontent.com/sshehrozali/chatsafe/main/install.ps1 | iex

Reload your shell config (same window) or open a new terminal, then check:

source ~/.zshrc   # zsh — use ~/.bashrc if you use bash
chatsafe -version

Until you do that, chatsafe is not on PATH in this session. You can always run ~/.local/bin/chatsafe -version right away.

Windows: open a new PowerShell, then chatsafe.exe -version.

Optional custom folder (macOS/Linux): curl -fsSL https://raw.githubusercontent.com/sshehrozali/chatsafe/main/install.sh | env BIN_DIR="$HOME/my/bin" sh

Other ways: all releases · go install github.com/sshehrozali/chatsafe/cmd/chatsafe@latest

Backups run only when you pass the `backup` subcommand:

chatsafe backup

Creates backup/cursor-backup_YYYYMMDD_HHMMSS.tar.gz in your current working directory (the backup folder is created if needed).

# Default output directory under your current directory
cd ~
chatsafe backup

# Save archives somewhere fixed (folder is created if needed)
chatsafe backup -out ~/Documents/cursor-backups

# Cursor data lives somewhere non-standard—point at the User folder explicitly
chatsafe backup -cursor-user "/path/to/Cu