Skip to content

Install Script

Install xcsh with automatic platform detection and shell configuration.

Quick Install

curl -fsSL https://robinmordasiewicz.github.io/f5xc-xcsh/install.sh | sh
wget -qO- https://robinmordasiewicz.github.io/f5xc-xcsh/install.sh | sh

Example output:

xcsh installer
=================

==> Detected platform: macOS ARM64 (Apple Silicon/ARM)
==> Fetching latest version from GitHub...
==> Latest version: v2.0.9-2601051439
==> Downloading xcsh v2.0.9-2601051439...
    Platform: macOS ARM64 (Apple Silicon/ARM)
    URL: https://github.com/robinmordasiewicz/f5xc-xcsh/releases/download/v2.0.9-2601051439/xcsh_v2.0.9-2601051439_darwin_arm64.tar.gz
==> Verifying SHA256 checksum...
==> Checksum verified
==> Extracting archive...
==> Installing to /usr/local/bin...
==> Installed xcsh to /usr/local/bin/xcsh
==> Setting up bash completion (user)...
==> Bash completion installed to /Users/runner/.local/share/bash-completion/completions/xcsh
==> Adding bash completion configuration to /Users/runner/.bashrc...
==> Updated /Users/runner/.bashrc with completion configuration

==> xcsh v2.0.9-2601051439 installed successfully!

Get started:
  xcsh --help              # Show help
  xcsh configure           # Configure credentials
  xcsh version             # Show version info

Documentation: https://github.com/robinmordasiewicz/f5xc-xcsh

Output captured on 2026-01-05

Specific Version

curl -fsSL https://robinmordasiewicz.github.io/f5xc-xcsh/install.sh | VES_VERSION=2.0.9 sh

Custom Install Directory

curl -fsSL https://robinmordasiewicz.github.io/f5xc-xcsh/install.sh | VES_INSTALL_DIR=$HOME/.local/bin sh

Uninstall

curl -fsSL https://robinmordasiewicz.github.io/f5xc-xcsh/install.sh | sh -s -- --uninstall

Environment Variables

Variable Default Description
VES_VERSION latest Specific version to install
VES_INSTALL_DIR /usr/local/bin Installation directory
VES_NO_SUDO unset Skip sudo usage
VES_NO_VERIFY unset Skip checksum verification

Features

  • Automatic platform detection - Linux and macOS (amd64/arm64)
  • Checksum verification - SHA256 validation of downloads
  • Shell completion - Auto-configured for bash, zsh, and fish
  • PATH configuration - Automatically updates shell RC files
  • Upgrade detection - Skips if same version installed

Supported Platforms

OS Architectures
Linux amd64, arm64
macOS amd64 (Intel), arm64 (Apple Silicon)

Windows

Download manually from GitHub Releases.