https://github.com/sshehrozali/llmsave
Back up LLM memory/context on your disk instantly
https://github.com/sshehrozali/llmsave
ai-agents claude claude-code cli cursor cursor-ai cursor-ide cursor-rules llm mcp
Last synced: 8 days ago
JSON representation
Back up LLM memory/context on your disk instantly
- Host: GitHub
- URL: https://github.com/sshehrozali/llmsave
- Owner: sshehrozali
- Created: 2026-04-04T19:20:26.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-09T10:25:51.000Z (about 2 months ago)
- Last Synced: 2026-05-09T11:35:28.036Z (about 2 months ago)
- Topics: ai-agents, claude, claude-code, cli, cursor, cursor-ai, cursor-ide, cursor-rules, llm, mcp
- Language: Go
- Homepage:
- Size: 40 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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`):
```bash
curl -fsSL https://raw.githubusercontent.com/sshehrozali/llmsave/main/install.sh | sh
```
**Windows (PowerShell)** — installs to `%USERPROFILE%\bin` and updates your user `PATH`:
```powershell
irm https://raw.githubusercontent.com/sshehrozali/llmsave/main/install.ps1 | iex
```
Reload your shell config (same window) **or** open a new terminal, then check:
```bash
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](https://github.com/sshehrozali/llmsave/releases) · `go install github.com/sshehrozali/llmsave/cmd/llmsave@latest`
## Usage
Backups run only when you pass the **`backup`** subcommand:
```bash
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
```bash
# Default output directory under your current directory
cd ~
llmsave backup
```
```bash
# Save archives somewhere fixed (folder is created if needed)
llmsave backup -out ~/Documents/llm-backups
```
```bash
# 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.