Shell Integrations

Completions

cutler supports built-in shell completion for your ease of access for a variety of system shells, including bash, zsh, powershell etc. Below you will find instructions for each of them.

If you have installed cutler using Homebrew, the shell completion will automatically be installed. Just restart your shell after initial installation.

Bash completions setup

1. Make a directory to store Bash-specific completions:

$ mkdir ~/.bash-completion.d/

2. Generate the completion script using the following command and pipe the output to a new file:

$ cutler completion bash > cutler.bash
$ mv cutler.bash ~/.bash-completion.d/

3. Finally, source the completion script. The best way would be to simply add it to your .bashrc file:

$ source ~/.bash_completion.d/cutler.bash > ~/.bashrc

Zsh completions setup

1. Make sure you have a directory for custom completions:

$ mkdir -p ~/.zfunc

2. Then, generate the completion script and move it over:

$ cutler completion zsh > _cutler
$ mv _cutler ~/.zfunc/

3. Then, add to your ~/.zshrc:

$ fpath=(~/.zfunc $fpath)
$ autoload -U compinit && compinit

4. Restart your shell or run:

$ source ~/.zshrc

For other shells

# Fish
$ cutler completion fish

# Elvish
$ cutler completion elvish

# PowerShell
$ cutler completion powershell