Skip to content

Support > Troubleshooting and support

Logging out & uninstalling

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

Log out of Warp, uninstall the Warp app, or remove the Warp Agent CLI and its local files.

You can log out of Warp through:

  • Settings > Account, with the “Log out” button
  • Command Palette, with the “Log out” item.
  1. When you log out, you will lose all running processes and all unsaved objects.
  2. When you log out and log in to Warp with another account, the following preferences will be preserved from the original account:
    1. Theme
    2. Keybindings
    3. Settings (e.g. autosuggestion, notifications, font size, welcome tips status)
  3. Whenever you log in to Warp, you will receive the onboarding survey.

Removing Warp from your computer involves uninstalling Warp and then removing any files or data.

Uninstalling Warp by dmg

  • Remove Warp with sudo rm -r /Applications/Warp.app
  • Open Finder > Applications, right-click on Warp, and select “Move to Trash”

Uninstalling Warp by Homebrew

  • Remove Warp with brew uninstall warp

Removing Warp settings, files, logs, and database

Terminal window
# Remove Warp settings defaults
defaults delete dev.warp.Warp-Stable
# Remove Warp logs
sudo rm -r $HOME/Library/Logs/warp.log
# Remove Warp database, Codebase Context, and MCP logs
sudo rm -r "$HOME/Library/Group Containers/2BBY89MBSN.dev.warp/Library/Application Support/dev.warp.Warp-Stable"
# Remove Warp user files, themes, and launch configurations
sudo rm -r $HOME/.warp
# Note: Removing $HOME/.warp will delete files for both Stable and Preview.
# If you wish to delete it all, then: sudo rm -r $HOME/.warp

For Warp Preview users:

Terminal window
# Remove Warp Preview settings defaults
defaults delete dev.warp.Warp-Preview
# Remove Warp Preview logs
sudo rm -r $HOME/Library/Logs/warp_preview.log
# Remove Warp Preview database, Codebase Context, and MCP logs
sudo rm -r "$HOME/Library/Group Containers/2BBY89MBSN.dev.warp/Library/Application Support/dev.warp.Warp-Preview"
# Note: Removing $HOME/.warp will delete files for both Preview and Stable.
# If you wish to delete it all, then: sudo rm -r $HOME/.warp

The Warp Agent CLI is a separate install from the Warp desktop app. Removing the app does not remove the CLI, and removing the CLI does not uninstall the app.

Install-script installs (macOS, Linux, and Windows)

Section titled “Install-script installs (macOS, Linux, and Windows)”

The install script places a versioned install under a data directory and puts a warp entry on your PATH.

Default locations:

  • macOS and Linux - Install root ~/.warp/tui/ (versioned binaries under versions/, active build at current), symlink at ~/.local/bin/warp
  • Windows - Install root %LOCALAPPDATA%\Warp\tui\, CLI entry under %LOCALAPPDATA%\Warp\bin\

If you overrode the defaults with WARP_TUI_INSTALL_DIR or WARP_TUI_BIN_DIR when you installed, remove those paths instead.

Terminal window
# Remove the PATH entry for the CLI
rm -f "${WARP_TUI_BIN_DIR:-$HOME/.local/bin}/warp"
# Remove the versioned install (binaries, auto-updater state)
rm -rf "${WARP_TUI_INSTALL_DIR:-$HOME/.warp/tui}"
Terminal window
brew uninstall --cask warp-agent-cli

These directories are shared with other Warp agent surfaces. Remove them only if you no longer need the data:

  • Agent config - ~/.agents/ (on Windows, %USERPROFILE%\.agents\)
  • MCP config and bundled skills - ~/.warp/.mcp.json and ~/.warp/skills/ (on Windows, under %USERPROFILE%\.warp\)

To confirm the CLI is gone, open a new terminal and run warp --version. The shell should report that the command was not found.

For install steps, see the Warp Agent CLI quickstart.