Homebrew (macOS/Linux)

Install xcsh on macOS or Linux using Homebrew:

brew tap robinmordasiewicz/tap
brew install --cask xcsh

Upgrade to latest version:

brew update
brew upgrade --cask xcsh

Uninstall:

brew uninstall --cask xcsh

Shell Completions

The Homebrew cask includes shell completions for bash, zsh, and fish. These are installed automatically to Homebrew’s managed directories.

Zsh

Completions should work automatically if you have Homebrew’s shell environment configured. Ensure your ~/.zshrc contains:

eval "$(brew shellenv)"

If you’re using Oh My Zsh, completions are enabled by default. Otherwise, add to your ~/.zshrc:

autoload -Uz compinit && compinit

Restart your terminal and test with xcsh <TAB>.

Bash

Install bash-completion if you haven’t already:

brew install bash-completion@2

Add to your ~/.bash_profile or ~/.bashrc:

[[ -r "$(brew --prefix)/etc/profile.d/bash_completion.sh" ]] && \
  . "$(brew --prefix)/etc/profile.d/bash_completion.sh"

Restart your terminal and test with xcsh <TAB>.

Fish

Completions work automatically if fish was installed via Homebrew.

Test with xcsh <TAB>.

Troubleshooting Completions

If completions don’t work after setup:

1. Ensure you’ve restarted your terminal
2. For zsh, try running rm -f ~/.zcompdump* then restart
3. Verify completions are installed: ls $(brew --prefix)/share/zsh/site-functions/_xcsh

Verify Installation

After installation, verify xcsh is working:

xcsh version

Expected output:

xcsh version v2.0.7