aether completion

Generate shell completion scripts

aether completion

Generate shell completion scripts for tab completion of commands, subcommands, and flags.

Usage

aether completion [bash|zsh|fish|powershell]

Shells

Shell	Description
bash	Bash completion script
zsh	Zsh completion script
fish	Fish completion script
powershell	PowerShell completion script

Setup

Bash

Load completions in the current session:

source <(aether completion bash)

Persist across sessions by adding to ~/.bashrc:

echo 'source <(aether completion bash)' >> ~/.bashrc

On macOS with Homebrew bash-completion:

aether completion bash > "$(brew --prefix)/etc/bash_completion.d/aether"

Zsh

Generate the completion file:

aether completion zsh > "${fpath[1]}/_aether"

If $fpath[1] is not writable, create a custom completions directory:

mkdir -p ~/.zsh/completions
aether completion zsh > ~/.zsh/completions/_aether

Add the directory to your fpath in ~/.zshrc:

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

Restart your shell or run compinit to load the completions.

Fish

Load completions in the current session:

aether completion fish | source

Persist across sessions:

aether completion fish > ~/.config/fish/completions/aether.fish

PowerShell

Load completions in the current session:

aether completion powershell | Out-String | Invoke-Expression

Persist by adding to your PowerShell profile ($PROFILE):

aether completion powershell >> $PROFILE

Examples

# Generate and inspect the bash completion script
aether completion bash

# Pipe directly to a file
aether completion zsh > /usr/local/share/zsh/site-functions/_aether

# Verify completions are working (type and press Tab)
aether pr<TAB>
# completes to: aether project