# Update and uninstall

> A new version, or none. Every page of kelve's docs is listed at https://kelve.ai/llms.txt.

## Update kelve

kelve asks once a day whether a newer version is out. When one is, **Settings**, **Your agent** says so at the top, and so does `kelve status`. Your agent is told too, once for each version, and asks you whether to update. Say yes, and it updates kelve for you. Or run:

```sh
kelve update
```

`kelve update` downloads the newest version for your computer and checks it against the release's checksums. Then it puts it in place of the one you have, whole or not at all. A kelve that's running restarts on the new version once the work it's doing is done. If there's nothing newer, `kelve update` says so.

Before a new version changes kelve's data, kelve copies the data aside, beside it in its data folder. It keeps the last two copies. An older kelve won't open data a newer one has changed. Instead, it tells you to run `kelve update`.

`KELVE_UPDATES=off` stops the daily check. `kelve update` still works when you run it.

### With the installer

Running the installer again works too. It runs `kelve setup` again as well, which finds your agent already connected.

```sh
curl -fsSL https://kelve.ai/install.sh | sh
```

On Windows:

```powershell
irm https://kelve.ai/install.ps1 | iex
```

On macOS and Linux, a kelve that's running keeps the old version until it stops. Run `kelve stop`. kelve starts again, on the new version, the next time you or your agent open something. On Windows, the installer can't replace a kelve that's running, so run `kelve stop` first.

## Uninstall kelve

1. Stop it.

   ```sh
   kelve stop
   ```

2. Take kelve's hook out of your agent's settings, naming your agent: `claude`, `codex`, `cursor`, `copilot`, `gemini`, `antigravity`, `kiro`, `droid`, `qwen`, `qoder` or `augment`. **Settings**, **Your agent** says which agents have it.

   ```sh
   kelve hook remove claude
   ```

3. Disconnect your agent:
   - For Claude Code, run `claude mcp remove kelve`.
   - For Codex, run `codex mcp remove kelve`.
   - For Gemini CLI, run `gemini mcp remove --scope user kelve`.
   - For Cursor, take `kelve` out of `~/.cursor/mcp.json`, or your project's `.cursor/mcp.json`.
4. Optional: if you signed in, use **Delete my account** in **Settings**, **The shared graph**.
5. Delete the command. It's `~/.local/bin/kelve` on macOS and Linux, and `%LOCALAPPDATA%\kelve\bin\kelve.exe` on Windows, or wherever `KELVE_INSTALL_DIR` put it. On Windows, the installer added that folder to your PATH, so take it out of your user PATH too.
6. Move your own notes out of kelve's data folder, if they're there. Unless you chose a folder for them in **Settings**, **Notes**, they're in its `notes` folder.
7. Delete kelve's data folder. It's `~/.config/kelve` on macOS and Linux, and `%APPDATA%\kelve` on Windows, or the one `KELVE_DATA` names. It holds kelve's stores, one for each graph it used. It also holds the copies kept from updates, its secret and key, and its log. [Files kelve keeps](/docs/files/) has the whole list.

Each project's `.kelve/` folder, with its notes and what's read, is your own, and stays. Keep it, or delete it too.
