1 AX-ZSH: Alex' Modular ZSH Configuration
2 =======================================
4 AX-ZSH is a modular configuration system for the Z shell. If provides sane
5 defaults and is extendable by plugins.
11 AX-ZSH can be configured using settings in a `$HOME/.zshenv` file.
13 The following configuration variables are supported:
15 * `AXZSH_PLUGIN_D`: Optional directory for additional plugins.
16 * `axzsh_default_plugins`: Array of default plugins, that will be loaded in
17 addition to the core plugins. You can reset this array to disable(!) loading
18 of these default plugins. Currently these plugins are loaded by default:
27 * `axzsh_plugins`: Optional array of addiutional (non-core and non-default)
30 Example for a `$HOME/.zshenv` file:
33 # Add additinal custom plugin search path
34 export AXZSH_PLUGIN_D="/opt/ax-zsh-plugins"
36 # Disable all default plugins
37 axzsh_default_plugins=()
39 # Add additional plugins
46 Note: it should *not* be necessary to disable the default plugins! The above
53 Expected to be already set:
58 Validated and/or set up by core plugins:
62 * `HOSTNAME` (same as HOST, deprecated)