GoVMR - Go Version Manager (Rust Edition)
WIP - Current version is still a prototype
🎬 Demo
Quick preview of key features:
- Dashboard: Browsing versions
- Theme Picker: Browse all 8 themes with live preview
- Logs & Config: Automatic logging and persistent settings
📦 Dashboard & Installation
Browsing available versions
Color Theme Picker
Live preview of all 8 themes - arrows to browse, Enter to apply
Logs and Config
Automatic logging and persistent settings in ~/.govmr/
⚡ All demos are under 500KB for fast loading
Features
- Blazing Fast & Lightweight: Zero external runtime dependencies; compiled directly to a standalone native binary.
- Asynchronous Network & Streaming: Concurrent downloads and in-memory archive extraction using Tokio, Reqwest, Flate2, and Tar/Zip.
- Interactive TUI: A modern Ratatui dashboard with:
- Live download progress modal — animated gauge with percent, downloaded/total size, speed and ETA, followed by a dedicated "extracting" phase.
- Live version search/filter, tab counts, archive sizes, and stable/rc badges.
- Animated braille spinners for every background task (refresh, switch, delete, install).
- Rounded-corners theme, branded header showing the active version, and an inline PATH-setup help overlay (
h). - Keyboard navigation (vim keys + arrows).
- Selectable color themes: Eight built-in schemes — Go Cyan (default), Midnight (dark indigo), Matrix
Green, Amber Glow, Nord, Dracula, Light (bright high-contrast), and Monochrome. Press
Tin the TUI to open a picker with a live dashboard preview behind it (arrows/jkto move, number keys1–8for instant pick,Enterto save,Escto cancel). Your choice is stored as TOML in~/.govmr/config.tomland reloaded on every launch — or set it from the CLI withgovmr theme <name>. Change it again any time. (An old plain-text~/.govmr/configis migrated automatically.) - CLI progress bar:
govmr installshows a colored byte/speed/ETA bar that morphs into a spinner during extraction. - Smart version matching: Prefixes are resolved with proper semver component boundaries (
govmr use 1.22matches the latest1.22.x, never1.2or1.220); prerelease queries like1.24rc1require an exact pre-release match. - Non-Destructive Version Switching: Uses executable shims (
~/.govmr/shim) to instantly switch active versions without modifying global binary paths. - Cross-Platform: Full support for Linux, macOS, and Windows.
- Operation log: every fetch/install/switch/delete/theme change is appended to
~/.govmr/govmr.log(UTC timestamps, 1 MiB rotation). PressLin the TUI to open a live, color-coded log viewer — your post-mortem trail when the TUI owns the screen and stdout is unusable.
Installation
Quick Install (Linux / macOS)
|
To install a specific version:
|
Quick Install (Windows)
Open PowerShell and run:
irm https://raw.githubusercontent.com/seyallius/govmr/main/install.ps1 | iex
To install a specific version:
iex "& { $(irm https://raw.githubusercontent.com/seyallius/govmr/main/install.ps1) } -Version v0.1.8"
Pre-built Binary (via Cargo Binstall)
# Install cargo-binstall first if you haven't
# Then install govmr instantly
From crates.io (Compile from source)
From Source
Ensure you have Rust and Cargo installed:
Move the compiled binary to your PATH:
# On Linux / macOS
# On Windows
Shell Configuration (First-Time Setup)
GoVMR uses executable shims located in ~/.govmr/shim. Add this directory to your shell configuration so go
resolves through GoVMR. A guided setup screen appears automatically the first time you run the TUI, and you can re-open
it any time with h.
Linux & macOS
Add the following to your ~/.bashrc, ~/.zshrc, or equivalent shell profile:
Reload your environment:
Windows (PowerShell)
Run the following script in PowerShell to safely add the shim to your permanent User PATH and your current session (avoids the 1024-character truncation bug of setx):
$s = "$env:USERPROFILE\.govmr\shim"
$u = [Environment]::GetEnvironmentVariable("PATH", "User")
if ($u -notlike "*$s*") { [Environment]::SetEnvironmentVariable("PATH", "$u;$s", "User") }
if ($env:PATH -notlike "*$s*") { $env:PATH += ";$s" }
If you use CMD, you can add the path manually via System Properties → Advanced → Environment Variables. Restart your terminal session to apply changes.
Usage
Interactive TUI
Launch the full interactive TUI by executing govmr without subcommands:
Keybindings
| Key | Action |
|---|---|
↑ / k |
Move selection up |
↓ / j |
Move selection down |
Tab / t |
Switch between Available and Installed views |
/ |
Open the live search/filter (type, then Enter to apply, Esc to clear) |
i |
Download and install the selected version (shows the progress modal) |
u |
Switch the active Go version to the selected release |
d |
Delete the selected installed version (asks for confirmation) |
r |
Refresh the remote version manifest from go.dev |
T |
Open the color-theme picker (arrows to preview, Enter to save) |
L |
Toggle the docked operation-log panel (bottom, IDE-style) |
` |
Focus/unfocus the log panel (j/k scroll, f follow, w wrap) |
h / ? |
Open the PATH-setup help overlay |
q / Ctrl+C |
Exit GoVMR |
CLI Commands
# Install a specific or partial Go release (with a live download progress bar)
# Switch active Go version
# List installed versions and show the current active version
# Delete an installed Go release
# List available color themes / switch permanently
# Show help options
Architecture Overview
src/manager.rs: Core orchestrator managing remote version manifests, asynchronous streaming (withInstallProgressevents for download speed/ETA and extraction phase), decompression, and disk persistence.src/shim.rs: Manages shell wrappers inside~/.govmr/shimto forward execution to the currently active Go binary.src/tui/: Terminal UI —views.rs(dashboard, lists, modals, gauges, theme picker) andsetup.rs(onboarding / help overlay) — via Ratatui.src/theme.rs: The eight color schemes;src/config.rspersists preferences to~/.govmr/config.toml.src/cli.rs: Subcommand definitions and execution pathways using Clap and Indicatif.
Testing
Headless rendering tests draw every screen state (tabs, filter, install/extraction modals, delete confirmation, PATH warning) into an in-memory buffer: