Overview
Start here for installation flows, CLI behavior, plugin concepts, and workspace details.
vs is a Rust workspace for a cross-platform runtime version manager inspired by vfox.
vs is organized around a few core workflows:
Guides
Walk through first-run setup, configuration, and migration from older homes.
Reference
Understand the command surface, shell activation, PATH planning, and compatibility files.
Plugins
Compare the Lua and native plugin tracks and see how both expose the same lifecycle.
Project
Review the workspace structure, crate responsibilities, and implementation boundaries.
Current implementation notes
Examples use the current repository layout and command surface from vs-cli. When a behavior is still evolving, the page calls it out explicitly.
Recommended path
- Read Quick Start to build the CLI and activate your first tool.
- Review Configuration to understand home paths, config files, and precedence.
- Keep CLI Commands open while working with the tool.
- Dive into Plugins and Project Overview if you plan to extend
vs.
What makes vs different
- A multi-crate Rust workspace with explicit boundaries between CLI, orchestration, config, registry, installer, plugins, and shell integration.
- Compile-time backend selection for Lua plugins, native WASI-style plugins, or both.
- Scope-aware version activation for projects, sessions, and global use.
- A repository implementation that keeps the CLI, orchestration, config, plugins, installer, and shell logic in explicit crate boundaries.