Skip to main content

Uninstall shell plugins

1Password Shell Plugins are built so you can stop using them at any time.

Clear your default credentials for a plugin​

If you want to remove your default credentials for a shell plugin:

Credentials will be removed in this order:

  1. Terminal session default
  2. Directory default, from the current directory to $HOME
  3. Global default

To remove all the credentials you've configured for a shell plugin at the same time:

Temporarily stop using a shell plugin​

If you want to stop using a shell plugin for the current terminal session, run:

If you want to temporarily stop using a plugin for a longer period of time, you can remove its alias from your plugins.sh file. Then 1Password CLI will no longer handle authentication when you use the third-party CLI.

  1. Open your plugins.sh file file.
  2. Remove the alias for the plugin you want to stop using. For example, alias aws="op plugin run -- aws".
  3. Save the file.
  4. Open a new terminal window or source your shell profile for the change to go into effect.

You can add the alias back to the file at any time to continue using the shell plugin with your current setup.

Temporarily stop using all shell plugins​

If you want to temporarily stop using shell plugins without losing your configurations, you can remove the command to source the plugins.sh file from your shell profile.

  1. Open your shell profile.

  2. Remove the line that looks like this. Your plugins.sh file path may vary.

  3. Open a new terminal session or source your shell profile for the change to go into effect.

1Password will no longer prompt you to authenticate for any third-party CLI.

Completely stop using shell plugins​

To completely stop using shell plugins and remove all information about your configurations:

  1. Clear the default credentials for each of your plugins.
  2. Remove the command to source the plugins.sh file from your shell profile.
  3. Delete the plugins.sh file and the plugins folder within your op directory.
  4. If you configured any directory-specific defaults, remove the .op folder from those directories.

Get help​

If you can't find your plugins.sh file​

The file path for your plugins.sh file may vary depending on your configuration directory. Common locations include:

  • ~/.op/plugins.sh
  • ~/.config/op/plugins.sh
  • ~/op/plugins.sh

Was this page helpful?