Shell Completion

cuttings supports tab-completion for all major shells via Cobra’s built-in completion system. Once installed, the following are completed dynamically:

Bash

Temporary (current session only)

source <(cuttings completion bash)

Persistent

cuttings completion bash >> ~/.bashrc

On macOS, Bash reads ~/.bash_profile for login shells, so you may need to append there instead (or source ~/.bashrc from ~/.bash_profile):

cuttings completion bash >> ~/.bash_profile

Restart your shell or run source ~/.bashrc to apply immediately.

Note: Bash completion requires bash-completion v2 or later for the best experience. On macOS the system Bash is version 3 — install a newer Bash and bash-completion@2 via your package manager.

Zsh

Temporary (current session only)

source <(cuttings completion zsh)

Persistent

Add the completion script to a directory on your $fpath and enable compinit. The recommended location is ~/.zsh/completions/:

mkdir -p ~/.zsh/completions
cuttings completion zsh > ~/.zsh/completions/_cuttings

Then make sure your ~/.zshrc contains the following before any call to compinit:

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

Restart your shell or run exec zsh to apply.

Oh My Zsh

If you use Oh My Zsh, place the completion file in the custom completions directory:

cuttings completion zsh > "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/completions/_cuttings"

Restart your shell or run omz reload.

Fish

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

Fish loads completion files automatically — no further configuration is needed. Start a new Fish session to pick up the completions.

PowerShell

Note: cuttings uses syscall.Exec for shell spawning, which is not available on Windows. The binary is Unix-only. PowerShell completion is therefore not documented here.

Verifying completions work

After installation, open a new shell session inside a git repository that has active cuttings and test:

cuttings shell <TAB>     # should list active cutting branches
cuttings new <TAB>       # should list local git branches

If nothing appears, ensure the completion script was sourced and that your shell’s completion system is initialised correctly.