Installation
Multiple ways to install xenvsync on any platform.
npm (Quickest)
Install globallybash
$ npm install -g xenvsync
Or run without installing: npx xenvsync
The npm package automatically downloads the correct binary for your platform.
Go Install
Requires Go 1.22+.
Installbash
$ go install github.com/nasimstg/xenvsync@latest
This places the binary in $GOPATH/bin. Make sure it's in your PATH.
Binary Releases
Prebuilt binaries are available on GitHub Releases.
Linux / macOS
Download & installbash
# Replace VERSION and PLATFORM (e.g., linux_amd64, darwin_arm64)
$ curl -LO https://github.com/nasimstg/xenvsync/releases/latest/download/xenvsync_VERSION_PLATFORM.tar.gz
$ tar xzf xenvsync_VERSION_PLATFORM.tar.gz
$ sudo mv xenvsync /usr/local/bin/
Linux (.deb / .rpm)
Package managerbash
# Debian / Ubuntu
$ sudo dpkg -i xenvsync_VERSION_linux_amd64.deb
# RHEL / Fedora
$ sudo rpm -i xenvsync_VERSION_linux_amd64.rpm
Windows
Download the .zip from the releases page, extract it, and add the directory to your PATH.
Build from Source
Clone and buildbash
$ git clone https://github.com/nasimstg/xenvsync.git
$ cd xenvsync
$ make build
make build injects version, commit, and build date via ldflags. Use make install for direct install to $GOPATH/bin.
Verify
Check versionbash
$ xenvsync version
xenvsync v0.1.0
commit: abc1234
built: 2026-03-21T00:00:00Z
Supported Platforms
| OS | Architecture | Formats |
|---|---|---|
| Linux | amd64, arm64 | .tar.gz, .deb, .rpm, .apk |
| macOS | amd64, arm64 | .tar.gz |
| Windows | amd64, arm64 | .zip |
Upgrading
Replace the binary with a newer version. Config files are forward-compatible.
$ npm update -g xenvsync
# or
$ go install github.com/nasimstg/xenvsync@latest