Last active
November 23, 2025 00:46
-
-
Save paul-d-ray/4c79f2023ed91a7ab1de22c1686ebe9e to your computer and use it in GitHub Desktop.
Nushell Config.nu
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # config.nu | |
| # | |
| # Installed by: | |
| # version = "0.102.0" | |
| # | |
| # This file is used to override default Nushell settings, define | |
| # (or import) custom commands, or run any other startup tasks. | |
| # See https://www.nushell.sh/book/configuration.html | |
| # | |
| # This file is loaded after env.nu and before login.nu | |
| # | |
| # You can open this file in your default editor using: | |
| # config nu | |
| # | |
| # See `help config nu` for more options | |
| # | |
| # You can remove these comments if you want or leave | |
| # them for future reference. | |
| # For more information on defining custom themes, see | |
| # https://www.nushell.sh/book/coloring_and_theming.html | |
| # And here is the theme collection | |
| # https://github.com/nushell/nu_scripts/tree/main/themes | |
| let dark_theme = { | |
| # color for nushell primitives | |
| separator: white | |
| leading_trailing_space_bg: { attr: n } # no fg, no bg, attr none effectively turns this off | |
| header: green_bold | |
| empty: blue | |
| # Closures can be used to choose colors for specific values. | |
| # The value (in this case, a bool) is piped into the closure. | |
| # eg) {|| if $in { 'light_cyan' } else { 'light_gray' } } | |
| bool: light_cyan | |
| int: white | |
| # filesize: cyan | |
| filesize: {|e| | |
| if $e == 0b { | |
| 'cyan' | |
| } else if $e < 10mb { | |
| 'light_green' | |
| } else if $e < 500mb { | |
| 'green' | |
| } else if $e < 1000mb { | |
| 'yellow' | |
| } else { 'light_red' } | |
| } | |
| duration: white | |
| # date: purple | |
| datetime: {|| (date now) - $in | | |
| if $in < 1hr { | |
| 'light_red' | |
| } else if $in < 6hr { | |
| 'light_green' | |
| } else if $in < 1day { | |
| 'light_green' | |
| } else if $in < 3day { | |
| 'light_green' | |
| } else if $in < 1wk { | |
| 'light_green' | |
| } else if $in < 6wk { | |
| 'green' | |
| } else if $in < 52wk { | |
| 'yellow' | |
| } else if $in < 104wk { | |
| 'cyan' | |
| } else { | |
| 'light_cyan_reverse' } | |
| } | |
| range: white | |
| float: white | |
| string: white | |
| nothing: white | |
| binary: white | |
| cell-path: white | |
| row_index: green_bold | |
| record: white | |
| list: white | |
| block: white | |
| hints: dark_gray | |
| search_result: { bg: red fg: white } | |
| shape_and: purple_bold | |
| shape_binary: purple_bold | |
| shape_block: blue_bold | |
| shape_bool: light_cyan | |
| shape_closure: green_bold | |
| shape_custom: green | |
| shape_datetime: cyan_bold | |
| shape_directory: cyan | |
| shape_external: light_red | |
| shape_externalarg: green_bold | |
| shape_external_resolved: light_yellow_bold | |
| shape_filepath: cyan | |
| shape_flag: blue_bold | |
| shape_float: purple_bold | |
| # shapes are used to change the cli syntax highlighting | |
| shape_garbage: { fg: white bg: red attr: b } | |
| shape_glob_interpolation: cyan_bold | |
| shape_globpattern: cyan_bold | |
| shape_int: purple_bold | |
| shape_internalcall: cyan_bold | |
| shape_keyword: cyan_bold | |
| shape_list: cyan_bold | |
| shape_literal: blue | |
| shape_match_pattern: green | |
| shape_matching_brackets: { attr: u } | |
| shape_nothing: light_cyan | |
| shape_operator: yellow | |
| shape_or: purple_bold | |
| shape_pipe: purple_bold | |
| shape_range: yellow_bold | |
| shape_record: cyan_bold | |
| shape_redirection: purple_bold | |
| shape_signature: green_bold | |
| shape_string: green | |
| shape_string_interpolation: cyan_bold | |
| shape_table: blue_bold | |
| shape_variable: purple | |
| shape_vardecl: purple | |
| shape_raw_string: light_purple | |
| } | |
| # The default config record. This is where much of your global configuration is setup. | |
| $env.config = { | |
| show_banner: true # true or false to enable or disable the welcome banner at startup | |
| ls: { | |
| use_ls_colors: true # use the LS_COLORS environment variable to colorize output | |
| clickable_links: true # enable or disable clickable links. Your terminal has to support links. | |
| } | |
| rm: { | |
| always_trash: true # always act as if -t was given. Can be overridden with -p | |
| } | |
| table: { | |
| mode: rounded # basic, compact, compact_double, light, thin, with_love, rounded, reinforced, heavy, none, other | |
| index_mode: always # "always" show indexes, "never" show indexes, "auto" = show indexes when a table has "index" column | |
| show_empty: false # show 'empty list' and 'empty record' placeholders for command output | |
| padding: { left: 1, right: 1 } # a left right padding of each column in a table | |
| trim: { | |
| methodology: wrapping # wrapping or truncating | |
| wrapping_try_keep_words: true # A strategy used by the 'wrapping' methodology | |
| truncating_suffix: "..." # A suffix used by the 'truncating' methodology | |
| } | |
| header_on_separator: false # show header text on separator/border line | |
| footer_inheritance: true # render footer in parent table if child is big enough (extended table option) | |
| # abbreviated_row_count: 10 # limit data rows from top and bottom after reaching a set point | |
| } | |
| error_style: "fancy" # "fancy" or "plain" for screen reader-friendly error messages | |
| # Whether an error message should be printed if an error of a certain kind is triggered. | |
| display_errors: { | |
| exit_code: false # assume the external command prints an error message | |
| # Core dump errors are always printed, and SIGPIPE never triggers an error. | |
| # The setting below controls message printing for termination by all other signals. | |
| termination_signal: true | |
| } | |
| # datetime_format determines what a datetime rendered in the shell would look like. | |
| # Behavior without this configuration point will be to "humanize" the datetime display, | |
| # showing something like "a day ago." | |
| # PR 20231021 | |
| datetime_format: { | |
| # normal: '%a, %d %b %Y %H:%M:%S %z' # shows up in displays of variables or other datetime's outside of tables | |
| # table: '%m/%d/%y %I:%M:%S%p' # generally shows up in tabular outputs such as ls. commenting this out will change it to the default human readable datetime format | |
| normal: '%a, %Y-%m-%d %H:%M:%S' # shows up in displays of variables or other datetime's outside of tables | |
| table: '%Y-%m-%d %H:%M:%S' # generally shows up in tabular outputs such as ls. commenting this out will change it to the default human readable datetime format | |
| } | |
| explore: { | |
| status_bar_background: { fg: "#1D1F21", bg: "#C4C9C6" }, | |
| command_bar_text: { fg: "#C4C9C6" }, | |
| highlight: { fg: "black", bg: "yellow" }, | |
| status: { | |
| error: { fg: "white", bg: "red" }, | |
| warn: {} | |
| info: {} | |
| }, | |
| selected_cell: { bg: light_blue }, | |
| } | |
| history: { | |
| max_size: 100_000 # Session has to be reloaded for this to take effect | |
| sync_on_enter: true # Enable to share history between multiple sessions, else you have to close the session to write history to file | |
| file_format: "sqlite" # "sqlite" or "plaintext" | |
| isolation: false # only available with sqlite file_format. true enables history isolation, false disables it. true will allow the history to be isolated to the current session using up/down arrows. false will allow the history to be shared across all sessions. | |
| } | |
| completions: { | |
| case_sensitive: false # set to true to enable case-sensitive completions | |
| quick: true # set this to false to prevent auto-selecting completions when only one remains | |
| partial: true # set this to false to prevent partial filling of the prompt | |
| algorithm: "fuzzy" # prefix or fuzzy | |
| sort: "smart" # "smart" (alphabetical for prefix matching, fuzzy score for fuzzy matching) or "alphabetical" | |
| external: { | |
| enable: true # set to false to prevent nushell looking into $env.PATH to find more suggestions, `false` recommended for WSL users as this look up may be very slow | |
| max_results: 100 # setting it lower can improve completion performance at the cost of omitting some options | |
| completer: null # check 'carapace_completer' above as an example | |
| } | |
| use_ls_colors: true # set this to true to enable file/path/directory completions using LS_COLORS | |
| } | |
| cursor_shape: { | |
| emacs: line # block, underscore, line, blink_block, blink_underscore, blink_line, inherit to skip setting cursor shape (line is the default) | |
| vi_insert: block # block, underscore, line, blink_block, blink_underscore, blink_line, inherit to skip setting cursor shape (block is the default) | |
| vi_normal: underscore # block, underscore, line, blink_block, blink_underscore, blink_line, inherit to skip setting cursor shape (underscore is the default) | |
| } | |
| color_config: $dark_theme # if you want a more interesting theme, you can replace the empty record with `$dark_theme`, `$light_theme` or another custom record | |
| footer_mode: 10 # always, never, number_of_rows, auto | |
| float_precision: 2 # the precision for displaying floats in tables | |
| buffer_editor: null # command that will be used to edit the current line buffer with ctrl+o, if unset fallback to $env.EDITOR and $env.VISUAL | |
| use_ansi_coloring: true | |
| bracketed_paste: true # enable bracketed paste, currently useless on windows | |
| # PR 20240926 | |
| edit_mode: vi # emacs, vi | |
| shell_integration: { | |
| # osc2 abbreviates the path if in the home_dir, sets the tab/window title, shows the running command in the tab/window title | |
| osc2: true | |
| # PR 20250608 | |
| # https://github.com/nushell/nushell/pull/15914 | |
| # osc7 is a way to communicate the path to the terminal, this is helpful for spawning new tabs in the same directory | |
| osc7: false | |
| # osc8 is also implemented as the deprecated setting ls.show_clickable_links, it shows clickable links in ls output if your terminal supports it. show_clickable_links is deprecated in favor of osc8 | |
| osc8: true | |
| # PR 20250608 | |
| # https://github.com/nushell/nushell/pull/15914 | |
| # osc9_9 is from ConEmu and is starting to get wider support. It's similar to osc7 in that it communicates the path to the terminal | |
| osc9_9: true | |
| # osc133 is several escapes invented by Final Term which include the supported ones below. | |
| # 133;A - Mark prompt start | |
| # 133;B - Mark prompt end | |
| # 133;C - Mark pre-execution | |
| # 133;D;exit - Mark execution finished with exit code | |
| # This is used to enable terminals to know where the prompt is, the command is, where the command finishes, and where the output of the command is | |
| osc133: true | |
| # osc633 is closely related to osc133 but only exists in visual studio code (vscode) and supports their shell integration features | |
| # 633;A - Mark prompt start | |
| # 633;B - Mark prompt end | |
| # 633;C - Mark pre-execution | |
| # 633;D;exit - Mark execution finished with exit code | |
| # 633;E - Explicitly set the command line with an optional nonce | |
| # 633;P;Cwd=<path> - Mark the current working directory and communicate it to the terminal | |
| # and also helps with the run recent menu in vscode | |
| osc633: true | |
| # reset_application_mode is escape \x1b[?1l and was added to help ssh work better | |
| reset_application_mode: true | |
| } | |
| render_right_prompt_on_last_line: false # true or false to enable or disable right prompt to be rendered on last line of the prompt. | |
| use_kitty_protocol: false # enables keyboard enhancement protocol implemented by kitty console, only if your terminal support this. | |
| highlight_resolved_externals: false # true enables highlighting of external commands in the repl resolved by which. | |
| # PR 20250412_2221 | |
| # recursion_limit: 50 # the maximum number of times nushell allows recursion before stopping it | |
| recursion_limit: 100 # the maximum number of times nushell allows recursion before stopping it | |
| } | |
| # To load from a custom file you can use: | |
| source ($nu.default-config-dir | path join 'custom.nu') | |
Author
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
See this link for the custom.nu script