docs(installation): Add uv alternatives to pip install commands

why: Provide modern uv-based installation options alongside existing pip/pipx commands
what:
- Add uv tool install and uvx examples to all documentation files
- Include uv sync alternative in CLAUDE.md for development setup
- Add uv tool upgrade, --prerelease=allow, and --from git+ examples
- Verify all commands work correctly through testing

refs: Tested all commands successfully with uv 0.9.2

Author: tony

CLAUDE.md

@@ -22,6 +22,9 @@ vcspull is a Python tool for managing and synchronizing multiple git, svn, and m
 ```bash
 # Install development dependencies with uv
 uv pip install -e .
+
+# Alternative: Use uv sync to install from pyproject.toml
+uv sync
 ```
 
 ### Common Commands

README.md

@@ -29,6 +29,18 @@ See the [documentation](https://vcspull.git-pull.com/), [configuration](https://
 $ pip install --user vcspull
 ```
 
+Or using uv:
+
+```console
+$ uv tool install vcspull
+```
+
+For one-time use without installation:
+
+```console
+$ uvx vcspull
+```
+
 ### Developmental releases
 
 You can test the unpublished version of vcspull before its released.
@@ -47,6 +59,12 @@ You can test the unpublished version of vcspull before its released.
 
   Then use `vcspull@next sync [config]...`.
 
+- [uv](https://docs.astral.sh/uv/):
+
+  ```console
+  $ uv tool install --prerelease=allow vcspull
+  ```
+
 ## Configuration
 
 Add your repos to `~/.vcspull.yaml`.

docs/cli/completion.md

@@ -18,6 +18,18 @@ Provisional support for completions in vcspull 1.15+ are powered by [shtab](http
 $ pip install shtab --user
 ```
 
+Or using uv:
+
+```console
+$ uv tool install shtab
+```
+
+For one-time use without installation:
+
+```console
+$ uvx shtab
+```
+
 :::{tab} bash
 
 ```bash

docs/quickstart.md

@@ -10,12 +10,30 @@ For latest official version:
 $ pip install --user vcspull
 ```
 
+Or using uv:
+
+```console
+$ uv tool install vcspull
+```
+
+For one-time use without installation:
+
+```console
+$ uvx vcspull
+```
+
 Upgrading:
 
 ```console
 $ pip install --user --upgrade vcspull
 ```
 
+Or with uv:
+
+```console
+$ uv tool upgrade vcspull
+```
+
 (developmental-releases)=
 
 ### Developmental releases
@@ -38,6 +56,12 @@ In their versions you will see notification like `a1`, `b1`, and `rc1`, respecti
 
   Then use `vcspull@next sync [config]...`.
 
+- [uv]\:
+
+  ```console
+  $ uv tool install --prerelease=allow vcspull
+  ```
+
 via trunk (can break easily):
 
 - [pip]\:
@@ -52,8 +76,15 @@ via trunk (can break easily):
   $ pipx install --suffix=@master 'vcspull @ git+https://github.com/vcs-python/vcspull.git@master' --force
   ```
 
+- [uv]\:
+
+  ```console
+  $ uv tool install vcspull --from git+https://github.com/vcs-python/vcspull.git
+  ```
+
 [pip]: https://pip.pypa.io/en/stable/
 [pipx]: https://pypa.github.io/pipx/docs/
+[uv]: https://docs.astral.sh/uv/
 
 ## Configuration