Skip to main content

Installation

Choose the installation method that works best for your platform and workflow. The fastest way to install gitsw on macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/yigiterdev/git-switch/main/install.sh | sh
This script:
  • Automatically detects your operating system and architecture
  • Downloads the latest pre-built binary
  • Installs to /usr/local/bin (requests sudo if needed)
  • Verifies the installation
The install script supports macOS (Apple Silicon), Linux (x64), and Windows. Intel Mac users should use cargo install instead.

Install from Crates.io

If you have Rust installed, you can install gitsw using cargo:
cargo install gitsw
This method:
  • Works on all platforms with Rust 1.70+
  • Compiles from source for optimal performance on your system
  • Automatically adds the binary to your cargo bin directory
Make sure ~/.cargo/bin is in your PATH to run gitsw from anywhere.

Install from Source

For the latest development version or to contribute:
1

Clone the repository

git clone https://github.com/yigiterdev/git-switch.git
cd gitsw
2

Install with cargo

cargo install --path .
3

Verify installation

gitsw --version

Install from GitHub

Install directly from the GitHub repository:
cargo install --git https://github.com/yigiterdev/git-switch

Pre-built Binaries

Download pre-compiled binaries for your platform from the GitHub Releases page.

Available Platforms

PlatformArchitectureDownload
macOSApple Silicon (M1/M2/M3)gitsw-aarch64-apple-darwin.tar.gz
Linuxx86_64gitsw-x86_64-unknown-linux-gnu.tar.gz
Windowsx86_64gitsw-x86_64-pc-windows-msvc.zip
For macOS Intel systems, use cargo install gitsw as pre-built binaries are not available for this platform.

Manual Installation Steps

1

Download the binary

Download the appropriate archive for your platform from the releases page.
2

Extract the archive

macOS/Linux:
tar xzf gitsw-*.tar.gz
Windows:
unzip gitsw-*.zip
3

Move to PATH

macOS/Linux:
sudo mv gitsw /usr/local/bin/
sudo chmod +x /usr/local/bin/gitsw
Windows (PowerShell):
Move-Item gitsw.exe C:\Windows\System32\
4

Verify installation

gitsw --version

Requirements

  • Git 2.0 or later
  • For cargo installation: Rust 1.70 or later

Next Steps

Now that you have gitsw installed, check out the Quick Start guide to learn how to use it.

Build docs developers (and LLMs) love