This project has moved to https://github.com/nightroman/PS-GuiCompletion The published module is the same GuiCompletion. It is developed by @nightroman starting from v0.9.0.
This enables a GUI-style tab-completion menu for PowerShell. It integrates with PSReadLine which comes installed in PowerShell by default, and the GUI code is lifted straight from PowerTab.
Bugs? Please open an issue on Github: https://github.com/cspotcode/PS-GuiCompletion/issues
Install from the PowerShell Gallery. (GuiCompletion's Gallery page)
Install-Module -Name GuiCompletion -Scope CurrentUser
You can omit -Scope
but I use it to avoid requiring Administrator permissions.
Register it with the default Ctrl+Spacebar key shortcut:
Install-GuiCompletion
...or with another key shortcut:
Install-GuiCompletion -Key Tab
Install-GuiCompletion
is a one-line helper that wrap PSReadLine's Set-PSReadLineKeyHandler
cmdlet. For more advanced scenarios, you can call the relevant PSReadLine commands directly:
Set-PSReadlineKeyHandler -Key Alt+Spacebar -ScriptBlock { Invoke-GuiCompletion }
You'll want to add these configuration commands to your PowerShell profile. Otherwise your configuration will not be applied to new PowerShell sessions.
Mac and Linux support. GetKeyState and some of the rendering code is apparently Windows-only.
- Fixes broken publication of v0.8.0
- Switches to Windows' default menu color scheme (#5, @nightroman)
- If you want to use the old theme or customize colors, modify the
$GuiCompletionConfig.Colors
global variable.
- If you want to use the old theme or customize colors, modify the
- Fixes rendering glitch where some vertical lines could be left over after the menu closes (#6, @nightroman)
- Switches to
TabExpansion2
for computing completions, which allows other modules to plugin custom completions (#7, @nightroman)