Configuration management.

Syntax: config {flags}


--load <file path shape>
  load the config from the path give

--set <any shape>
  set a value in the config, eg) --set [key value]

--set_into <member shape>
  sets a variable from values in the pipeline

--get <any shape>
  get a value from the config

--remove <any shape>
  remove a value from the config

  clear the config

  return the path to the config file


Variable Type Description
path table of strings PATH to use to find binaries
env row the environment variables to pass to external commands
ctrlc_exit boolean whether or not to exit Nu after multiple ctrl-c presses
table_mode “light” or other enable lightweight or normal tables
edit_mode “vi” or “emacs” changes line editing to “vi” or “emacs” mode
key_timeout integer (milliseconds) vi: the delay to wait for a longer key sequence after ESC
history_size integer maximum entries that will be stored in history (100,000 default)
completion_mode “circular” or “list” changes completion type to “circular” (default) or “list” mode
complete_from_path boolean whether or not to complete names of binaries on PATH (default true)
rm_always_trash boolean whether or not to always use system trash when no flags are given to rm
pivot_mode “auto” or “always” or “never” “auto” will only pivot single row tables if the output is greater than the terminal width. “always” will always pivot single row tables. “never” will never pivot single row tables.
plugin_dirs table of strings additional directories to search for plugins during startup


> config --set [table_mode "light"]

A more detailed description on how to use this command to configure Nu shell can be found in the configuration chapter of Nu Book.