Skip to content

zi uncompile

Remove compiled .zwc bytecode files for a plugin or for all managed plugins. Use this when a plugin update leaves stale compiled files that cause unexpected behavior.

Terminal window
zi [options] uncompile {plg-spec}
OptionDescription
-a, --allRemove compiled files for all plugins
-q, --quietSuppress output
-h, --helpPrint usage

Deletes .zwc files from the target plugin directory. After uncompiling, Zsh will parse the raw .zsh source on next load. Zinit will recompile on the next load unless the nocompile ice is set. Useful for troubleshooting when a plugin behaves differently from its source because a stale .zwc is being loaded.

Terminal window
# Uncompile a single plugin
zi uncompile zsh-users/zsh-autosuggestions
# Remove all compiled files
zi uncompile --all
  • cmd-compile
  • cmd-compiled