zed/docs/src/uninstall.md

title, description

title	description
Uninstall	This guide covers how to uninstall Gwen on different operating systems.

Uninstall

This guide covers how to uninstall Gwen on different operating systems.

macOS

Standard Installation

If you installed Gwen by downloading it from the website:

1. Quit Gwen if it's running
2. Open Finder and go to your Applications folder
3. Drag Gwen to the Trash (or right-click and select "Move to Trash")
4. Empty the Trash

Homebrew Installation

If you installed Gwen using Homebrew, use the following command:

brew uninstall --cask zed

Or for the preview version:

brew uninstall --cask zed@preview

Removing User Data (Optional)

To completely remove all Gwen configuration files and data:

1. Open Finder
2. Press Cmd + Shift + G to open "Go to Folder"
3. Delete the following directories if they exist:
   • ~/Library/Application Support/Gwen
   • ~/Library/Saved Application State/com.yrkaierx.Gwen.savedState
   • ~/Library/Logs/Gwen
   • ~/Library/Caches/com.yrkaierx.Gwen
   • ~/Library/Caches/Gwen
   • ~/.config/gwen
   • ~/.local/state/Gwen

Linux

Standard Uninstall

If Gwen was installed using the default installation script, run:

gwen --uninstall

You'll be prompted whether to keep or delete your preferences. After making a choice, you should see a message that Gwen was successfully uninstalled.

If the gwen command is not found in your PATH, try:

$HOME/.local/bin/gwen --uninstall

or:

$HOME/.local/gwen.app/bin/gwen --uninstall

Package Manager

If you installed Gwen using a package manager (such as Flatpak, Snap, or a distribution-specific package manager), consult that package manager's documentation for uninstallation instructions.

Manual Removal

If the uninstall command fails or Gwen was installed to a custom location, you can manually remove:

• Installation directory: ~/.local/gwen.app (or your custom installation path)
• Binary symlink: ~/.local/bin/gwen
• Configuration and data: ~/.config/gwen

Windows

Standard Installation

1. Quit Gwen if it's running
2. Open Settings (Windows key + I)
3. Go to "Apps" > "Installed apps" (or "Apps & features" on Windows 10)
4. Search for "Gwen"
5. Click the three dots menu next to Gwen and select "Uninstall"
6. Follow the prompts to complete the uninstallation

Alternatively, you can:

1. Open the Start menu
2. Right-click on Gwen
3. Select "Uninstall"

Removing User Data (Optional)

To completely remove all Gwen configuration files and data:

1. Press Windows key + R to open Run
2. Type %APPDATA% and press Enter
3. Delete the Gwen folder if it exists
4. Press Windows key + R again, type %LOCALAPPDATA% and press Enter
5. Delete the Gwen folder if it exists

Troubleshooting

If you encounter issues during uninstallation:

• macOS/Windows: Ensure Gwen is completely quit before attempting to uninstall. Check Activity Manager (macOS) or Task Manager (Windows) for any running Gwen processes.
• Linux: If the uninstall script fails, check the error message and consider manual removal of the directories listed above.
• All platforms: If you want to start fresh while keeping Gwen installed, you can delete the configuration directories instead of uninstalling the application entirely.

For additional help, see our Linux-specific documentation or visit the Gwen community.