PSCompletions (psc)

Introduce

Star ⭐️ or Donate 💰 if you like it!

TIP

• PowerShell (Core): A cross-platform PowerShell. Start it by running pwsh/pwsh.exe.
• Windows PowerShell (Desktop): A PowerShell which is built-in on Windows system. Start it by running powershell/powershell.exe.
• They can both use PSCompletions, but PowerShell (Core) is more recommended.

A completion manager for a better and simpler tab-completion experience in PowerShell.

• Built-in completion library.
• More powerful module completion menu.
• Support multiple languages: en-US, zh-CN, etc.
• Sort completion items dynamically based on command history.
• Work with other tools.
  • argc-completions
  • Carapace
  • PSFzf

Demo

TIP

Click to view the videos on Bilibili.

What's new

See the changelog for details.

Contribution

See the contribution guide for details.

How to install

1. Install the module.

   • Install-Module

     Install-Module PSCompletions

   • Install-PSResource

     Install-PSResource PSCompletions

   • Scoop

     • Add the abyss bucket via Github or Gitee.

     • Install it.

       scoop install abyss/abgox.PSCompletions

2. Import the module.

   Import-Module PSCompletions

TIP

• If you use . $PROFILE, please run psc to reload the module's key bindings and data.
• Refer to: Source profile

How to use

• Use the built-in completion library, like git.

  1. Add completion: psc add git
  2. Then you can enter git, press Space and Tab key to get command completion.

• Use official completion or other completion libraries.

  • If there is an official completion for xxx, a similar command may be run:

    xxx completion powershell | Out-String | Invoke-Expression

  • Work with other completion libraries: argc-completions, Carapace

  • For more details, please refer to menu enhance

• Use PSFzf as the completion menu.

Acknowledgements

• PSReadLine: A built-in module in PowerShell, which is used to enhance command line editing experience.
  • PSCompletions uses Set-PSReadLineKeyHandler and Get-PSReadLineOption.
• PS-GuiCompletion: GUI-style tab-completion menu for PowerShell.
  • The module completion menu of PSCompletions is inspired by it.

Completions