Skip to content

Homebrew (macOS/Linux)

Install xcsh on macOS or Linux using Homebrew:

brew tap robinmordasiewicz/tap
brew install --cask xcsh

Example output:

==> Caveats
xcsh has been installed.

Shell completions have been installed for bash, zsh, and fish.
You may need to restart your shell or source your shell config.

For setup instructions, see:
  https://robinmordasiewicz.github.io/f5xc-xcsh/install/homebrew/

Quick start:
  xcsh --help

==> Downloading https://github.com/robinmordasiewicz/f5xc-xcsh/releases/download/v2.0.9-2601051439/xcsh_v2.0.9-2601051439_darwin_arm64.tar.gz
==> Downloading from https://release-assets.githubusercontent.com/github-production-release-asset/1109354935/8c7b1eee-4f66-4c2e-8392-0e29603f7379?sp=r&sv=2018-11-09&sr=b&spr=https&se=2026-01-05T15%3A39%3A10Z&rscd=attachment%3B+filename%3Dxcsh_v2.0.9-2601051439_darwin_arm64.tar.gz&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2026-01-05T14%3A38%3A17Z&ske=2026-01-05T15%3A39%3A10Z&sks=b&skv=2018-11-09&sig=%2FlMZKngU0lF44gzq6f0lmISbyrQnhp8XZhtYLDVRCKw%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc2NzYyNjI4NSwibmJmIjoxNzY3NjI0NDg1LCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.K-VjjXCXAeOD6k9dIgvK0nTChSizRUslvTwdItfu5Uk&response-content-disposition=attachment%3B%20filename%3Dxcsh_v2.0.9-2601051439_darwin_arm64.tar.gz&response-content-type=application%2Foctet-stream
==> Installing Cask xcsh
==> Linking Binary 'xcsh' to '/opt/homebrew/bin/xcsh'
🍺  xcsh was successfully installed!

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.

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>.

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>.

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:

2.0.9