Appearance
Configuration variables
TIP
Scroll the table horizontally
| Variable | Added In | Type | Use | Default | Limitations |
|---|---|---|---|---|---|
ABBR_AUTOLOAD | 3.3.2 | integer | If non-zero, automatically account for updates to the user abbreviations file (read Storage and manual editing) | 1 | |
ABBR_DEBUG | 3.2.0 | integer | If non-zero, print debugging messages | 0 | |
ABBR_DEFAULT_BINDINGS | 2.0.0 | integer | If non-zero, add the default bindings (read Widgets and key bindings) | 1 | |
ABBR_DRY_RUN | 3.2.0 | integer | If non-zero, use dry run mode without passing --dry-run | 0 | |
ABBR_EXPAND_AND_ACCEPT_PUSH_ABBREVIATED_LINE_TO_HISTORY | 6.0.0 | integer | If non-zero, when abbr-expand-and-accept expands an abbreviation it adds one or two entries to the shell history, before the accepted line's history entry. If ABBR_EXPAND_PUSH_ABBREVIATION_TO_HISTORY is zero, one history entry is added: the line before it expanded. If ABBR_EXPAND_PUSH_ABBREVIATION_TO_HISTORY is non-zero the abbreviation is added to the shell history and, if there was more on the unexpanded line that just the abbreviation, the unexpanded line is added as a separate history entry. | 0 | Unaware of setopt hist_ignore_space and unsetopt hist_ignore_space run interactively after session initialization. |
ABBR_EXPAND_PUSH_ABBREVIATION_TO_HISTORY | 6.0.0 | integer | If non-zero, when abbr-expand expands an abbreviation it also adds the abbreviation to the shell history | 0 | |
ABBR_EXPANSION_CURSOR_MARKER | 5.4.0 | string | Read ABBR_SET_EXPANSION_CURSOR in this table | $ABBR_LINE_CURSOR_MARKER | Cannot contain ^. Read issue #140. |
ABBR_FORCE | 5.1.0 | integer | If non-zero, use force mode without passing --force (read Usage > Commands > add) | 0 | |
ABBR_GET_AVAILABLE_ABBREVIATION | 6.0.0 | integer | If non-zero, check whether you could have used an abbreviation | 0 | |
ABBR_LINE_CURSOR_MARKER | 5.4.0 | string | Read ABBR_SET_LINE_CURSOR in this table | % | |
ABBR_LOG_AVAILABLE_ABBREVIATION | 6.0.0 | integer | If non-zero, log the abbreviation you could have used (you'll want to toggle ABBR_GET_AVAILABLE_ABBREVIATION on, too) | 0 | |
ABBR_LOG_AVAILABLE_ABBREVIATION_AFTER | 6.0.0 | integer | If non-zero, ABBR_LOG_AVAILABLE_ABBREVIATION output is logged after the command output | 0 | |
ABBR_QUIET | 4.0.0 | integer | If non-zero, use quiet mode without passing --quiet | 0 | |
ABBR_QUIETER | 4.4.0 | integer | If non-zero, use quieter mode without passing --quieter | 0 | |
ABBR_REGULAR_ABBREVIATION_GLOB_PREFIXES | 6.0.0 | array | Glob prefixes. One or more prefixes can go in front of a regular abbreviation, and it will still expand. | ( ' ' ) | |
ABBR_REGULAR_ABBREVIATION_SCALAR_PREFIXES | 6.0.0 | array | Scalar prefixes. One or more prefixes can go in front of a regular abbreviation, and it will still expand. | ( 'sudo ' ) | |
ABBR_SET_EXPANSION_CURSOR | 5.4.0 | integer | If non-zero and the expansion includes ABBR_EXPANSION_CURSOR_MARKER, abbr-expand will replace the expansion's first instance of ABBR_EXPANSION_CURSOR_MARKER with the cursor, and abbr-expand-and-insert's bound key will not be inserted at the end of the expansion (read also Widgets and key bindings) | 0 | |
ABBR_SET_LINE_CURSOR | 5.4.0 | integer | If non-zero and abbr-expand didn't place the cursor (because the ABBR_SET_EXPANSION_CURSOR is zero or the expansion did not include ABBR_EXPANSION_CURSOR_MARKER), abbr-expand-and-insert will replace the line's first instance of ABBR_LINE_CURSOR_MARKER with the cursor instead of inserting its bound key at the end of the expansion (read also Widgets and key bindings) | 0 | |
ABBR_TMPDIR | 4.0.0 | String | Path to the directory temporary files are stored in. | ${${TMPDIR:-/tmp}%/}/zsh-abbr/ for users without privileges,${${TMPDIR:-/tmp}%/}/zsh-abbr/ for users with privileges (e.g. su)If changing this, you may want to delete the default directory. As of v5.7.0, custom values for this variable do not have to end in /. | |
ABBR_USER_ABBREVIATIONS_FILE | 4.0.0 | String | Path to the file user abbreviation are stored in (read Storage and manual editing) | ${XDG_CONFIG_HOME:-$HOME/.config}/zsh-abbr/user-abbreviations with legacy support for using ${XDG_CONFIG_HOME:-$HOME/.config}/zsh/abbreviations instead if a file exists at that path If changing this, you may want to delete the default file. | |
NO_COLOR | 3.3.3 | mixed | If set (to any value or no value at all) abbr will not use color in its output. Learn more at https://no-color.org/. |