How to uninstall Monokle on Mac
Save YAML manifests and pending Git changes before quitting Monokle. This guide covers the downloaded Mac app, with Homebrew handled separately below.
Quit and remove the app
Keep Kubernetes clusters, manifests and kubeconfig. Removing the editor does not remove cluster resources.
Quit Monokle using its own quit action. In System Settings › General › Login Items & Extensions, turn off any Monokle login entry if present. After backing up, move /Applications/Monokle.app to Trash in Finder and leave Trash intact until the wanted data is confirmed saved.
Review local data
Use Shift + Command + G in Finder to inspect each complete path. Copy wanted contents elsewhere before deciding to move that item to Trash. These locations come from the recorded test and the live Homebrew cask. Do not create a missing path. A * marks a matching range, not a literal filename; inspect the actual matches individually.
| Location | Contents and decision |
|---|---|
~/Library/Preferences/io.kubeshop.monokle.plist |
Preferences; keep if you want to restore settings |
~/Library/Logs/monokle |
Cache, logs or web state; optionally remove after quitting |
~/Library/Application Support/monokle |
Local data or settings; back up before deciding to remove |
~/Library/Saved Application State/io.kubeshop.monokle.savedState |
Window restoration state; remove if no longer wanted |
If you installed it with Homebrew
To uninstall without running zap:
brew uninstall --cask monokle
This removes the cask-managed app, without running its zap data list.
The following direct command applies the cask’s entire zap list independently of Mole’s checkboxes. Use it only after backing up and approving every target.
brew uninstall --cask --zap monokle
The live zap targets are ~/Library/Application Support/monokle, ~/Library/Logs/monokle, ~/Library/Preferences/io.kubeshop.monokle.plist, ~/Library/Saved Application State/io.kubeshop.monokle.savedState.
Zap removes the listed targets, including any settings or user data inside them. Use the command without zap when retaining any target. Live cask.
Check the result
ls -ld '/Applications/Monokle.app'
pgrep -ifl '/Applications/Monokle[.]app/'
A listed app path means that bundle remains. “No such file or directory” means that exact path is absent; “Permission denied” leaves the check unconfirmed. This checks one location, not other copies, background services or user data.
A pgrep result means a running command line matches this app path. No output means no such match, not that independent helpers or other app copies are absent; an error leaves this step unconfirmed.
What Mole lists
~/Library/Preferences/io.kubeshop.monokle.plistis selected by default.~/Library/Application Support/monokleis listed for review and not selected by default.
Its ~/Library/Application Support/monokle/Cache, ~/Library/Application Support/monokle/Code Cache, ~/Library/Application Support/monokle/GPUCache cache leaves are listed separately and selected by default; the support folder itself still needs review.
These defaults assume “Remove data and settings with apps” is off, which is the default. Enabling it also selects eligible reviewed app data; shared and protected items retain their individual boundaries. Mole invokes Homebrew zap only when the whole zap scope passes its check. Unchecked, shared or out-of-boundary paths and unsupported directives suppress zap; selected remnants still use Mole’s own deletion flow.
What this test covered
Removal used a source-built Mole app. The recorded first-launch scan was partial and does not establish every file the app can create.
Only the welcome screen was reached, without opening a project or cluster. The official app and reviewed local paths were removed; deployments and cluster connections were not tested.
