Skip to content

docs: update meridian uninstall to reflect full removal behavior #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: update meridian uninstall to reflect full removal behavior #12

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 20 additions & 2 deletions reference/cli.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -193,9 +193,27 @@ Without Screen Recording permission, screenpipe cannot capture frames and Meridi
meridian uninstall
```

Prompts for confirmation, then stops all daemons, runs each service's uninstall script, kills orphaned `mlx_lm.server` processes, and removes the `meridian` and `meridian-daemon` symlinks from `/usr/local/bin/` and `~/.local/bin/`.
Prompts for confirmation, then performs a full uninstall of everything Meridian installed — while preserving your session data and logs so you can reinstall later without losing history.

Your data at `~/.meridian/` is **not** removed. Delete it manually if you want to wipe everything:
**Removed:**

- All launchd agents (`ui`, `mlx-server`, `daemon`, `screenpipe`, `tray`, `a11y-helper`)
- Orphaned `mlx_lm.server` processes
- CLI symlinks in `/usr/local/bin/` and `~/.local/bin/` (`meridian`, `meridian-daemon`)
- The app bundle at `~/.meridian/app/` (binaries, Python venv, UI build)
- Staged binaries under `~/.meridian/bin/` (`meridian`, `meridian-daemon`, `meridian-tray`, `meridian-a11y-helper`, `screenpipe`)
- The global npm package `@meridiona/meridian`
- The `meridian` entry from the `SessionEnd` hooks in `~/.claude/settings.json`

**Preserved:**

- `~/.meridian/*.db` — your session database and any other local databases
- `~/.meridian/logs/` — historical daemon and service logs
- screenpipe itself — remove separately with `brew uninstall screenpipe` if you no longer need it

Because the database is left in place, re-running `meridian setup` after an uninstall picks up your existing sessions and you can continue where you left off.

If you want to wipe everything including your data, remove the data directory manually after uninstalling:

```bash
rm -rf ~/.meridian
Expand Down