Skip to content
Terminal > Getting started

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

ItemmacOSLinuxWindows
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-insKeychain, 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/melon your PATH only if you added it
Menu entry and iconsnone~/.local/share/applications/mel.desktop and ~/.local/share/icons/hicolor/*/apps/mel.pngStart-Menu entry
Window and app state~/Library/Preferences/app.getmel.Mel.plist and ~/Library/Saved Application State/app.getmel.Mel.savedStatenonenone
VS Code extensionmel.openmelmel.openmelmel.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 and worktrees/ (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 .mel folder or a MEL.md file. Those are yours. Keep them or delete them as you like.

macOS

  1. Quit Mel and drag Mel.app from Applications to the Trash. With Homebrew: brew uninstall --cask mel.
  2. 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.savedState

With Homebrew, brew uninstall --cask --zap mel removes the same items for you.

  1. 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 :; done

You can also open Keychain Access, search for mel-byok, and delete the entries there.

  1. If you installed the mel command, 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/mel

Settings → Features also has an uninstall row for the command.

Linux

  1. 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/null

If you put mel somewhere else on your PATH, remove that copy too: command -v mel shows where it is.

  1. 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
  1. If you set XDG_DATA_HOME, also run rm -rf "$XDG_DATA_HOME/mel".

Windows

  1. Quit Mel. Open Settings → Apps, choose Mel, and select Uninstall. If you used the portable zip, delete the folder you unpacked.
  2. 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.

  1. 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.openmel

Or 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 prune

Check that it is gone

ls -d ~/.mel ~/.local/share/mel 2>/dev/null

Nothing 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.