🍺 Homebrew (macOS)
Install Wade from the official Homebrew tap.
brew install wadefengx/tap/wade🚀 Node.js · Go · Python single binary
One tool to manage
your runtimes & registries
Wade replaces nvm + cgr/nrm + gvm + pyenv. Single binary, install once, works everywhere.
# Choose runtimes, mirrors, and PATH setup interactively $ wade -i ◇ Which runtimes to configure? │ 1. Node.js │ 2. Go │ 3. Python │ 4. All of the above # Or configure all runtimes with defaults, without prompts $ wade init -y 🌐 Go mirror: google-cn ✓ 🌐 Go proxy: goproxy.cn ✓ 🐍 pip registry: tsinghua ✓ # Install and switch Node.js or Go versions $ wade node install 20 Node v20.x installed ✓ # Go $ wade go install 1.23 Go 1.23.x installed ✓
Why Wade?
🎯 Node.js
Install, switch, default, and remove Node versions. Set the npm, yarn, and pnpm registry together.
🦫 Go
Install and switch Go versions, then select download mirrors and a GOPROXY for module downloads.
🐍 Python
Discover system Python versions and switch pip package indexes without managing another runtime install.
⚡ One binary
A standalone Go binary with no Node, Go, or Python dependency. Install once and use everywhere.
🌐 Mirror-aware
Choose official or regional Node and Go download sources, plus built-in npm and pip registry presets.
🔧 Guided setup
Use wade -i for the interactive wizard or wade init -y for non-interactive defaults.
Installation
After installation, run wade -i to configure your runtimes, mirrors, and PATH.
Command cheatsheet
Start with the wizard, then use the focused commands below to manage versions, mirrors, registries, and shell integration.
| Area | Command | What it does |
|---|---|---|
| Setup | wade -i / wade init -y | Run the interactive wizard or configure defaults without prompts. |
| Shell | wade setup --auto | Configure the shims directory on PATH without prompts. |
| Status | wade status | Show the current Node version, registry, and shim health. |
| Node | wade node install 20 | Install the latest Node 20 release; use use, ls, ls-remote, default, uninstall, or current as needed. |
| Node mirror | wade node mirror mirror | Use npmmirror.com; run wade node mirror official for nodejs.org or wade node mirror to inspect the source. |
| npm registry | wade registry use taobao | Switch npm, yarn, and pnpm together. Use ls, add, del, and test to manage registries. |
| Go | wade go install 1.23 | Install Go, then use wade go use 1.23, ls, or ls-remote to manage versions. |
| Go network | wade go mirror use google-cn | Select a Go download mirror; use mirror ls, mirror test, proxy ls, and proxy use goproxy.cn for GOPROXY. |
| Python | wade python ls | Detect system Python versions. Switch pip indexes with wade python registry use tsinghua or aliyun. |
Project status
All milestones M0–M8 are complete. Wade is production-ready.
| Milestone | Scope | Status |
|---|---|---|
| M0 | Project skeleton | Done |
| M1 | npm registry management | Done |
| M2 | Node version management | Done |
| M3 | Release automation | Done |
| M4 | Status, shell completions, and self-update | Done |
| M5 | Multi-runtime init wizard | Done |
| M6 | Go versions, Go mirrors/GOPROXY, and Python pip mirrors | Done |
| M7 | Unit and integration quality work; wade setup --auto | Done |
| M8 | Homebrew tap, Scoop bucket, and documentation site distribution | Done |