llmsave 💾

Back up your LLM memory—chats, workspace storage, and IDE state—into a single dated .tar.gz. One command, predictable archives, full control over where they land.

Use it to protect context before an OS reinstall, snapshot a project era, move machines, or keep an offline copy of what your assistant “remembers” on disk.

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

Supported IDEs

• Cursor — supported
• Claude — coming soon

Before you run: quit your IDE so databases and files are not locked mid-backup.

Install (one command)

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

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

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

irm https://raw.githubusercontent.com/sshehrozali/llmsave/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
llmsave -version

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

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

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

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

Usage

Backups run only when you pass the backup subcommand:

llmsave backup

Writes backup/llmsave-backup_YYYYMMDD_HHMMSS.tar.gz under your current working directory (the backup folder is created if needed). That archive holds the LLM IDE user data tree llmsave packages from your machine.

Examples

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

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

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

Command / flag	What it does
llmsave backup	Create a timestamped archive of LLM IDE user data
-out dir	Where to save archives (default: backup, relative to cwd)
-cursor-user path	Override the Cursor User directory if yours is not in the usual OS location
llmsave -version	Print version (no backup needed)

Running llmsave with no arguments prints a short usage message and exits.