Skip to main content

Uninstall Packages

aqua >= v2.11.0 #538 #2248 #2249

caution

aqua rm command doesn't remove packages from aqua.yaml.

$ aqua rm --all [-a] # Uninstall all packages
$ aqua rm [<registry name>,]<package name> [...] # Uninstall packages
$ aqua rm <command name> [...] # Uninstall packages having given commands
$ aqua rm -i # Select packages interactively with a fuzzy finder

e.g.

$ aqua rm cli/cli direnv/direnv

-mode option

aqua >= v2.32.0 #3075

By default, aqua remove command removes only packages from the pkgs directory and doesn't remove links from the bin directory. You can change this behaviour by specifying the -mode flag. The value of -mode is a string containing characters l and p. The order of the characters doesn't matter.

aqua rm -m l cli/cli # Remove only links
aqua rm -m pl cli/cli # Remove links and packages

You can also configure the mode by the environment variable AQUA_REMOVE_MODE, so you can change the default behaviour of aqua remove command by setting AQUA_REMOVE_MODE in your shell setting such as .bashrc.

export AQUA_REMOVE_MODE=pl

Limitation

info

As of aqua v2.33.0, you can uninstall go_install and http packages too.

  1. The fuzzy finder shows all packages, which include not installed packages.