Skip to content

docs: improve clarity on uvx and pipx dependencies#7878

Merged
jdx merged 3 commits into
jdx:mainfrom
ygormutti:patch-1
Feb 1, 2026
Merged

docs: improve clarity on uvx and pipx dependencies#7878
jdx merged 3 commits into
jdx:mainfrom
ygormutti:patch-1

Conversation

@ygormutti

@ygormutti ygormutti commented Jan 28, 2026

Copy link
Copy Markdown
Contributor

The doc itself recognizes the backend being named pipx and using uvx by default is confusing, and this confuses me in regards to how uvx <-> mise <-> pipx interact, so I keep forgetting and coming back to this doc.

Today I realized I don't even need pipx anymore. This is an attempt to improve this part.

Clarified dependencies by adding information about `uvx` and its relation to `pipx`. Updated installation instructions for `pipx`.
Clarified the installation requirements for `uvx` and `pipx`, emphasizing that `uvx` is recommended and that it is installed with `uv`. Updated wording for better clarity on usage and installation.
Comment thread docs/dev-tools/backends/pipx.md Outdated
This relies on having `pipx` installed. You can install it with or without mise.
This relies on having `uvx` (recommended) or `pipx` installed.

If you have `uv` installed, `uvx` is installed along with it and you don't need to install `pipx` to run the commands containing "pipx:".

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we actually even use uvx? I think we technically use uv install

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Didn't, but since the docs already mention uvx instead of uv install I mentioned it for consistence and to minimize changes.

PS: sorry for the delay answering, and thanks for accepting the PR!

@jdx

jdx commented Jan 28, 2026

Copy link
Copy Markdown
Owner

bugbot run

@jdx

jdx commented Jan 29, 2026

Copy link
Copy Markdown
Owner

bugbot run verbose=true

@cursor

cursor Bot commented Jan 29, 2026

Copy link
Copy Markdown

Bugbot request id: serverGenReqId_a5571acb-f5ae-4aa8-ba29-0c14580de4fa

The pipx backend actually runs `uv tool install` under the hood,
not `uvx`. Update the documentation to be accurate.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jdx jdx merged commit 8396bb5 into jdx:main Feb 1, 2026
38 checks passed
mise-en-dev added a commit that referenced this pull request Feb 1, 2026
### 🚀 Features

- **(edit)** add interactive config editor (`mise edit`) by @jdx in
[#7930](#7930)
- **(lockfile)** graduate lockfiles from experimental by @jdx in
[#7929](#7929)
- **(task)** add support for usage values in task confirm dialog by
@roele in [#7924](#7924)
- **(task)** improve source freshness checking with edge case handling
by @jdx in [#7932](#7932)

### 🐛 Bug Fixes

- **(activate)** preserve ordering of paths appended after mise activate
by @jdx in [#7919](#7919)
- **(install)** sort failed installations for deterministic error output
by @jdx in [#7936](#7936)
- **(lockfile)** preserve URL and prefer sha256 when merging platform
info by @jdx in [#7923](#7923)
- **(lockfile)** add atomic writes and cache invalidation by @jdx in
[#7927](#7927)
- **(templates)** use sha256 for hash filter instead of blake3 by @jdx
in [#7925](#7925)
- **(upgrade)** respect tracked configs when pruning old versions by
@jdx in [#7926](#7926)

### 🚜 Refactor

- **(progress)** migrate from indicatif to clx by @jdx in
[#7928](#7928)

### 📚 Documentation

- improve clarity on uvx and pipx dependencies by @ygormutti in
[#7878](#7878)

### ⚡ Performance

- **(install)** use Kahn's algorithm for dependency scheduling by @jdx
in [#7933](#7933)
- use Aho-Corasick for efficient redaction by @jdx in
[#7931](#7931)

### 🧪 Testing

- remove flaky test_http_version_list test by @jdx in
[#7934](#7934)

### Chore

- use github backend instead of ubi in mise.lock by @jdx in
[#7922](#7922)

### New Contributors

- @ygormutti made their first contribution in
[#7878](#7878)
lucasew pushed a commit to lucasew/CONTRIB-mise that referenced this pull request Feb 18, 2026
The doc itself recognizes the backend being named `pipx` and using `uvx`
by default is confusing, and this confuses me in regards to how uvx <->
mise <-> pipx interact, so I keep forgetting and coming back to this
doc.

Today I realized I don't even need pipx anymore. This is an attempt to
improve this part.

---------

Co-authored-by: jdx <216188+jdx@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
lucasew pushed a commit to lucasew/CONTRIB-mise that referenced this pull request Feb 18, 2026
### 🚀 Features

- **(edit)** add interactive config editor (`mise edit`) by @jdx in
[jdx#7930](jdx#7930)
- **(lockfile)** graduate lockfiles from experimental by @jdx in
[jdx#7929](jdx#7929)
- **(task)** add support for usage values in task confirm dialog by
@roele in [jdx#7924](jdx#7924)
- **(task)** improve source freshness checking with edge case handling
by @jdx in [jdx#7932](jdx#7932)

### 🐛 Bug Fixes

- **(activate)** preserve ordering of paths appended after mise activate
by @jdx in [jdx#7919](jdx#7919)
- **(install)** sort failed installations for deterministic error output
by @jdx in [jdx#7936](jdx#7936)
- **(lockfile)** preserve URL and prefer sha256 when merging platform
info by @jdx in [jdx#7923](jdx#7923)
- **(lockfile)** add atomic writes and cache invalidation by @jdx in
[jdx#7927](jdx#7927)
- **(templates)** use sha256 for hash filter instead of blake3 by @jdx
in [jdx#7925](jdx#7925)
- **(upgrade)** respect tracked configs when pruning old versions by
@jdx in [jdx#7926](jdx#7926)

### 🚜 Refactor

- **(progress)** migrate from indicatif to clx by @jdx in
[jdx#7928](jdx#7928)

### 📚 Documentation

- improve clarity on uvx and pipx dependencies by @ygormutti in
[jdx#7878](jdx#7878)

### ⚡ Performance

- **(install)** use Kahn's algorithm for dependency scheduling by @jdx
in [jdx#7933](jdx#7933)
- use Aho-Corasick for efficient redaction by @jdx in
[jdx#7931](jdx#7931)

### 🧪 Testing

- remove flaky test_http_version_list test by @jdx in
[jdx#7934](jdx#7934)

### Chore

- use github backend instead of ubi in mise.lock by @jdx in
[jdx#7922](jdx#7922)

### New Contributors

- @ygormutti made their first contribution in
[jdx#7878](jdx#7878)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants