This version includes the Scalar CLI!
In this version, we have completed porting all Scalar features into the microsoft/git fork, and many of the features are also in the core git/git project:
- Background maintenance is in
git/git. - FS Monitor is in
microsoft/gitandgit-for-windows/gitwith agit/gitversion under review. - The GVFS Protocol (i.e. partial clone for Azure Repos) is built into
microsoft/gitvia thegit-gvfs-helperexecutable. - The Scalar CLI for creating and managing enlistments is now in
microsoft/git.
The Scalar CLI documentation is available in this repository, and closely matches the functionality documented in microsoft/scalar.
Users should not notice any behavior differences between Scalar.NET and this new version, since this does not affect your day-to-day use of Git commands. Any issues are likely to happen in commands such as scalar clone or scalar register or during the installation itself.
Instructions for Windows Users
The Windows installer will uninstall Scalar.NET, if it exists, and update existing enlistments to be registered with this new version. If in doubt, run scalar list before and after upgrading to ensure the list is correct. If any enlistments are missing, then run scalar register . in the working directory of an enlistment you want registered.
Instructions for macOS Users
Warning: The macOS installer will not uninstall the existing Scalar.NET installation.
Before uninstalling the .NET version, run scalar list and store that list of enlistments in a file.
If you had Scalar.NET installed via HomeBrew, then you can use this command:
brew uninstall --cask scalar-azrepos
If you installed in another way, then run this script to uninstall the .NET version:
/usr/local/bin/uninstall_scalar.sh
After running the macOS installer, you will need to run scalar register . in your existing enlistments to ensure they are tracked by background maintenance and other changes in future versions. You can also run scalar register <path> for each <path> that was previously output by scalar list.
Instructions for Linux Users
The Linux installer will not uninstall the existing Scalar.NET installation, but it will replace the location of the scalar executable on the PATH. There is no established uninstall mechanism, but Scalar.NET can be removed via sudo rm -rf /usr/local/lib/scalar/.
After running the Linux installer (or compiling and installing from source), you will need to run scalar register . in your existing enlistments to ensure they are tracked by background maintenance and other changes in future versions.