Merge pull request #2 from stepbeta/feat/add-convenience-flags

feat: add convenience flags to use and install commands

Author: stepbeta

.vscode/launch.json

@@ -11,11 +11,10 @@
             "mode": "debug",
             "program": "${workspaceFolder}/main.go",
             "args": [
-                "kubectl",
-                "list-remote",
-                // "--force",
-                // "--limit",
-                // "10"
+                "talosctl",
+                "use",
+                "v1.11.4",
+                "-i"
             ],
             "env": {
                 "GITHUB_TOKEN": "<my-token>"

docs/vrsr.md

@@ -9,9 +9,10 @@ A tool to easily install and use multiple versions of several tools.
 ### Options
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
   -h, --help              help for vrsr
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
@@ -24,4 +25,4 @@ A tool to easily install and use multiple versions of several tools.
 * [vrsr talosctl](vrsr_talosctl.md)	 - Manage talosctl versions
 * [vrsr version](vrsr_version.md)	 - vrsr tool version
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_completion.md

@@ -17,8 +17,9 @@ See each sub-command's help for details on how to use the generated script.
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
@@ -29,4 +30,4 @@ See each sub-command's help for details on how to use the generated script.
 * [vrsr completion powershell](vrsr_completion_powershell.md)	 - Generate the autocompletion script for powershell
 * [vrsr completion zsh](vrsr_completion_zsh.md)	 - Generate the autocompletion script for zsh
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_completion_bash.md

@@ -40,12 +40,13 @@ vrsr completion bash
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr completion](vrsr_completion.md)	 - Generate the autocompletion script for the specified shell
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_completion_fish.md

@@ -31,12 +31,13 @@ vrsr completion fish [flags]
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr completion](vrsr_completion.md)	 - Generate the autocompletion script for the specified shell
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_completion_powershell.md

@@ -28,12 +28,13 @@ vrsr completion powershell [flags]
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr completion](vrsr_completion.md)	 - Generate the autocompletion script for the specified shell
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_completion_zsh.md

@@ -42,12 +42,13 @@ vrsr completion zsh [flags]
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr completion](vrsr_completion.md)	 - Generate the autocompletion script for the specified shell
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_docs.md

@@ -15,12 +15,13 @@ vrsr docs [flags]
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr](vrsr.md)	 - (Almost) Universal tools versions manager
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_helm.md

@@ -15,8 +15,9 @@ A tool to easily install and use multiple versions of helm.
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
@@ -27,4 +28,4 @@ A tool to easily install and use multiple versions of helm.
 * [vrsr helm list-remote](vrsr_helm_list-remote.md)	 - List all remote helm versions from GitHub (sorted by semver)
 * [vrsr helm use](vrsr_helm_use.md)	 - Set the specified helm version as the active one
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026

docs/vrsr_helm_install.md

@@ -18,17 +18,19 @@ vrsr helm install <version> [flags]
 
 ```
   -h, --help   help for install
+  -u, --use    Immediately use the version once installed (best effort)
 ```
 
 ### Options inherited from parent commands
 
 ```
-  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/user/.vrsr/bin")
-  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/user/.vrsr/versions")
+  -b, --bin-path string   Absolute path to folder storing in-use tools binaries (default "/home/stefano/.vrsr/bin")
+      --config string     config file (default is $HOME/.vrsr/config.yaml)
+  -d, --vrs-path string   Absolute path to folder storing downloaded tools binary versions (default "/home/stefano/.vrsr/versions")
 ```
 
 ### SEE ALSO
 
 * [vrsr helm](vrsr_helm.md)	 - Manage helm versions
 
-###### Auto generated by spf13/cobra on 30-Dec-2025
+###### Auto generated by spf13/cobra on 19-Jan-2026