carapace-bin
Carapace-bin provides argument completions for many CLI commands: see the full list here, and works across many POSIX and non-POSIX shells. This multi-shell multi-command argument completer is based on rsteube/carapace. You can read more about this tool here: A pragmatic approach to shell completion.
Supported shells:
- Bash
- Elvish
- Fish
- Ion (experimental)
- Nushell (experimental)
- Oil
- Powershell
- Tcsh (experimental)
- Xonsh
- Zsh
Status
A major part of the completers has been generated from help pages so there will be some quirks here and there. Also completion depends on what rsteube/carapace is capable of so far.
Getting Started
Ensure carapace is added to PATH (Installation). Then register the completers (Setup):
# bash (~/.bashrc)
source <(carapace _carapace)
# elvish (~/.elvish/rc.elv)
eval (carapace _carapace|slurp)
# fish (~/.config/fish/config.fish)
mkdir -p ~/.config/fish/completions
carapace --list | awk '{print $1}' | xargs -I{} touch ~/.config/fish/completions/{}.fish # disable auto-loaded completions (#185)
carapace _carapace | source
# nushell [needs fork: https://github.com/rsteube/nushell]
carapace _carapace nushell | save carapace.nu ; nu -c 'source carapace.nu'
# oil (~/.config/oil/oshrc)
source <(carapace _carapace)
# powershell (~/.config/powershell/Microsoft.PowerShell_profile.ps1)
Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete
carapace _carapace | Out-String | Invoke-Expression
# tcsh (~/.tcshrc)
set autolist
eval `carapace _carapace`
# xonsh (~/.config/xonsh/rc.xsh)
COMPLETIONS_CONFIRM=True
exec($(carapace _carapace))
# zsh (~/.zshrc)
source <(carapace _carapace)