PSCompletions

简体中文

English

6.2.1

• Add alias support for $PSCompletions.argc_completions()
  • Refer to: Combine with argc-completions.
• Strip possible ANSI escape codes from the completion items.
  • Refer to: #121
  • PSCompletions can work normally with Carapace.
• Optimize command and alias checking.
• Other optimizations and fixes.

6.2.0

• Add enable_list_full_width configuration item, used to control whether the completion menu is displayed in full width.
  • Refer to: #117
  • It is enabled by default.
  • It can reduce the complexity of related calculations from O(n) to O(1), comparable to the response performance of the native completion menu.
  • If you don’t like the full-width display, please run psc menu config enable_list_full_width 0.
• Add height_from_menu_top_to_cursor_when_below configuration item for completion menu.
• Simplify the color theme of the completion menu.
  • Remove some redundant color configuration items.
  • Change the names of some color configuration items, you may need to re-set them if you have customizations.
• Use single_line_round_border as the default line theme for the completion menu.
• Remove newline characters in tip fields of all completion files, added automatically when loading completions.
• Disable completion suffix when there is a space after the cursor.
• Limit the value of completion_suffix to be one or more spaces.
• Fix the issue where special symbols (~?!) provided by the module are missing when enable_tip is 0.
• Fix the issue where the completions of the WriteSpaceTab type are not working.
• Other performance optimizations and fixes.

6.1.0

• Completion library has some breaking changes, please update all completions after updating the module.
  • Update command: psc update * --force
• When filtering, ignore the special symbols (~?!) provided by the module in the completion items.
• Fix the issue where including [ triggers a completion error.
• Fix the completion trigger timing of the root command.
• Many performance optimizations.

6.0.3

• Handle empty tip in menu rendering.

6.0.2

• Reduce unnecessary string matching and parsing.
• Check administrator permission.
  • If -Scope AllUsers is specified when installing the module, the module will be installed in the system-level directory.
  • In this case, the module can only be run with administrator permission.

6.0.1

• Reduce the redraw range of the buffer.

6.0.0 (2025/11/22)

• Refactor the completion menu, which significantly improves the completion response speed.
• Remove the enable_prefix_match_in_filter configuration.
  • Now the filtering uses fuzzy matching, supporting three matchers: ^?*
  • Use ^ instead of the previous prefix matcher.
• Remove some less commonly used configurations.
  • enable_list_cover_buffer
  • enable_tip_cover_buffer
  • enable_selection_with_margin
  • width_from_menu_left_to_item
  • width_from_menu_right_to_item
• Other optimizations and fixes.

5.11.1 (2025/11/19)

• Fix the issue with redrawing the buffer. (#93)
• Fix the issue of menu flashing when filtering in the completion menu.

5.11.0 (2025/11/16)

• Add key bindings for the PSCompletions’ completion menu. (#107)

  • Up: Ctrl + k
  • Down: Ctrl + j

5.10.1 (2025/11/05)

It’s allowed to get completions after any subcommand in the completion menu provided by the module. (#102)

• For example:
  • If you have already entered git clone git@github.com:abgox/PSCompletions.git
  • You want to complete --depth 1 ,
  • Then, you can move the cursor after clone, and get --depth
• Note:
  • It only works in the completion menu provided by the module
  • Its implementation method is to take the content before the cursor as input, so it will not filter duplicate completion items after the cursor

5.9.2 (2025/11/02)

• Fix the completion sorting error caused by default case insensitivity.

5.9.1 (2025/11/01)

• Fix the issue of parameter overlap when names are the same but case differs.

5.9.0 (2025/10/18)

• Wildcards * and ? are allowed in filtering.
  • Command: psc menu config enable_prefix_match_in_filter 0
  • Cost: unable to match original * and ? characters.
• Optimize the logic for handling different completion types.
  • It makes the effective scope of the completion_suffix configuration more precise.

5.8.0 (2025/10/15)

• Add the enable_hooks_tip configuration item. (#96)
  • For global settings: psc menu config enable_hooks_tip 1
  • For specific completion: psc completion git enable_hooks_tip 1
• Add the completions_confirm_limit configuration item. (#83)
  • Command: psc menu config completions_confirm_limit 1000
• Support for -?, -h, --help parameters.

  • Command: psc

    psc -?

    psc -h

    psc --help

  • All four commands output the same result.
• Remove the special handling of tip for built-in commands. (#97)
• Other optimizations and fixes.

5.7.0 (2025/10/11)

• Add the completion_suffix configuration item (#91)
• Command: psc menu config completion_suffix " "

5.6.9 (2025/9/20)

• Disable strict mode in the module. (#88)

5.6.8 (2025/9/16)

• Add the -UseBasicParsing parameter to Invoke-WebRequest

5.6.7 (2025/9/16)

• Remove meaningless error wrappers to make error messages clearer.
• Deny the change of line style of the completion menu in Windows PowerShell 5.1
• Suppress errors caused by completing with only spaces.
• Other fixes and optimizations.

5.6.6 (2025/9/12)

• Optimize the frequency of network requests for update checks.
• Other fixes and optimizations.

5.6.5 (2025/9/11)

• Fix the path completion sorting.
• Other fixes and optimizations.

5.6.4 (2025/8/11)

• Fix the filter bug of the completion menu.
• Other fixes and optimizations.

5.6.3 (2025/7/21)

• Add missing caching logic.

5.6.2 (2025/7/21)

• Change the order of remote url addresses.

5.6.1 (2025/7/21)

• Remove the module update confirmation.
  • Future versions will require manual updates of PSCompletions
  • Remove an unused configuration item module_update_confirm_duration

5.6.0 (2025/7/21)

• Add a configuration item enable_auto_alias_setup.
  • psc config enable_auto_alias_setup
• Change the configuration item disable_cache to enable_cache.
• Change the default special symbol » to ~.
  • The special symbols that are now the default are: ~?!
  • They are all ASCII characters and cannot cause rendering compatibility issues anymore.
• Fix the issue where Esc/Ctrl + C/Backspace would clear the entire path when using path completion.
• Other fixes and optimizations.

5.5.1 (2025/6/1)

• Fix an internal method that may cause errors.
• Display the aliases that can trigger completions when adding completions.
• Lower the restriction on setting aliases. Allow adding aliases like xxx.exe when there is a xxx command.
• Other fixes and optimizations.

5.5.0 (2025/5/1)

• Add a configuration item module_update_confirm_duration
  • psc config module_update_confirm_duration.
  • The duration of the module update confirmation (milliseconds), default value is 15000.
  • When the duration is exceeded, the update confirmation will be automatically cancelled to avoid the process being stuck due to the update confirmation.
• Other fixes and optimizations.

5.4.0 (2025/3/19)

• Add a configuration item enable_path_with_trailing_separator for path completion.
  • psc menu config enable_path_with_trailing_separator
  • It controls whether path completion requires a trailing separator, and defaults to 1.
    • With: C:\Users\abgox\
    • Without: C:\Users\abgox
• Other fixes and optimizations.

5.3.3 (2025/2/28)

• Optimized some key function in the completion menu.
  • Space is equivalent to Enter.
  • Shift + Space is removed.
• Fix a completion error triggered when an empty string appears in a completion item.
• Fix some issues in the module update.
• Other fixes and optimizations.

5.3.2 (2025/1/10)

• Optimize completion filtering.
• Add some properties in $PSCompletions for hooks to use to improve parsing speed.
• Fix an issue where background jobs could cause completion errors.
• Other fixes and optimizations.

5.3.1 (2025/1/5)

• Fix an issue where when option completion had been used, it wasn’t filtered out on the next completion.
• Support options ending with = to directly get next completion items.
  • Requires completion definition.

5.3.0 (2025/1/1)

• Optimize the property structure and parsing of json completion files.
  • This is a minor breaking update for completion files.
  • After updating PSCompletions module, please run the psc update * --force command to update all completions.
• Simplify the display rules of special symbols(»?!).
• Add more built-in border themes.
• Other fixes and optimizations.

5.2.5 (2024/12/19)

• Fix a bug where filtering completions would cause an error when the configuration item enable_tip is set to 0, and reduce the flashing of completion menu.

5.2.4 (2024/12/19)

• Optimize module version migration.

5.2.3 (2024/12/18)

• Use https://abgox.github.io/PSCompletions as the primary source for module and completion updates.
• This is a fix specifically for those users whose language is zh-CN or set to zh-CN.
• The order to try now is:
  1. https://abgox.github.io/PSCompletions
  2. https://github.com/abgox/PSCompletions/raw/main
  3. https://gitee.com/abgox/PSCompletions/raw/main

5.2.2 (2024/12/18)

• Optimize the display of menus, making the menu items and command help more reasonable.
• Optimize the display effect of PowerShell built-in command help prompts.
• Fix a bug where all configuration items may be reset after module updates.
• Other fixes and optimizations.

5.2.1 (2024/12/13)

• Fix an issue where some completion items were missing due to errors during parsing of completions.
• Other optimizations and fixes.

5.2.0 (2024/12/12)

• Add an option --force to the command psc update *.
• Stop using filter mode to get completions, and cache the parsed tree object, which greatly improves completion performance.
• Expand the completion sorting function, now, completions that are not added by psc add will also be sorted automatically based on command history.
• Add a style bold_line_rect_border for border lines. Use it by the command psc menu line_theme bold_line_rect_border.
• Modify the default symbol (?!») to avoid rendering issues caused by special characters.
• Optimize the display effect of the completion menu in various terminal window sizes.
• Delay the effective node of hooks to the end of processing completion items, which is more flexible.
• Replace the configuration item disable_hooks with enable_hooks.
• Fix the issue of multiple update confirmations caused by the CompletionPredictor module.
• Fix compatibility issues in Windows PowerShell, such as the completion menu being misaligned and other compatibility issues.
• Fix the issue of not fully utilizing the terminal width for command prompt information adaptation.
• Now, you can create a data.json file with content {} in the installation logic of Scoop application manifests.
• Other optimizations and fixes.

5.1.4 (2024/11/30)

• Fix the issue of unexpected border style change when using PowerShell and Windows PowerShell together in v5.1.3.

5.1.3 (2024/11/30)

• Fix the issue of dynamic completion not taking effect for commands with hooks.ps1.
• When subsequent module needs to be updated, it will try multiple update methods.
• Other optimizations and fixes.

5.1.2 (2024/11/27)

• Due to future changes in Windows Terminal, 😄🤔😎 will not be displayed properly in the completion menu, so these three default special symbols will change.
  • Related issue: https://github.com/microsoft/terminal/issues/18242
  • Currently, Windows Terminal is available, Windows Terminal Preview is not available.
  • PSCompletions will not automatically replace them, you need to run the command psc reset menu symbol to replace them.
  • The changes are as follows:
    • 😄 => →
    • 🤔 => ?
    • 😎 => ↓
• Fix the issue of not taking effect after configuration modification.
• Other optimizations and fixes.

5.1.1 (2024/11/22)

• Fix the issue of order.json parsing compression causing completion errors.
• Other optimizations and fixes.

5.1.0 (2024/11/21)

• Add method $PSCompletions.argc_completions() for argc-completions.
  • For details: PSCompletions and argc-completions.
• Optimize the module directory structure, and put unnecessary files into the temp directory.
• Reduce unnecessary duplicate parsing, making subsequent completions faster after the first completion.
• Other optimizations and fixes.

5.0.8 (2024/11/15)

• Fix the issue that the help information is not changed after switching languages.
• Fix some issues with the reset subcommand.
• Now, when downloading/updating completions, all json files will be compressed.

5.0.7 (2024/11/9)

• Fix an initialization bug.

5.0.6 (2024/10/26)

• Fix directory path completion without trailing path separators.
• Other optimizations and fixes.

5.0.5 (2024/9/2)

• Add a method return_completion in $PSCompletions for hooks.ps1.
• Other optimizations and fixes.

5.0.4 (2024/9/1)

• Fix the issue that the psc rm * command will reset all configuration items.
• Other optimizations and fixes.

5.0.3 (2024/8/31)

• Fix the error that the psc subcommand runs into an error.
• Other optimizations and fixes.

5.0.2 (2024/8/31)

• Remove unnecessary file I/O operations.
• Other optimizations and fixes.

5.0.1 (2024/8/31)

• Fix the issue that psc did not add after updating the module version.

5.0.0 (2024/8/30)

• Reduce file I/O operations and optimize initialization method to improve first load speed.
  • Remove the alias.txt file in each completion directory, and use data.json to store data.
• Merge configuration data file config.json into data.json.
  • Note: If you use scoop to install PSCompletions, please check the manifest (persist) to update to data.json.
• Modify the name of almost all configuration items.
  • The name of the configuration item has been modified, and it will not affect normal use. When the version is updated, it will automatically migrate the old configuration item to the new configuration item.
  • For example:
    • update => enable_completions_update
    • module_update => enable_module_update
    • menu_show_tip => enable_tip
    • …
• Remove two configuration items: github and gitee.
  • If you need to customize the url, please use the url configuration item.
  • psc config url <url>
• Other optimizations and fixes.

4.3.3 (2024/8/27)

• Fix an error that occurred when menu_is_prefix_match was enabled, due to the input after public prefix extraction.

4.3.2 (2024/8/18)

• Fix a method(show_module_menu) parameter type conversion error.

4.3.1 (2024/8/18)

• Add a configuration item menu_is_loop, controlling whether the menu is looped, with a default value of 1.
  • Disable it: psc menu config menu_is_loop 0
• Optimize the migration logic of old versions.

4.3.0 (2024/8/15)

• Fix module update issue in Windows PowerShell.
• Fix dynamic completion sorting failure.
• Fix a issue in version comparison.
  • To avoid version comparison errors, this version number is changed from 4.2.10 to 4.3.0.

4.2.9 (2024/8/15)

• Fix some issues.
• Optimize some logic, improve performance.

4.2.8 (2024/8/12)

• Fix a rendering error caused by a boundary case.

4.2.7 (2024/8/12)

• PSCompletions module will take up two global names, $PSCompletions (variable) and PSCompletions (function).
  • Now, they are both read-only, and trying to overwrite will have an error, preventing accidental operation from causing the module to fail.
  • However, PSCompletions (function) can be configured to change the function name.
• Add a configuration item function_name, with a default value of PSCompletions.
  • Setting: psc config function_name <name>
  • Use in the following case:
    • When you need to define a function, the name must be PSCompletions.
    • You can use function_name to rename the function of this module to a non-conflicting name.
  • Note:
    • PSCompletions (function) can be configured, but $PSCompletions (variable) cannot be modified.
• When you need to define a variable, the name must be $PSCompletions.
• It cannot be solved, either you don’t use PSCompletions module, or you give the variable you define a different name.
• Simple processing of ToolTip information for PowerShell commands, optimized display.
• When the menu is displayed, filtering by input characters no longer changes the width of the menu.
• Fix a bug where you could set an existing command as an alias.
• Optimize logical operations, remove some unnecessary operations.

4.2.6 (2024/8/10)

• Fix a bug where the list of completions list was empty.
• If using Windows PowerShell and using a command-line theme (such as oh-my-posh), it may cause the current line and nearby text and icons to be distorted when the completion menu is displayed above the current line.
  • Solution:
    1. Disable the command-line theme.
    2. Try to make the completion menu display below the current line. (Only if the current line is above the middle of the window.)
    3. Do not use Windows PowerShell, use PowerShell.
       • Windows PowerShell is really bad, there are always many small issues.

4.2.5 (2024/8/10)

• If prefix match (menu_is_prefix_match) is enabled in the completion menu, only the value of completion is extracted when there’s a common prefix.
• Optimize the logic of completion update.

4.2.4 (2024/8/10)

• Fix an issue where Windows PowerShell module loading failed because a code file used LF line breaks.
  • For code files , replace LF line breaks to CRLF line breaks and replace UTF-8 to UTF-8-BOM encoding.
• Fix an issue where initialization imports were missing in non-Windows environments.
• Change the source file directory structure.

4.2.3 (2024/8/9)

• Fix an issue where the menu_show_tip configuration for specific completions was invalid.
• Fix an issue where the menu was rendered incorrectly when filtering completions.

4.2.2 (2024/8/9)

• No longer checks for updates immediately after using psc update * update completion.

4.2.1 (2024/8/9)

• Fix a small issue when migrating to the new version.

4.2.0 (2024/8/9)

• Add three menu configurations:

  1. menu_trigger_key: Default value is Tab, which is used to set the trigger key of the completion menu.
     • Setting: psc menu config menu_trigger_key <key>
  2. menu_enhance: Default value is 1, which is used to enable or disable the enhanced completion menu feature.
     • Disable it: psc menu config menu_enhance 0
     • When enabled, PSCompletions will intercept all completions and uses the completion menu provided by PSCompletions to render completions.
     • For example, commands such as Get-*, Set-* in PowerShell will use the completion menu provided by PSCompletions to render the completion.
     • Note: This setting only takes effect if menu_enable is also enabled.
     • About menu enhance
  3. menu_show_tip_when_enhance: Default value is 1, which is used to control whether to show command tips for completions that are not added through psc add.
     • Disable it: psc menu config menu_show_tip_when_enhance 0
     • Use together with menu_enhance.

• Fix an issue where multi-byte characters(such as Chinese characters) could cause partial rendering errors in the menu.

  • This is useful with menu_enhance.
  • For example, when using the cd command, even if the path completion contains Chinese or other multi-byte characters, the menu will render correctly.

• Completion tips now support automatic line wrapping based on available width.

  • For a better experience, the default value of the menu_tip_follow_cursor config has been changed from 0 to 1.
• Refactored code by reorganizing the source file directory structure and extracting common code.
• Use multi-threading to optimize performance and remove some redundant code.
• Fixed some other issues.
• Cleaned up the code.

4.1.0 (2024/8/7)

• Now Windows PowerShell can use the completion menu provided by PSCompletions.
  • But, due to rendering problems, the border style of the completion menu cannot be customized.
• Fix some other issues.
• Change the directory structure of the source code file.
• Clean up the code.

4.0.9 (2024/7/20)

• Add two commands: add/remove all completions.
  • psc add *
  • psc rm *
• Optimize the logic processing of common_options.
• Fix the problem of module update.
• Change the directory structure of the source code file.
• Clean up the code.

4.0.7 (2024/7/6)

• Replace ForEach-Object with foreach.
  • ForEach-Object has unexpected results in some special cases.
• Clean up some code

4.0.6 (2024/5/20)

• A default configuration color was mistakenly written, fix it.

4.0.5 (2024/5/20)

• Fix some issues about the special configurations of completion.
• Fix an issue where configuration changes did not take immediate effect due to caching.
• Add the completion subcommand to the reset command to reset (remove) the special configuration of completion.
• Fix some other issues.

4.0.4 (2024/5/20)

• Fix a bug where the completion tip area, filter area and status area flashes when scrolling the completion list.
• Fix some other minor issues.

4.0.3 (2024/5/18)

• Fix a bug where the completion tip was displayed incorrectly because the terminal output encoding was modified.
  • You must import the PSCompletions module first, and then modify the terminal output encoding. Otherwise, it will still display incorrectly.
• Change the default value of menu_tip_cover_buffer from 0 to 1.
  • This configuration means that the completion tip will cover the buffer content by default, which is mainly when the completion tip is displayed above, it will cover all the buffer content above, which will make the background look cleaner.
  • Of course, the buffer content covered by the completion tip will be restored when the completion menu exits.
  • You can disable it by running psc menu config menu_tip_cover_buffer 0.
• Fix some other minor issues.

4.0.2 (2024/5/15)

• A test environment configuration was not deleted, fix it.

4.0.1 (2024/5/15)

• A default configuration color was mistakenly written, fix it.

4.0.0 (2024/5/15)

• If you are using the PSCompletions module with administrator permission, you should remove the PSCompletions module and install the latest version with user permission.

  • Full module installation command: Install-Module PSCompletions -Scope CurrentUser

• This version completely rewrites the module, and solves many inappropriate places, so it’s completely incompatible with the old version configuration and completion.

  1. Performance optimization:
     • Improve module loading speed.
     • Improve completion response speed.
  2. Completion menu:
     • Completely rewrite the completion menu, which greatly improves the stability of the menu rendering, and solves many rendering bugs from the root.
     • The completion menu now has many configuration items, you can trigger completion by running psc menu, then learn about them by completion tip.
     • For example: menu_show_tip, which can control whether the completion tip is displayed.
       • If you are familiar with the command, it’s recommended to disable the completion tip.
       • This configuration can also be set separately for each completion, refer to psc completion for command.
  3. Completion alias:
     • Now completion alias supports multiple, you can add as many as you like. Theoretically, you can add an infinite number of aliases.
     • For example, you can add .\scoop.ps1 as an alias, which can be useful in some cases.
  4. Decoupling of completion file and module.
     • Add/update/translate completions now doesn’t involve module core code. (Except if hooks are needed.)
     • Use json schema to control the type of json file, which makes it easier for contributors to create PR for the completion repository.
     • For example, if you think the description of a command is not good, you can modify its json file and create a PR.
  5. Language:
     • Now the module supports any language, and the module determines the language based on the language configuration and each completion’s config.json file.
     • It means that more languages can be supported in the future by simply writing the corresponding json file.
  6. Other:
     • Added some key mappings, which allows you to select completion items in the completion menu using various key combinations. You can choose one that suits you. |Select previous item|Select next item| |:-:|:-:| |Up|Down| |Left|Right| |Shift + Tab|Tab| |Shift + Space|Space| |Ctrl + u|Ctrl + d| |Ctrl + p|Ctrl + n|
     • The symbol is now placed behind the completion item, and the symbol is no longer displayed in the completion tip.
     • …

This site is open source. Improve this page.