docs: add uv alternatives to install instructions

Author: tony

CHANGES

@@ -8,6 +8,18 @@ To install the unreleased tmuxp version, see [developmental releases](https://tm
 $ pip install --user --upgrade --pre tmuxp
 ```
 
+[uv](https://docs.astral.sh/uv/getting-started/features/#python-versions):
+
+```console
+$ uv add 'tmuxp>=1.10.0b1'
+```
+
+[uvx](https://docs.astral.sh/uv/guides/tools/):
+
+```console
+$ uvx --from 'tmuxp>=1.10.0b1' tmuxp
+```
+
 [pipx](https://pypa.github.io/pipx/docs/):
 
 ```console
@@ -1493,6 +1505,24 @@ This will be the last Python 2.7 release of tmuxp. Bug fixes for python
 
   ```
 
+  Inside a [uv](https://docs.astral.sh/uv/getting-started/features/#python-versions)
+  project you can add `ipdb` as a development dependency instead:
+
+  ```{code-block} sh
+
+  $ uv add --dev ipdb
+
+  ```
+
+  For a pipx-style ad hoc execution, reach for
+  [uvx](https://docs.astral.sh/uv/guides/tools/):
+
+  ```{code-block} sh
+
+  $ uvx --from ipdb ipdb3 --help
+
+  ```
+
   You can execute python directly via `-c`:
 
   ```{code-block} sh

README.md

@@ -24,6 +24,19 @@ pip:
 $ pip install --user tmuxp
 ```
 
+If you're managing the project with [uv](https://docs.astral.sh/uv/), add tmuxp as a dependency instead:
+
+```console
+$ uv add tmuxp
+```
+
+To run tmuxp without installing it globally, similar to `pipx`, invoke it with
+[uvx](https://docs.astral.sh/uv/guides/tools/):
+
+```console
+$ uvx tmuxp
+```
+
 Homebrew:
 
 ```console
@@ -52,6 +65,19 @@ Developmental releases:
   pip install --user --upgrade --pre tmuxp
   ```
 
+  Or request the pre-release from a uv project environment:
+
+  ```console
+  uv add 'tmuxp>=1.10.0b1'
+  ```
+
+
+- [uvx](https://docs.astral.sh/uv/guides/tools/):
+
+  ```console
+  uvx tmuxp
+  ```
+
 - [pipx](https://pypa.github.io/pipx/docs/):
 
   ```console

docs/cli/completion.md

@@ -18,6 +18,18 @@ Provisional support for completions in tmuxp 1.17+ are powered by [shtab](https:
 $ pip install shtab --user
 ```
 
+With a [uv](https://docs.astral.sh/uv/getting-started/features/#python-versions) project you can add it directly as a development dependency:
+
+```console
+$ uv add --dev shtab
+```
+
+Or reach for [uvx](https://docs.astral.sh/uv/guides/tools/) when you want a pipx-style ephemeral install:
+
+```console
+$ uvx shtab --help
+```
+
 :::{tab} bash
 
 ```bash

docs/cli/shell.md

@@ -57,6 +57,18 @@ compatible debuggers, for instance [ipdb][ipdb]:
 $ pip install --user ipdb
 ```
 
+Inside a [uv](https://docs.astral.sh/uv/getting-started/features/#python-versions)-managed project you can add `ipdb` as a development dependency:
+
+```console
+$ uv add --dev ipdb
+```
+
+For a pipx-style ad hoc install, run it through [uvx](https://docs.astral.sh/uv/guides/tools/):
+
+```console
+$ uvx --from ipdb ipdb3 --help
+```
+
 ```console
 $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp shell
 ```

docs/developing.md

@@ -97,6 +97,21 @@ This has `pip`, a python package manager install the python package
 in the current directory. `-e` means `--editable`, which means you can
 adjust the code and the installed software will reflect the changes.
 
+When you manage dependencies with
+[uv](https://docs.astral.sh/uv/getting-started/features/#python-versions),
+add the checkout as an editable development dependency instead:
+
+```console
+$ uv add --dev --editable .
+```
+
+Prefer a one-off, pipx-style execution while you hack? Call tmuxp via
+[uvx](https://docs.astral.sh/uv/guides/tools/):
+
+```console
+$ uvx tmuxp
+```
+
 ```console
 $ tmuxp
 ```

docs/quickstart.md

@@ -10,12 +10,34 @@ Ensure you have at least tmux **>= 1.8** and python **>= 3.7**.
 $ pip install --user tmuxp
 ```
 
+If you're managing dependencies with [uv]_ inside a project environment,
+add tmuxp directly to your lockfile:
+
+```console
+$ uv add tmuxp
+```
+
+To run tmuxp without installing it globally—similar to what you'd do with
+`pipx`—invoke it via [uvx]_:
+
+```console
+$ uvx tmuxp
+```
+
 You can upgrade to the latest release with:
 
 ```console
 $ pip install --user --upgrade tmuxp
 ```
 
+Within a uv-managed project you can upgrade by refreshing the lockfile and
+syncing the environment:
+
+```console
+$ uv lock --upgrade-package tmuxp
+$ uv sync
+```
+
 Then install {ref}`completion`.
 
 If you are a Homebrew user you can install it with:
@@ -38,6 +60,18 @@ In their versions you will see notification like `a1`, `b1`, and `rc1`, respecti
   $ pip install --user --upgrade --pre tmuxp
   ```
 
+- [uv]_:
+
+  ```console
+  $ uv add 'tmuxp>=1.10.0b1'
+  ```
+
+- [uvx]_:
+
+  ```console
+  $ uvx --from 'tmuxp>=1.10.0b1' tmuxp
+  ```
+
 - [pipx]\:
 
   ```console
@@ -54,6 +88,18 @@ via trunk (can break easily):
   $ pip install --user -e git+https://github.com/tmux-python/tmuxp.git#egg=tmuxp
   ```
 
+- [uv]_:
+
+  ```console
+  $ uv add "tmuxp @ git+https://github.com/tmux-python/tmuxp.git@master"
+  ```
+
+- [uvx]_:
+
+  ```console
+  $ uvx --from "tmuxp @ git+https://github.com/tmux-python/tmuxp.git@master" tmuxp
+  ```
+
 - [pipx]\:
 
   ```console
@@ -62,6 +108,8 @@ via trunk (can break easily):
 
 [pip]: https://pip.pypa.io/en/stable/
 [pipx]: https://pypa.github.io/pipx/docs/
+[uv]: https://docs.astral.sh/uv/getting-started/features/#python-versions
+[uvx]: https://docs.astral.sh/uv/guides/tools/
 
 ## Commands