Uninstall Mel
Remove Mel completely: the app, settings, data, saved keys and the VS Code extension, per system.
How do I uninstall Mel completely? Remove the app, then remove the folders and saved keys Mel keeps outside it. Deleting the app alone leaves your settings, conversations and sign-in on disk. This page lists every item, per system, with commands you can copy.
Before you start, sign out in the avatar menu. Signing out removes the provider keys and connector sign-ins Mel saved in your system keychain. If you skip it, the keychain steps below do the same job by hand.
Quit Mel first. Nothing below deletes your projects. Only the items listed here are touched.
What Mel keeps
| Item | macOS | Linux | Windows |
|---|---|---|---|
| The app | /Applications/Mel.app (or ~/Applications) | ~/.local/bin/mel | %LocalAppData%\Programs\Mel |
| Settings and config | ~/.mel | ~/.mel | %APPDATA%\mel\config |
| Data: sign-in, conversations, Drive, crash files | ~/.local/share/mel | ~/.local/share/mel | %APPDATA%\mel |
| Saved keys and sign-ins | Keychain, service mel-byok | ~/.mel/keys.json (in the config folder) | Credential Manager, entries named mel-byok |
The mel command | /usr/local/bin/mel (only if you chose "Install the mel command") | ~/.local/bin/mel | on your PATH only if you added it |
| Menu entry and icons | none | ~/.local/share/applications/mel.desktop and ~/.local/share/icons/hicolor/*/apps/mel.png | Start-Menu entry |
| Window and app state | ~/Library/Preferences/app.getmel.Mel.plist and ~/Library/Saved Application State/app.getmel.Mel.savedState | none | none |
| VS Code extension | mel.openmel | mel.openmel | mel.openmel |
If you set XDG_DATA_HOME, the data folder is $XDG_DATA_HOME/mel instead. If you set MEL_DEBUG_LOG, the log is wherever you pointed it.
What is inside:
- The config folder holds
settings.json,keys.json(Linux only),repos.json, tab configs, saved library items, pinned notes andworktrees/(the git worktrees Mel created for you). - The data folder holds your sign-in (
auth_token),conversations/,drive/(your workflows, prompts and notebooks),crash/and the other caches. - Projects you worked on may contain a
.melfolder or aMEL.mdfile. Those are yours. Keep them or delete them as you like.
macOS
- Quit Mel and drag Mel.app from Applications to the Trash. With Homebrew:
brew uninstall --cask mel. - Remove the settings, data and app state:
rm -rf ~/.mel ~/.local/share/mel
rm -f ~/Library/Preferences/app.getmel.Mel.plist
rm -rf ~/Library/Saved\ Application\ State/app.getmel.Mel.savedStateWith Homebrew, brew uninstall --cask --zap mel removes the same items for you.
- Remove the keychain items (provider keys and connector sign-ins). This deletes every item with the service name
mel-byok, one at a time, until none are left:
while security delete-generic-password -s mel-byok >/dev/null 2>&1; do :; doneYou can also open Keychain Access, search for mel-byok, and delete the entries there.
- If you installed the
melcommand, remove the link. It is only a link to the app, so this is safe:
[ -L /usr/local/bin/mel ] && sudo rm /usr/local/bin/melSettings → Features also has an uninstall row for the command.
Linux
- Remove the binary, the menu entry and the icons:
rm -f ~/.local/bin/mel ~/.local/share/applications/mel.desktop
rm -f ~/.local/share/icons/hicolor/*/apps/mel.png
update-desktop-database ~/.local/share/applications 2>/dev/nullIf you put mel somewhere else on your PATH, remove that copy too: command -v mel shows where it is.
- Remove the config and data folders. Your saved provider keys are in
~/.mel/keys.json, so this removes them too:
rm -rf ~/.mel ~/.local/share/mel- If you set
XDG_DATA_HOME, also runrm -rf "$XDG_DATA_HOME/mel".
Windows
- Quit Mel. Open Settings → Apps, choose Mel, and select Uninstall. If you used the portable zip, delete the folder you unpacked.
- Remove the settings and data (PowerShell):
Remove-Item -Recurse -Force "$env:APPDATA\mel"That one folder holds both the config (mel\config) and the data.
- Remove the saved keys. Open Credential Manager → Windows Credentials, find the entries whose name contains
mel-byok, and remove each one. Signing out of Mel before you uninstall removes them for you.
The VS Code extension
If you installed the Mel extension, remove it on any system:
code --uninstall-extension mel.openmelOr open the Extensions view in VS Code, find Mel, and choose Uninstall. The extension keeps no data of its own. It runs the installed app, so it stops working once the app is gone.
Git worktrees
If you used Mel's worktree feature, git still lists those worktrees after ~/.mel/worktrees is deleted. Clean the list from each repository:
git worktree pruneCheck that it is gone
ls -d ~/.mel ~/.local/share/mel 2>/dev/nullNothing printed means the folders are gone. Your Mel account is a separate thing from the app. To delete the account and the data Mel holds for it, sign in on the account page and use Delete account.
Related
- Installation — install again later.
- Customizing Mel — where your persistent data lives.
- Updating Mel — updates and channels.