environment
August 10, 2026 ยท View on GitHub
Define common environment variables.
Options
This plugin sets the following Zsh options:
| action | option | description |
|---|---|---|
| setopt | EXTENDED_GLOB | Use more awesome globbing features. |
| unsetopt | RM_STAR_SILENT | Ask for confirmation for rm * or rm path/*. |
| setopt | COMBINING_CHARS | Combine zero-length chars with the base character (eg: accents). |
| setopt | INTERACTIVE_COMMENTS | Enable comments in interactive shell. |
| setopt | RC_QUOTES | Allow 'it''s' instead of 'it'\''s' for single-quoted strings. |
| unsetopt | MAIL_WARNING | Don't print a warning when a mail file is accessed. |
| unsetopt | BEEP | Don't beep on error in the line editor. |
| setopt | AUTO_RESUME | Attempt to resume existing job before creating a new process. |
| setopt | LONG_LIST_JOBS | List jobs in the long format by default. |
| setopt | NOTIFY | Report status of background jobs immediately. |
| unsetopt | BG_NICE | Don't run background jobs at a lower priority. |
| unsetopt | CHECK_JOBS | Don't report on jobs when shell exits. |
| unsetopt | HUP | Don't kill jobs on shell exit. |
Functions
This plugin adds the following functions:
| function | description |
|---|---|
repath | Put $prepath back at the front of $path after something prepends to it. |
Aliases
This plugin sets no aliases.
Variables
This plugin sets the following variables:
| variable | description |
|---|---|
EDITOR | Default editor (fallback: nano) |
VISUAL | Default visual editor (fallback: nano) |
PAGER | Default pager (fallback: less) |
BROWSER | Default browser (macOS only, fallback: open) |
LANG | Default locale (fallback: en_US.UTF-8) |
LESS | Default Less options |
LESSOPEN | Less input preprocessor command |
KEYTIMEOUT | Key sequence timeout in hundredths of a second |
SHELL_SESSIONS_DISABLE | Disable Apple Terminal session restore (macOS only) |
XDG_CONFIG_HOME | XDG config directory (when use-xdg-basedirs enabled) |
XDG_CACHE_HOME | XDG cache directory (when use-xdg-basedirs enabled) |
XDG_DATA_HOME | XDG data directory (when use-xdg-basedirs enabled) |
XDG_STATE_HOME | XDG state directory (when use-xdg-basedirs enabled) |
Customizations
To set XDG base directories:
zstyle ':zephyr:plugin:environment' 'use-xdg-basedirs' 'yes'
To set a custom list of directories prepended to $PATH:
zstyle ':zephyr:plugin:environment' 'prepath' \
$HOME/bin \
$HOME/.local/bin
A leading ~ is expanded, so '~/bin' works as well as $HOME/bin.