docs(plugins): replace node/asdf-nodejs examples with vfox plugins by jdx · Pull Request #8191 · jdx/mise

jdx · 2026-02-16T21:50:04Z

Summary

Replace outdated node / asdf-nodejs references in plugin subcommand doc comments and CLI examples with cmake / poetry (vfox plugins from the registry)
Affects plugins install, plugins update, plugins uninstall, plugins link, plugins ls, and the top-level plugins command
Unit tests for URL parsing left unchanged as they test name extraction logic

Test plan

cargo check passes
All lints pass
Verify mise plugins install --help shows updated examples

🤖 Generated with Claude Code

Note

Low Risk
Mostly documentation/example updates; the only functional change is adding a vfox- prefix strip to plugin name inference, which is narrow and unlikely to affect existing users beyond improving URL/path inference.

Overview
Refreshes mise plugins documentation, manpage text, and shell-completion metadata to replace node/asdf-* examples with cmake/poetry and mise-plugins/vfox-* URLs across install, ls, link, update, and uninstall.

Extends plugin name inference to strip a vfox- prefix from plugin repo URLs and local plugin directory names (mirroring existing asdf-/rtx-/mise- handling).

^{Written by Cursor Bugbot for commit d6b4aff. This will update automatically on new commits. Configure here.}

Nobody uses asdf-nodejs anymore, so update the doc comments and CLI examples across all plugin subcommands to reference vfox plugins (cmake, poetry) from the registry instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

gemini-code-assist · 2026-02-16T21:50:18Z

Summary of Changes

Hello @jdx, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request modernizes the documentation and CLI examples for various mise plugins subcommands. The primary goal is to replace deprecated node and asdf-nodejs references with current vfox plugins like cmake and poetry, ensuring that users encounter up-to-date and relevant examples when interacting with the mise CLI. This change improves the user experience by providing accurate guidance for plugin management.

Highlights

Documentation Examples Updated: Replaced outdated node and asdf-nodejs references in plugin subcommand documentation comments and CLI examples with cmake and poetry (vfox plugins from the registry).
Affected Commands: Changes impact plugins install, plugins update, plugins uninstall, plugins link, plugins ls, and the top-level plugins command documentation.
URL Parsing Tests Unchanged: Unit tests for URL parsing logic were intentionally left unchanged as they test name extraction logic, not specific plugin examples.

Changelog

src/cli/plugins/install.rs
- Updated example plugin names and git URLs in PluginsInstall struct documentation.
- Modified the autoinstall example from node@20 to cmake@3.30.
src/cli/plugins/link.rs
- Updated example plugin names and local paths in PluginsLink struct documentation.
- Modified AFTER_LONG_HELP examples to reflect cmake and vfox-cmake.
src/cli/plugins/ls.rs
- Updated the example git URL for the urls flag.
- Modified AFTER_LONG_HELP examples to list cmake and poetry with their respective vfox URLs.
src/cli/plugins/mod.rs
- Updated the example git URL for the urls flag in the top-level Plugins command documentation.
src/cli/plugins/uninstall.rs
- Updated the AFTER_LONG_HELP example from mise uninstall node to mise uninstall cmake.
src/cli/plugins/update.rs
- Updated AFTER_LONG_HELP examples from node to cmake for plugin updates.

Activity

The author confirmed that cargo check passes.
All lints were confirmed to pass.
Verification of mise plugins install --help showing updated examples is pending.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

Copilot

Pull request overview

Updates CLI help text for the plugins subcommands to use vfox-registry plugin examples (e.g., cmake, poetry) instead of the older node / asdf-nodejs references, keeping the documentation aligned with current plugin recommendations.

Changes:

Updated plugins subcommand example snippets to reference cmake/poetry and vfox plugin URLs.
Updated --urls example URLs to use mise-plugins/vfox-* repositories.
Updated autoinstall example in plugins install docs to reference cmake.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/cli/plugins/update.rs	Updates `plugins update` help examples to use `cmake`.
src/cli/plugins/uninstall.rs	Updates `plugins uninstall` help example to use `cmake` (command wording still needs adjustment).
src/cli/plugins/mod.rs	Updates `--urls` doc example URL to a vfox plugin repo.
src/cli/plugins/ls.rs	Updates `plugins ls` example output and `--urls` example URLs to vfox plugin repos.
src/cli/plugins/link.rs	Updates `plugins link` docs/examples to use `vfox-cmake` paths (inference example currently mismatches code).
src/cli/plugins/install.rs	Updates `plugins install` docs/examples to use `cmake`/`poetry` and vfox plugin URL.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-16T21:52:35Z

src/cli/plugins/uninstall.rs

    r#"<bold><underline>Examples:</underline></bold>

-    $ <bold>mise uninstall node</bold>
+    $ <bold>mise uninstall cmake</bold>


The example shown in the plugin-uninstall help uses mise uninstall ..., which invokes the top-level tool-version uninstall command (see src/cli/mod.rs where Uninstall and Plugins are separate commands). Since this help is for removing plugins, the example should use mise plugins uninstall ... (or the appropriate alias) to avoid misleading users.

Suggested change

$ <bold>mise uninstall cmake</bold>

$ <bold>mise plugins uninstall cmake</bold>

Copilot · 2026-02-16T21:52:36Z

src/cli/plugins/link.rs

+    # essentially just `ln -s ./vfox-cmake ~/.local/share/mise/plugins/cmake`
+    $ <bold>mise plugins link cmake ./vfox-cmake</bold>

-    # infer plugin name as "node"
-    $ <bold>mise plugins link ./mise-node</bold>
+    # infer plugin name as "cmake"
+    $ <bold>mise plugins link ./vfox-cmake</bold>


The plugins link help says it will "infer plugin name as "cmake"" from the directory ./vfox-cmake, but get_name_from_path() only strips asdf-, rtx-, and mise- prefixes. With the current code this would infer vfox-cmake, not cmake. Either update the example to match the current inference behavior, or extend get_name_from_path() to also strip the vfox- prefix so the example works as written.

gemini-code-assist

Code Review

This pull request updates documentation and examples across several plugin-related commands, replacing outdated references to node and asdf-nodejs with more current examples like cmake and poetry. The changes are consistent and improve the documentation. I've found one minor issue in an example that could be misleading to users.

gemini-code-assist · 2026-02-16T21:53:44Z

src/cli/plugins/install.rs

-    /// e.g.: node, ruby
-    /// Can specify multiple plugins: `mise plugins install node ruby python`
+    /// e.g.: cmake, poetry
+    /// Can specify multiple plugins: `mise plugins install cmake poetry elixir`


The example for installing multiple plugins includes elixir, which is a core plugin. The plugins install command is for non-core plugins and will error if you try to install a core plugin. It would be better to use another non-core plugin in the example or remove elixir to avoid confusion.

Suggested change

/// Can specify multiple plugins: `mise plugins install cmake poetry elixir`

/// Can specify multiple plugins: `mise plugins install cmake poetry`

- Fix `plugins uninstall` example to use full `mise plugins uninstall` command - Remove `elixir` from multi-install example since it's a core plugin - Strip `vfox-` prefix in get_name_from_path() and get_name_from_url() so `./vfox-cmake` correctly infers plugin name as "cmake" Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

jdx · 2026-02-16T22:00:43Z

bugbot run

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

github-actions · 2026-02-16T22:21:35Z

Hyperfine Performance

`mise x -- echo`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.13 x -- echo`	24.0 ± 0.5	23.1	28.2	1.00
`mise x -- echo`	24.0 ± 0.5	23.3	28.6	1.00 ± 0.03

`mise env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.13 env`	24.1 ± 1.6	22.8	44.0	1.01 ± 0.07
`mise env`	23.9 ± 0.7	22.9	27.2	1.00

`mise hook-env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.13 hook-env`	24.7 ± 0.7	23.7	32.8	1.00
`mise hook-env`	24.9 ± 0.7	23.8	28.0	1.01 ± 0.04

`mise ls`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.13 ls`	22.9 ± 0.5	21.9	25.9	1.00
`mise ls`	23.0 ± 0.5	22.1	27.1	1.00 ± 0.03

`xtasks/test/perf`

Command	mise-2026.2.13	mise	Variance
install (cached)	130ms	132ms	-1%
ls (cached)	82ms	82ms	+0%
bin-paths (cached)	87ms	85ms	+2%
task-ls (cached)	839ms	831ms	+0%

@jdx

### 🚀 Features - **(task)** stream keep-order output in real-time per task by @jdx in [#8164](#8164) ### 🐛 Bug Fixes - **(aqua)** resolve lockfile artifacts for target platform (fix discussion #7479) by @mackwic in [#8183](#8183) - **(exec)** strip shims from PATH to prevent recursive shim execution by @jdx in [#8189](#8189) - **(hook-env)** preserve PATH reordering done after activation by @jdx in [#8190](#8190) - **(lockfile)** resolve version aliases before lockfile lookup by @jdx in [#8194](#8194) - **(registry)** set helm-diff archive bin name to diff by @jean-humann in [#8173](#8173) - **(task)** improve source freshness checks with dynamic task dirs by @rooperuu in [#8169](#8169) - **(task)** resolve global tasks when running from monorepo root by @jdx in [#8192](#8192) - **(task)** prevent wildcard glob `test:*` from matching parent task `test` by @jdx in [#8165](#8165) - **(task)** resolve task_config.includes relative to config root by @jdx in [#8193](#8193) - **(upgrade)** skip untrusted tracked configs during upgrade by @jdx in [#8195](#8195) ### 🚜 Refactor - use enum for npm.pacakge_manager by @risu729 in [#8180](#8180) ### 📚 Documentation - **(plugins)** replace node/asdf-nodejs examples with vfox plugins by @jdx in [#8191](#8191) ### ⚡ Performance - call npm view only once by @risu729 in [#8181](#8181) ### New Contributors - @jean-humann made their first contribution in [#8173](#8173) - @mackwic made their first contribution in [#8183](#8183) - @rooperuu made their first contribution in [#8169](#8169) ## 📦 Aqua Registry Updates #### New Packages (2) - [`BetterDiscord/cli`](https://github.com/BetterDiscord/cli) - [`glossia.ai/cli`](https://github.com/glossia.ai/cli)

…dx#8191) ## Summary - Replace outdated `node` / `asdf-nodejs` references in plugin subcommand doc comments and CLI examples with `cmake` / `poetry` (vfox plugins from the registry) - Affects `plugins install`, `plugins update`, `plugins uninstall`, `plugins link`, `plugins ls`, and the top-level `plugins` command - Unit tests for URL parsing left unchanged as they test name extraction logic ## Test plan - [x] `cargo check` passes - [x] All lints pass - [ ] Verify `mise plugins install --help` shows updated examples 🤖 Generated with [Claude Code](https://claude.com/claude-code)  --- > [!NOTE] > **Low Risk** > Mostly documentation/example updates; the only functional change is adding a `vfox-` prefix strip to plugin name inference, which is narrow and unlikely to affect existing users beyond improving URL/path inference. > > **Overview** > Refreshes `mise plugins` documentation, manpage text, and shell-completion metadata to replace `node`/`asdf-*` examples with `cmake`/`poetry` and `mise-plugins/vfox-*` URLs across `install`, `ls`, `link`, `update`, and `uninstall`. > > Extends plugin name inference to strip a `vfox-` prefix from plugin repo URLs and local plugin directory names (mirroring existing `asdf-`/`rtx-`/`mise-` handling). > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit d6b4aff. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>  --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

@jdx

### 🚀 Features - **(task)** stream keep-order output in real-time per task by @jdx in [jdx#8164](jdx#8164) ### 🐛 Bug Fixes - **(aqua)** resolve lockfile artifacts for target platform (fix discussion jdx#7479) by @mackwic in [jdx#8183](jdx#8183) - **(exec)** strip shims from PATH to prevent recursive shim execution by @jdx in [jdx#8189](jdx#8189) - **(hook-env)** preserve PATH reordering done after activation by @jdx in [jdx#8190](jdx#8190) - **(lockfile)** resolve version aliases before lockfile lookup by @jdx in [jdx#8194](jdx#8194) - **(registry)** set helm-diff archive bin name to diff by @jean-humann in [jdx#8173](jdx#8173) - **(task)** improve source freshness checks with dynamic task dirs by @rooperuu in [jdx#8169](jdx#8169) - **(task)** resolve global tasks when running from monorepo root by @jdx in [jdx#8192](jdx#8192) - **(task)** prevent wildcard glob `test:*` from matching parent task `test` by @jdx in [jdx#8165](jdx#8165) - **(task)** resolve task_config.includes relative to config root by @jdx in [jdx#8193](jdx#8193) - **(upgrade)** skip untrusted tracked configs during upgrade by @jdx in [jdx#8195](jdx#8195) ### 🚜 Refactor - use enum for npm.pacakge_manager by @risu729 in [jdx#8180](jdx#8180) ### 📚 Documentation - **(plugins)** replace node/asdf-nodejs examples with vfox plugins by @jdx in [jdx#8191](jdx#8191) ### ⚡ Performance - call npm view only once by @risu729 in [jdx#8181](jdx#8181) ### New Contributors - @jean-humann made their first contribution in [jdx#8173](jdx#8173) - @mackwic made their first contribution in [jdx#8183](jdx#8183) - @rooperuu made their first contribution in [jdx#8169](jdx#8169) ## 📦 Aqua Registry Updates #### New Packages (2) - [`BetterDiscord/cli`](https://github.com/BetterDiscord/cli) - [`glossia.ai/cli`](https://github.com/glossia.ai/cli)

Copilot AI review requested due to automatic review settings February 16, 2026 21:50

Copilot started reviewing on behalf of jdx February 16, 2026 21:50 View session

Copilot AI reviewed Feb 16, 2026

View reviewed changes

gemini-code-assist bot reviewed Feb 16, 2026

View reviewed changes

autofix-ci bot and others added 2 commits February 16, 2026 21:54

[autofix.ci] apply automated fixes

474099f

cursor bot reviewed Feb 16, 2026

View reviewed changes

[autofix.ci] apply automated fixes

bc237b8

jdx enabled auto-merge (squash) February 16, 2026 22:07

jdx merged commit e89dfa0 into main Feb 16, 2026
34 checks passed

jdx deleted the docs/update-plugin-examples branch February 16, 2026 22:16

mise-en-dev mentioned this pull request Feb 16, 2026

chore: release 2026.2.15 #8177

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Comments

docs(plugins): replace node/asdf-nodejs examples with vfox plugins#8191

docs(plugins): replace node/asdf-nodejs examples with vfox plugins#8191
jdx merged 4 commits intomainfrom
docs/update-plugin-examples

jdx commented Feb 16, 2026 •

edited by cursor bot

Loading

Uh oh!

gemini-code-assist bot commented Feb 16, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot Feb 16, 2026

Uh oh!

jdx commented Feb 16, 2026

Uh oh!

cursor bot left a comment

Uh oh!

Uh oh!

github-actions bot commented Feb 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

	$ <bold>mise uninstall cmake</bold>
	$ <bold>mise plugins uninstall cmake</bold>

	/// Can specify multiple plugins: `mise plugins install cmake poetry elixir`
	/// Can specify multiple plugins: `mise plugins install cmake poetry`

Uh oh!

Comments

Conversation

jdx commented Feb 16, 2026 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

gemini-code-assist bot commented Feb 16, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

jdx commented Feb 16, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Feb 16, 2026

Hyperfine Performance

mise x -- echo

mise env

mise hook-env

mise ls

xtasks/test/perf

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

jdx commented Feb 16, 2026 •

edited by cursor bot

Loading

`mise x -- echo`

`mise env`

`mise hook-env`

`mise ls`

`xtasks/test/perf`