kagi completion
Generate or install shell completion scripts for kagi.
Synopsis
kagi completion generate <SHELL>
kagi completion install [--shell <SHELL>] [--dir <DIR>]Supported shells:
bashzshfishpowershell
kagi completion install
Install a completion script for your active shell. When --shell is omitted, kagi detects the shell from environment variables such as SHELL.
kagi completion installChoose the shell explicitly when detection is unavailable or when installing for a different shell:
kagi completion install --shell bash
kagi completion install --shell zsh
kagi completion install --shell fish
kagi completion install --shell powershellDefault install targets:
| Shell | Target |
|---|---|
| bash | $XDG_DATA_HOME/bash-completion/completions/kagi, or ~/.local/share/bash-completion/completions/kagi |
| zsh | ~/.zsh/completions/_kagi |
| fish | $XDG_CONFIG_HOME/fish/completions/kagi.fish, or ~/.config/fish/completions/kagi.fish |
| powershell | $XDG_CONFIG_HOME/powershell/kagi-completions.ps1, or ~/.config/powershell/kagi-completions.ps1 |
For zsh, the installer also adds the completion directory to ~/.zshrc and ensures compinit is loaded. For PowerShell, it adds a dot-source line to the standard profile path under the same config directory.
Use --dir to write the completion file somewhere else:
kagi completion install --shell fish --dir ./completionskagi completion generate
Print a completion script to stdout without changing any files:
kagi completion generate bash > ~/.local/share/bash-completion/completions/kagi
kagi completion generate zsh > ~/.zsh/completions/_kagi
kagi completion generate fish > ~/.config/fish/completions/kagi.fish
kagi completion generate powershell >> $PROFILEkagi --generate-completion <SHELL> is still available as a shortcut for script generation. It cannot be combined with a subcommand; doing so exits with standard usage error code 2.