Wade

🏄 All-in-one runtime manager: Node.js · Go · Python. Single binary, zero deps.

Wade replaces nvm + cgr/nrm + gvm + pyenv. Single binary, install once, works everywhere.

📖 中文文档 · 🌐 Website

---

Installation

Pre-built binary (recommended, no Go required)

Download the latest binary from GitHub Releases:

Platform	Download
macOS (Apple Silicon)	wade-darwin-arm64.tar.gz
macOS (Intel)	wade-darwin-amd64.tar.gz
Linux (x64)	wade-linux-amd64.tar.gz
Windows (x64)	wade-windows-amd64.zip

# Example: macOS Apple Silicon
tar xzf wade-darwin-arm64.tar.gz
sudo mv wade /usr/local/bin/
wade -i

macOS — Homebrew

brew install wadefengx/tap/wade
wade -i

Windows — Scoop

scoop bucket add wade https://github.com/wadefengx/scoop-wade
scoop install wade
wade -i

Linux / macOS — curl installer

curl -fsSL https://github.com/wadefengx/wade/releases/latest/download/install.sh | bash
wade -i

From source (requires Go 1.23+)

git clone https://github.com/wadefengx/wade.git
cd wade
go build -o /usr/local/bin/wade .
wade -i

Post-install: add to PATH

After wade -i this is done automatically. If you need to do it manually:

Platform	Config file	Line to add
macOS / Linux (zsh)	~/.zshrc	export PATH="$HOME/.wade/shims:$PATH"
macOS / Linux (bash)	~/.bashrc	export PATH="$HOME/.wade/shims:$PATH"
Windows (PowerShell)	$PROFILE	$env:Path = "$env:USERPROFILE\.wade\shims;$env:Path"
Windows (CMD)	System PATH	Add %USERPROFILE%\.wade\shims via System Properties

---

Quick Start

wade -i          # Interactive setup — choose Node, Go, Python, or all
wade init -y     # Non-interactive: auto-config all three (China-friendly)

Per-runtime

Runtime	Install	Switch	Lists	Mirror	Registry
Node	wade node install 20	wade node use 20	ls / ls-remote	node mirror	registry
Go	wade go install 1.23	wade go use 1.23	ls / ls-remote	go mirror	go proxy
Python	(system)	—	python ls	—	python registry

---

Commands

wade -i / wade init — Setup wizard

wade -i                 # 3-step interactive setup
wade init -y            # Non-interactive (defaults)
wade init               # Write .wade-version for current project

wade node — Version management

wade node install 20        # Install Node 20
wade node use 20            # Switch to Node 20
wade node use               # Use the nearest .wade-version project pin
wade node ls                # List installed versions
wade node ls-remote         # Browse available versions
wade node default 20        # Set default version
wade node uninstall 18      # Remove a version
wade node mirror            # Show download source
wade node mirror mirror     # Use npmmirror.com (fast in China)
wade node mirror official   # Use nodejs.org

Project Node version pinning

Create a .wade-version file containing a Node version in a project directory:

echo 20.12.0 > .wade-version
wade node use

wade node use searches the current directory and its parents up to your home directory, using the nearest .wade-version. An explicit version, such as wade node use 22, takes precedence.

wade registry — npm/yarn/pnpm mirror

wade registry ls            # List all registries
wade registry use taobao    # Switch all package managers
wade registry add x https://x.com/   # Add custom
wade registry test          # Speed test

Built-in: npm, taobao, tencent, huawei, cnpm

wade go — Go version management

wade go install 1.23        # Install Go 1.23
wade go use 1.23            # Switch to Go 1.23
wade go ls                  # List installed versions
wade go ls-remote           # Browse available versions
wade go mirror ls           # List download mirrors
wade go mirror use google-cn  # Switch mirror (fast in China)
wade go mirror test         # Test mirror latency
wade go proxy ls            # List GOPROXY options
wade go proxy use goproxy.cn  # Switch proxy (fast in China)

wade python — Python pip registry

wade python ls              # Detect system Python versions
wade python registry ls     # List pip mirrors
wade python registry use tsinghua  # Switch to Tsinghua mirror
wade python registry use aliyun    # Switch to Aliyun mirror

---

Development

git clone https://github.com/wadefengx/wade.git
cd wade
go build -o wade .

See CHANGELOG.md for version history. AI tools: read AGENTS.md for project context.

License

MIT © wadefengx