gvsn - Go Version Manager

gvsn - Go Version Manager

A fast, cross-platform Go version manager written in Rust. Install, switch, and pin any Go release - no sudo, no system dependencies, no fuss.

Warning

Only get gvsn from this repository's official Releases page or the install commands below. Clones of this repository exist that distribute unofficial binaries under the same name. See SECURITY.md for known cases, the plain-language walkthrough of how one clone's malware works, or the full technical writeup of the active malware-distributing clone.

✨ What makes gvsn different?

gvsn is a Go version manager built from scratch in Rust. It was designed with a single goal: work everywhere, require nothing.

No Go required - you don't need Go installed to install Go. gvsn downloads the official toolchain directly from go.dev.
No sudo, no root - everything lives under ~/.gvsn in your home directory.
Zero system dependencies - a single static binary is all you need on Windows, Linux (x86_64/ARM64/ARMv7/386), and macOS. The additional Linux server architectures (RISC-V, IBM Z, IBM POWER) link against the system's glibc instead, since Rust has no stable static (musl) target for them yet - glibc ships with essentially every Linux distribution and is backward-compatible, so this rarely matters in practice.
Truly cross-platform - one codebase, one behavior across Windows, Linux, and macOS on both x86_64 and ARM64.
SHA-256 verified downloads - every archive is checked against go.dev's official checksum before extraction.
Fast, resumable downloads - a single stream with a large read buffer to use as much of the link's throughput as possible. Interrupted downloads resume automatically from the last byte.
Transparent build output - gvsn build -v streams every compiler line in real time so you always know what is happening.
Session-scoped activation - gvsn shell <version> activates a version for the current terminal only, without touching any files.
Full environment setup - gvsn setup configures everything: shell hook, login profile PATH (so GUI apps like VSCode find Go), and Windows registry. Works correctly after a fresh install or a shell change.
Self-updating - gvsn upgrade downloads and replaces the binary in-place.
Clean uninstall - gvsn implode removes everything gvsn ever touched.

🦀 Why Rust, not Go?

A fair question for a Go tool. A few honest reasons, not a verdict on Go:

Memory safety for the riskiest operations. gvsn upgrade replaces its own running binary, gvsn setup writes to your shell profile and the Windows registry PATH, and gvsn implode deletes files across your home directory. These are exactly the operations where a memory bug turns into a corrupted install or a broken shell - Rust's ownership model rules out that class of bug at compile time.
A mature, boring cross-compilation story. Twelve target platforms build from one codebase, with static linking handled by cross and musl/static-MSVC targets - no per-platform toolchain juggling to maintain.
Not depending on the exact ecosystem it manages. Both Go and Rust produce standalone static binaries, so "you don't need Go to install Go" isn't unique to Rust - but keeping this tool's own build independent of the toolchain it manages felt like the right instinct.

Plenty of excellent Go version managers are written in Go itself - this was a deliberate choice for this project, not a claim that Rust is categorically the right call for CLI tooling.

🚀 Features

📥 Install any Go version - by exact version, minor range, or latest
⚡ Fast, resumable downloads - single-stream with automatic resume on interruption (--retries)
🔨 Build from source - compile any Go version from the official source tarball with automatic bootstrap detection and real-time streaming output
🌍 Global default - set a system-wide version with gvsn use
📌 Per-project pinning - drop a .go-version file; gvsn activates it automatically
🐚 Session-scoped activation - gvsn shell <version> switches versions for the current terminal only, no files written
🔐 SHA-256 verification - every download is checked against go.dev's official checksum
🐚 Shell integration - automatic PATH and GOROOT injection for PowerShell, Bash, Zsh, and Fish
⚡ gvsn exec - run a command with any Go version without changing the global default
🩺 gvsn doctor - diagnose your setup with actionable hints
📈 gvsn outdated - check installed versions against go.dev for newer patch releases
🧹 gvsn prune - remove installed versions no longer referenced by any project
🔄 gvsn upgrade - self-update to the latest release from GitHub
💣 gvsn implode - completely remove gvsn and all installed versions cleanly
🏁 Shell completions - Bash, Zsh, Fish, and PowerShell
🖥️ Cross-platform - Windows, Linux, macOS × x86_64 and ARM64

📦 Installation

🪟 Windows (PowerShell)

irm https://raw.githubusercontent.com/jhonsferg/gvsn/main/install/install.ps1 | iex

Installs gvsn.exe to ~\.local\bin, then automatically runs gvsn setup which adds the binary directory and ~\.gvsn\current\bin to your user PATH via the Windows registry, and injects the shell hook into your PowerShell profile. The archive's checksum is verified against checksums.txt before extraction. The binary statically links the Windows C runtime, so it never depends on the Visual C++ Redistributable being installed.

🐧 Linux and 🍎 macOS

curl -fsSL https://raw.githubusercontent.com/jhonsferg/gvsn/main/install/install.sh | sh

Installs gvsn to ~/.local/bin, then automatically runs gvsn setup which injects the gvsn env hook into your shell profile (~/.bashrc, ~/.zshrc, etc.) and adds a static ~/.gvsn/current/bin PATH entry to your login profile (~/.profile or ~/.zprofile) so that GUI applications like VSCode and GoLand can find Go without needing an interactive shell. The archive's checksum is verified against checksums.txt before extraction.

📂 Custom install directory

# 🪟 Windows
$env:GVSN_INSTALL_DIR = "C:\tools\gvsn"; irm .../install.ps1 | iex

# 🐧 Linux / 🍎 macOS
GVSN_INSTALL_DIR=~/.bin curl -fsSL .../install.sh | sh

✅ Verify the installation

gvsn doctor

🗑️ Uninstallation

Two equivalent ways to remove gvsn completely - all installed Go versions, the ~/.gvsn data directory, the binary, and every gvsn-managed line in your shell profile(s) / Windows PATH registry:

Option 1 - gvsn implode (if the binary still works):

gvsn implode

Option 2 - standalone uninstaller script (works even if the binary is broken or already gone, and cleans every supported shell's profile, not just the one currently detected):

# 🪟 Windows
irm https://raw.githubusercontent.com/jhonsferg/gvsn/main/install/uninstall.ps1 | iex

# 🐧 Linux / 🍎 macOS
curl -fsSL https://raw.githubusercontent.com/jhonsferg/gvsn/main/install/uninstall.sh | sh

Both scripts show exactly what will be removed and ask for confirmation first. Add --dry-run to preview with nothing deleted, or --force to skip the prompt (a piped POSIX shell script can't prompt interactively, so use GVSN_UNINSTALL_FORCE=1 / GVSN_UNINSTALL_DRY_RUN=1 before the curl one-liner, or curl ... | sh -s -- --force to pass the flag through). They also sweep leftover temp files from an install/upgrade that was interrupted mid-way.

💡 Anything you customised at install time (GVSN_DIR, GVSN_INSTALL_DIR) should be set the same way before uninstalling, so the script cleans the right locations.

⚡ Quick Start

# 📥 Install the latest stable Go release
gvsn install latest

# 🌍 Activate it globally
gvsn use latest

# 🔍 Check the active version
gvsn current

# 📌 Pin a version for the current project
gvsn local 1.22

# ⚡ Run tests with a different version, without changing the global default
gvsn exec 1.21 go test ./...

📖 Commands

📥 `gvsn install <version>`

Downloads and installs a Go release from go.dev. The archive is verified against the official SHA-256 checksum before extraction.

gvsn install latest          # 🆕 latest stable release
gvsn install 1.22            # 🔢 latest patch of Go 1.22
gvsn install 1.22.4          # 🎯 exact version
gvsn install 1.22.4 --force  # 🔄 reinstall even if already present

Download tuning:

gvsn install latest --retries 5     # retry up to 5 times on error
gvsn install latest --retries 0     # fail immediately on first error

Flag	Default	Description
`--retries <N>`	`3`	Max retry attempts on network failure. Uses exponential back-off (1 s, 2 s, 4 s, …).

💡 If a download is interrupted (network drop, Ctrl-C), re-running the same gvsn install command resumes from the last byte written - no data is re-downloaded.

🔨 `gvsn build <version>`

Compiles a Go release directly from the official source tarball (go<X>.<Y>.<Z>.src.tar.gz). The resulting toolchain is installed into ~/.gvsn/versions/ alongside any binaries installed with gvsn install. Uses src/make.bash on Linux/macOS and src/make.bat on Windows.

gvsn build 1.24.0               # build an exact release
gvsn build 1.24                 # build the latest patch of Go 1.24
gvsn build latest               # build the latest stable release
gvsn build 1.24.0 --force       # rebuild even if already installed

Stream every compiler line in real time (recommended for long builds):

gvsn build 1.24.0 -v

Without -v, gvsn shows a spinner with the current build phase and prints the last 100 lines automatically if the build fails. With -v, every line from make.bash/make.bat is printed as it is produced:

  ⠸  Building packages and commands...  0:02:34
  │  go tool compile -std -trimpath ...
  │  go tool compile -std -trimpath ...

Disable CGO (faster build, no C toolchain needed):

gvsn build 1.24.0 --no-cgo

Set a custom bootstrap compiler (must be already installed via gvsn):

gvsn build 1.24.0 --bootstrap 1.22.6

Pass extra environment variables to make.bash:

gvsn build 1.24.0 --env GOAMD64=v3
gvsn build 1.24.0 --env GOAMD64=v3 --env CC=clang

Download tuning (source tarball and bootstrap download):

gvsn build 1.24.0 --retries 5    # retry up to 5 times on error

Bootstrap compiler

Go has been self-hosted since version 1.5 - compiling it from source requires a working Go installation as a bootstrap compiler. gvsn build resolves one automatically:

--bootstrap <version> - use a specific installed version (must be present via gvsn install)
Highest installed gvsn version - reused with no extra download
Auto-download - if no Go version is installed at all, gvsn downloads the latest patch of the previous minor as a temporary bootstrap and removes it after the build

Time and disk requirements

Building Go from source takes 5-15 minutes and requires approximately 3 GB of free disk space for the source tree, build artifacts, and final installation.

🎯 Choosing how to activate a version

gvsn offers four ways to switch versions, each with a different scope:

Command	Scope	Persisted where
`gvsn use` / `gvsn default`	Every shell, system-wide	`~/.gvsn/version`
`gvsn local`	This project (and anyone who clones it)	`.go-version` file in the project
`gvsn shell`	This terminal session only	Not persisted - lives only in the shell's environment

Resolution order when a new shell starts (or the shell hook re-checks): a gvsn shell session override wins if set, otherwise .go-version (walking up from the current directory) wins if found, otherwise the global default from gvsn use applies.

🌍 `gvsn use <version>` · `gvsn default <version>`

Sets the global default Go version. The version must already be installed.

gvsn use latest
gvsn use 1.22
gvsn use 1.22.4

💡 The change takes effect in any new terminal session, or immediately after reloading your profile.

📌 `gvsn local <version>`

Writes a .go-version file in the current directory. gvsn reads this file on every shell startup and activates the pinned version automatically.

# In your project root:
gvsn local 1.21.9

The file contains a plain version string (go1.21.9) and can be committed to version control so every contributor uses the same toolchain.

⚠️ If the pinned version is not installed, gvsn prints a warning and falls back to the global default.

🆕 gvsn local latest writes the literal string latest to .go-version instead of resolving it to a specific version. This means the pin tracks the current stable release over time rather than freezing on whatever was newest when you ran the command - different from gvsn local 1.22 or gvsn local 1.22.4, which always pin an exact, unchanging version.

🐚 `gvsn shell [version] [--unset]`

Activates a Go version for the current terminal session only - no files are written, nothing is persisted. Closing the terminal (or running --unset) reverts to whatever .go-version or the global default says.

gvsn shell 1.21        # 🎯 activate 1.21 for this session only
gvsn shell --unset     # ↩️  revert to the file-based version

Requires the shell wrapper injected by gvsn setup to take effect immediately in the current shell. Without it, run eval "$(gvsn shell 1.21)" manually.

🗑️ `gvsn uninstall <version> [--force]`

Removes an installed Go version from disk. Refuses to remove the currently active version. Asks for confirmation unless --force is passed.

gvsn uninstall 1.21.9
gvsn uninstall 1.21.9 --force   # 🔇 skip the confirmation prompt

🧹 `gvsn prune [--force] [--dry-run] [--scan-dir <path>]`

Removes installed Go versions that are no longer referenced by anything gvsn knows about, freeing disk space without you having to track down stale toolchains by hand.

A version counts as referenced when it matches the global default, or appears in a .go-version file found by walking up from the current directory (or found while scanning --scan-dir, up to 5 levels deep). Everything else is offered for removal.

gvsn prune                       # 🔍 shows what would be removed, asks for confirmation
gvsn prune --dry-run             # 👀 preview only, nothing is deleted
gvsn prune --force                # 🔇 skip the confirmation prompt
gvsn prune --scan-dir ~/projects  # 📂 also check .go-version files under this directory

📋 `gvsn list`

Lists all locally installed Go versions. The active version is highlighted.

  go1.23.0  (active)
  go1.22.4
  go1.21.9

🌐 `gvsn list-remote`

Lists stable Go versions available for download from go.dev.

gvsn list-remote          # 📄 latest patch per minor (compact view)
gvsn list-remote --all    # 📜 every patch release

Already-installed versions are marked with ✓.

📈 `gvsn outdated`

Checks every installed Go version against go.dev and reports whether a newer patch release exists for the same major.minor line.

gvsn outdated

  Installed      Latest patch   Status
  ----------------------------------------------------
  go1.22.4       go1.22.4       ✓  up to date
  go1.21.6       go1.21.9       ⚠  3 patches behind

🔍 `gvsn current`

Prints the active Go version and where it came from.

go1.22.4  (local .go-version)

or

go1.23.0  (global)

📂 `gvsn path [version]`

Prints the bin/ directory of the active (or specified) version. Useful for scripting.

gvsn path              # active version
gvsn path 1.21         # specific version
export GOROOT=$(dirname $(gvsn path))

🐚 `gvsn env [--shell <name>]`

Emits shell commands that set PATH and GOROOT for the active version. This is what the shell hook calls on every prompt.

eval "$(gvsn env)"               # 🔍 auto-detect shell
gvsn env --shell bash
gvsn env --shell zsh
gvsn env --shell fish

# 🪟 PowerShell
gvsn env --shell powershell | Out-String | Invoke-Expression

🔧 `gvsn setup [--shell <name>] [--reset]`

Performs all environment configuration for gvsn. The install scripts run this automatically; you only need it manually after moving the binary, changing your shell, or troubleshooting.

gvsn setup                    # auto-detect shell
gvsn setup --shell zsh        # configure a specific shell explicitly
gvsn setup --reset            # strip all previous gvsn config and re-apply cleanly
gvsn setup --shell bash --reset

What gvsn setup configures:

Platform	What it does
Linux / macOS	Injects `# gvsn init` + `# gvsn wrapper` into the interactive profile (`~/.bashrc`, `~/.zshrc`, etc.). Also injects a static `export PATH` line into the login profile (`~/.profile` for bash, `~/.zprofile` for zsh) so `~/.gvsn/current/bin` is visible to GUI apps (VSCode, GoLand, display managers) that don't source the interactive profile.
Windows	Injects `# gvsn init` + `# gvsn wrapper` into the PowerShell profile. Adds the gvsn binary directory and `~\.gvsn\current\bin` to the user `PATH` in the Windows registry (`HKCU\Environment`) so all apps - including GUI editors - see Go without requiring a shell session.

Shell validation: if --shell <name> is passed, gvsn checks that the shell is actually installed before writing anything. If not found, it exits with an error listing which shells are available on the system.

--reset flag: strips every # gvsn ... block from all managed profiles (and the Windows registry) and re-applies configuration from scratch. Only gvsn-managed content is touched - all other profile content is preserved.

Re-running gvsn setup without --reset is always safe - existing up-to-date blocks are left unchanged and stale ones are updated automatically.

⚡ `gvsn exec <version> <command> [args…]`

Runs any command with a specific Go version injected into PATH and GOROOT, without changing the global default.

# 🏗️ Build with Go 1.21 while Go 1.22 is the global default
gvsn exec 1.21 go build ./...

# 🧪 Run tests on multiple versions in CI
gvsn exec 1.20 go test ./...
gvsn exec 1.21 go test ./...
gvsn exec 1.22 go test ./...

# 🔍 Check the exact Go binary
gvsn exec 1.22.4 go version

The exit code of the subprocess is forwarded to the calling process.

🩺 `gvsn doctor [--shell <name>]`

Checks your gvsn installation and reports issues with actionable hints:

🔍 gvsn binary is in PATH
🌍 A global Go version is set
💾 The global version is installed on disk
📂 GOROOT resolves to a valid directory
🐚 The gvsn env hook is present in the shell profile
📌 The local .go-version (if any) is installed

gvsn doctor
gvsn doctor --shell zsh

Exits with code 1 if any issue is found - perfect for CI health checks.

🔄 `gvsn upgrade [--force]`

Self-updates gvsn to the latest release published on GitHub.

gvsn upgrade              # 🔍 check and update if a newer version exists
gvsn upgrade --force      # 🔄 reinstall the latest even if already up to date
gvsn upgrade --retries 5  # retry up to 5 times on error

🔒 On Unix the replacement is atomic (same-filesystem rename). On Windows the old binary is renamed first to free its name, then the new binary takes the original path. A rollback is attempted automatically if the replacement fails.

🔔 gvsn also checks for updates passively in the background after most commands (cached for 24h, never adds noticeable delay) and prints a short notice when a newer version is available. It never runs for env/path/shell/completions (called on every shell prompt) or upgrade itself. Disable it entirely with GVSN_NO_UPDATE_CHECK=1; it's also automatically skipped when CI is set.

💣 `gvsn implode [--force]`

Completely removes gvsn and everything it manages from the system.

gvsn implode           # 🗑️ shows a summary, asks for confirmation
gvsn implode --force   # 💥 removes everything immediately, no questions asked

What gets removed:

📁 The entire ~/.gvsn/ data directory (all installed Go versions)
🔧 The gvsn binary itself
🐚 Every gvsn-managed line from your interactive shell profile (~/.bashrc, ~/.zshrc, PowerShell profile, etc.)
🔑 The static PATH entry from your login profile (~/.profile, ~/.zprofile) on Linux/macOS
🗝️ The gvsn entries from the Windows user PATH registry key (HKCU\Environment) on Windows

⚠️ This operation is irreversible. Your installed Go versions will be deleted. Use gvsn upgrade instead if you just want to update.

🩹 If the gvsn binary is broken or already gone, use the standalone uninstaller script instead (see Uninstallation near the top of this README) - it does not depend on gvsn itself.

🏁 `gvsn completions <shell>`

Prints a shell completion script to stdout.

# 🐧 Bash
gvsn completions bash > ~/.local/share/bash-completion/completions/gvsn

# 🐚 Zsh
gvsn completions zsh > "${fpath[1]}/_gvsn"

# 🐟 Fish
gvsn completions fish > ~/.config/fish/completions/gvsn.fish

# 🪟 PowerShell
gvsn completions powershell >> $PROFILE

🔢 Version Syntax

All commands that accept a version support these forms:

Input	Meaning
`latest`	🆕 Newest stable release
`1.22`	🔢 Latest installed patch of Go 1.22
`1.22.4`	🎯 Exact version go1.22.4
`go1.22.4`	✅ Same as `1.22.4` (prefix accepted)

📌 Per-project Versions

Place a .go-version file in any directory:

go1.22.4

gvsn walks up the directory tree from the current working directory (up to 20 levels) looking for .go-version. When found, it takes precedence over the global default.

🔗 The file is compatible with other tools such as goenv and the VS Code Go extension.

🐚 Shell Integration

After running gvsn setup, two things are configured in your shell:

1. Interactive profile - the gvsn env hook, injected once by gvsn setup:

Shell	Profile file	Hook
🐧 Bash	`~/.bashrc`	`eval "$(gvsn env --shell bash)"`
🐚 Zsh	`~/.zshrc`	`eval "$(gvsn env --shell zsh)"`
🐟 Fish	`~/.config/fish/config.fish`	`gvsn env --shell fish \| source`
🪟 PowerShell	`~/Documents/PowerShell/profile.ps1`	`gvsn env --shell powershell \| Out-String \| Invoke-Expression`

On every new interactive shell session the hook:

🔍 Reads the active version (.go-version → global default)
➕ Prepends the version's bin/ directory to PATH
📂 Sets GOROOT to the version's root directory

2. Login profile / registry - a static PATH entry so GUI apps find Go:

Platform	Where	What
🐧 Linux (bash)	`~/.profile`	`export PATH="$HOME/.gvsn/current/bin:$PATH"`
🐚 Linux (zsh)	`~/.zprofile`	`export PATH="$HOME/.gvsn/current/bin:$PATH"`
🪟 Windows	`HKCU\Environment`	gvsn dir + `~\.gvsn\current\bin` added to user PATH

This login profile entry is what makes go visible to VSCode, GoLand, and other GUI editors that launch outside of an interactive shell session.

🔇 No daemons, no background processes, no side effects.

⚙️ Configuration

Variable	Default	Description
`GVSN_DIR`	`~/.gvsn`	📁 Root directory for all gvsn data
`GVSN_NO_UPDATE_CHECK`	unset	🔕 Set to disable the background update notice

📂 Directory layout

~/.gvsn/
|-- version          # active global version (plain text)
|-- current -> versions/go1.23.0/   # symlink/junction updated by gvsn use
|-- versions/
|   |-- go1.22.4/    # extracted Go toolchain
|   |   |-- bin/
|   |   |-- src/
|   |   `-- ...
|   `-- go1.23.0/
`-- tmp/             # download staging area (cleaned after install)

The current symlink (junction on Windows) always points to the active version. The login profile PATH entry points to ~/.gvsn/current/bin, which means GUI applications always see whichever version was last activated with gvsn use - no shell restart required.

🛠️ Building from Source

Requires Rust 1.75 or newer. No system dependencies - TLS is handled by rustls (pure Rust, no OpenSSL needed).

git clone https://github.com/jhonsferg/gvsn.git
cd gvsn
cargo build --release

The binary is placed at target/release/gvsn (or gvsn.exe on Windows).

# ✅ Run the self-check after building
./target/release/gvsn doctor

📦 Release Artifacts

Releases are automated via GitHub Actions. Pushing a version tag triggers cross-compilation for all supported targets:

Artifact	Target	Notes
`gvsn_windows_x86_64.zip`	`x86_64-pc-windows-msvc`	⚡ static binary (CRT)
`gvsn_windows_arm64.zip`	`aarch64-pc-windows-msvc`	⚡ static binary (CRT)
`gvsn_linux_x86_64.tar.gz`	`x86_64-unknown-linux-musl`	⚡ static binary
`gvsn_linux_aarch64.tar.gz`	`aarch64-unknown-linux-musl`	⚡ static binary
`gvsn_linux_armv7.tar.gz`	`armv7-unknown-linux-musleabihf`	⚡ static binary
`gvsn_linux_386.tar.gz`	`i686-unknown-linux-musl`	⚡ static binary
`gvsn_linux_riscv64.tar.gz`	`riscv64gc-unknown-linux-gnu`	links system glibc (no musl target)
`gvsn_linux_s390x.tar.gz`	`s390x-unknown-linux-gnu`	IBM Z - links system glibc
`gvsn_linux_ppc64le.tar.gz`	`powerpc64le-unknown-linux-gnu`	IBM POWER LE - links system glibc
`gvsn_android_aarch64.tar.gz`	`aarch64-linux-android`	🤖 Termux, links bionic
`gvsn_darwin_x86_64.tar.gz`	`x86_64-apple-darwin`	links libSystem (normal on macOS)
`gvsn_darwin_aarch64.tar.gz`	`aarch64-apple-darwin`	🍎 Apple Silicon, links libSystem

Each release also includes checksums.txt with SHA-256 hashes for all artifacts, plus SBOM files in CycloneDX and SPDX formats.

Releases are created automatically: every merge to main that passes CI triggers the auto-tag-and-release job, which bumps the version based on conventional commit prefixes (feat -> minor, fix -> patch) and dispatches the release build.

🔒 Verifying you're on the real project

Only trust downloads that come from GitHub Releases on this exact repository: https://github.com/jhonsferg/gvsn/releases

Do not trust:

Download buttons or "release" links that point to a raw file inside a repo tree (e.g. .../raw/refs/heads/main/...) instead of the Releases page.
Copies of this project hosted under a different GitHub account, even if the name, README, or commit history look identical - clones are not maintained by us and are not covered by this project's security process.
Any instructions telling you to bypass a Windows SmartScreen, macOS Gatekeeper, or antivirus warning to run a gvsn binary. Legitimate releases are checksummed (checksums.txt) and do not require disabling OS protections.

This project's real binaries are always built by the release.yml GitHub Action in this repository and shipped with SHA-256 checksums and SBOM files - never as a standalone .zip/.exe committed directly into source control.

If you find a copy of this project distributing something other than the source in this repository (especially compiled binaries not produced by our CI), please report it - see SECURITY.md.

🛡️ If your antivirus or Windows Defender flags a genuine release from this repository, that's a false positive, not a compromised download - see SECURITY.md for why this happens and what to do.

📄 License

MIT - see LICENSE.

Made with 🦀 Rust · Maintained with ❤️

Name		Name	Last commit message	Last commit date
.cargo		.cargo
.github		.github
assets/images		assets/images
benches		benches
docs/security		docs/security
install		install
src		src
.gitattributes		.gitattributes
.gitignore		.gitignore
.rustfmt.toml		.rustfmt.toml
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Cross.toml		Cross.toml
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
rust-toolchain.toml		rust-toolchain.toml

Latest commit

History

Folders and files

Repository files navigation

gvsn - Go Version Manager

✨ What makes gvsn different?

🦀 Why Rust, not Go?

🚀 Features

📦 Installation

🪟 Windows (PowerShell)

🐧 Linux and 🍎 macOS

📂 Custom install directory

✅ Verify the installation

🗑️ Uninstallation

⚡ Quick Start

📖 Commands

📥 gvsn install <version>

🔨 gvsn build <version>

Bootstrap compiler

Time and disk requirements

🎯 Choosing how to activate a version

🌍 gvsn use <version> · gvsn default <version>

📌 gvsn local <version>

🐚 gvsn shell [version] [--unset]

🗑️ gvsn uninstall <version> [--force]

🧹 gvsn prune [--force] [--dry-run] [--scan-dir <path>]

📋 gvsn list

🌐 gvsn list-remote

📈 gvsn outdated

🔍 gvsn current

📂 gvsn path [version]

🐚 gvsn env [--shell <name>]

🔧 gvsn setup [--shell <name>] [--reset]

⚡ gvsn exec <version> <command> [args…]

🩺 gvsn doctor [--shell <name>]

🔄 gvsn upgrade [--force]

💣 gvsn implode [--force]

🏁 gvsn completions <shell>

🔢 Version Syntax

📌 Per-project Versions

🐚 Shell Integration

⚙️ Configuration

📂 Directory layout

🛠️ Building from Source

📦 Release Artifacts

🔒 Verifying you're on the real project

📄 License

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

📥 `gvsn install <version>`

🔨 `gvsn build <version>`

🌍 `gvsn use <version>` · `gvsn default <version>`

📌 `gvsn local <version>`

🐚 `gvsn shell [version] [--unset]`

🗑️ `gvsn uninstall <version> [--force]`

🧹 `gvsn prune [--force] [--dry-run] [--scan-dir <path>]`

📋 `gvsn list`

🌐 `gvsn list-remote`

📈 `gvsn outdated`

🔍 `gvsn current`

📂 `gvsn path [version]`

🐚 `gvsn env [--shell <name>]`

🔧 `gvsn setup [--shell <name>] [--reset]`

⚡ `gvsn exec <version> <command> [args…]`

🩺 `gvsn doctor [--shell <name>]`

🔄 `gvsn upgrade [--force]`

💣 `gvsn implode [--force]`

🏁 `gvsn completions <shell>`