@xgent-ai/skills 0.1.0 → 0.3.0

package/skills/working-with-mise/references/cli/trust-html.md

@@ -0,0 +1,63 @@
+mise trust
+
+trust` [​](#mise-trust)
+
+- **Usage:** `mise trust [FLAGS] [CONFIG_FILE]`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/trust.rs`](https://github.com/jdx/mise/blob/main/src/cli/trust.rs)
+
+Mark a config file as trusted
+
+This means mise is allowed to parse the file when it needs to read config that may execute code or affect the environment. Without trust, mise may prompt, skip the config in some discovery paths, or fail with an untrusted-config error when it cannot prompt.
+
+In normal mode, commands that execute project-defined behavior (`mise run`, naked task invocations such as `mise <TASK>`, `mise install`, `mise exec`, and `mise watch`) automatically trust their active config. Paranoid mode requires explicit, content-bound trust for every non-global config.
+
+In normal mode, safe config files do not require trust: files that only contain `min_version`, `[tools]` entries with plain version strings (or arrays of them), and `[tasks]` without templates or tool options.
+
+Trust is shared across git worktrees: a config file inside a linked worktree is trusted when the equivalent path in the repository's main checkout has been trusted. Paranoid mode disables this sharing since worktrees can check out branches with different config contents.
+
+## Arguments [​](#arguments)
+
+- **`[CONFIG_FILE]`** — The config file whose trust status to change
+
+## Flags [​](#flags)
+
+- **`-a --all`** — Trust all config files in the current directory, its parents, and its subdirectories
+
+  Subdirectories are walked respecting .gitignore, skipping hidden directories and common build/dependency directories (node\_modules, vendor, target, dist, build).
+- **`--ignore`** — Do not trust this config and ignore it in the future
+- **`--show`** — Show the trusted status of config files from the current directory and its parents. Does not trust or untrust any files.
+- **`--untrust`** — Remove explicit trust for this config
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+trusts \~/some\_dir/mise.toml
+
+```
+mise trust ~/some_dir/mise.toml
+```
+
+trusts mise.toml in the current or parent directory
+
+```
+mise trust
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Configuration trust](https://mise.jdx.dev/security.html).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/trust.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise tool-stub](https://mise.jdx.dev/cli/tool-stub.html)
+
+[Next pagemise uninstall](https://mise.jdx.dev/cli/uninstall.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/uninstall-html.md

@@ -0,0 +1,62 @@
+mise uninstall
+
+uninstall` [​](#mise-uninstall)
+
+- **Usage:** `mise uninstall [FLAGS] [INSTALLED_TOOL@VERSION]…`
+- **Effect:** destructive — may delete or irreversibly overwrite
+- **Source code:** [`src/cli/uninstall.rs`](https://github.com/jdx/mise/blob/main/src/cli/uninstall.rs)
+
+Remove installed tool versions
+
+This only removes the installed version; it does not modify mise.toml. Use `mise unuse` to remove a tool from mise.toml and uninstall it.
+
+## Arguments [​](#arguments)
+
+- **`[INSTALLED_TOOL@VERSION]…`** — Tool(s) to remove
+
+## Flags [​](#flags)
+
+- **`-a --all`** — Delete all installed versions
+- **`-n --dry-run`** — Do not actually delete anything
+- **`--dry-run-code`** — Like --dry-run but exits with code 1 if there are tools to uninstall
+
+  This is useful for scripts to check if tools need to be uninstalled.
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+uninstall a specific version
+
+```
+mise uninstall node@18.0.0
+```
+
+uninstall the current node version (if only one version is installed)
+
+```
+mise uninstall node
+```
+
+uninstall every installed version of node
+
+```
+mise uninstall --all node
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Development tools](https://mise.jdx.dev/dev-tools/).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/uninstall.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise trust](https://mise.jdx.dev/cli/trust.html)
+
+[Next pagemise unset](https://mise.jdx.dev/cli/unset.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/unset-html.md

@@ -0,0 +1,59 @@
+mise unset
+
+unset` [​](#mise-unset)
+
+- **Usage:** `mise unset [-f --file <FILE>] [-g --global] [ENV_KEY]…`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/unset.rs`](https://github.com/jdx/mise/blob/main/src/cli/unset.rs)
+
+Remove environment variable(s) from the config file
+
+By default, this command selects the nearest configuration directory and modifies its lowest-precedence TOML file, creating `mise.toml` here if none exists.
+
+## Arguments [​](#arguments)
+
+- **`[ENV_KEY]…`** — Environment variable(s) to remove e.g.: NODE\_ENV
+
+## Flags [​](#flags)
+
+- **`-f --file <FILE>`** — Specify a file to use instead of `mise.toml`
+
+  Can be a file path or directory. If a directory is provided, will create/use mise.toml in that directory.
+
+  Defaults to [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) environment variable, or `mise.toml`. Use [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) to choose a different global config path.
+
+  **Aliases:** `--path`
+- **`-g --global`** — Use the global config file
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+Remove NODE\_ENV from the selected project config
+
+```
+mise unset NODE_ENV
+```
+
+Remove NODE\_ENV from the global config
+
+```
+mise unset NODE_ENV -g
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Environment variables](https://mise.jdx.dev/environments/).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/unset.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise uninstall](https://mise.jdx.dev/cli/uninstall.html)
+
+[Next pagemise untrust](https://mise.jdx.dev/cli/untrust.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/untrust-html.md

@@ -0,0 +1,35 @@
+mise untrust
+
+untrust` [​](#mise-untrust)
+
+- **Usage:** `mise untrust [CONFIG_FILE]`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/untrust.rs`](https://github.com/jdx/mise/blob/main/src/cli/untrust.rs)
+
+Remove explicit trust for a config
+
+## Arguments [​](#arguments)
+
+- **`[CONFIG_FILE]`** — The config file to untrust
+
+## Flags [​](#flags)
+
+- **`-h --help`** — Print help
+
+## Related documentation [​](#related-documentation)
+
+- [Configuration trust](https://mise.jdx.dev/security.html).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/untrust.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise unset](https://mise.jdx.dev/cli/unset.html)
+
+[Next pagemise unuse](https://mise.jdx.dev/cli/unuse.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/unuse-html.md

@@ -0,0 +1,74 @@
+mise unuse
+
+unuse` [​](#mise-unuse)
+
+- **Usage:** `mise unuse [FLAGS] <INSTALLED_TOOL@VERSION>…`
+- **Aliases:** `rm`, `remove`
+- **Effect:** destructive — may delete or irreversibly overwrite
+- **Source code:** [`src/cli/unuse.rs`](https://github.com/jdx/mise/blob/main/src/cli/unuse.rs)
+
+Remove tool requests from configuration and prune unused installations
+
+Without a selector, mise edits the first loaded config that declares one of the requested tools. Use `--path`, `--global`, or `--env` to choose a specific file. A version argument matches the configured request literally: to remove `node = "20"`, use `mise unuse node@20`, not the concrete installed version it resolved to. Omit the version to remove all requests for that tool from the selected file.
+
+Versions are pruned only when no remaining tracked config or tool stub needs them. Pass `--no-prune` to edit configuration while keeping installations. To remove an installation without editing configuration, use `mise uninstall`.
+
+## Arguments [​](#arguments)
+
+- **`<INSTALLED_TOOL@VERSION>…`** — Tool(s) to remove
+
+## Flags [​](#flags)
+
+- **`-e --env <ENV>`** — Modify `.mise.<env>.toml` when it exists, otherwise `mise.<env>.toml`
+- **`-g --global`** — Use the global config file ( `~/.config/mise/config.toml`) instead of the local one
+- **`-p --path <PATH>`** — Specify a path to a config file or directory
+
+  If a directory is specified, it will look for a config file in that directory following the target-file selection rules.
+
+  **Aliases:** `--file`
+- **`--no-prune`** — Do not also prune the installed version
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+remove node@18.0.0 from mise.toml and uninstall it
+
+```
+mise unuse node@18.0.0
+```
+
+remove it from the global config instead
+
+```
+mise unuse -g node@18.0.0
+```
+
+remove the literal node@20 request from mise.local.toml
+
+```
+mise unuse --env local node@20
+```
+
+remove the literal node@20 request from mise.staging.toml
+
+```
+mise unuse --env staging node@20
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Configuration write targets](https://mise.jdx.dev/configuration.html#target-file-for-write-operations).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/unuse.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise untrust](https://mise.jdx.dev/cli/untrust.html)
+
+[Next pagemise upgrade](https://mise.jdx.dev/cli/upgrade.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/upgrade-html.md

@@ -0,0 +1,133 @@
+mise upgrade
+
+upgrade` [​](#mise-upgrade)
+
+- **Usage:** `mise upgrade [FLAGS] [INSTALLED_TOOL@VERSION]…`
+- **Aliases:** `up`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/upgrade.rs`](https://github.com/jdx/mise/blob/main/src/cli/upgrade.rs)
+
+Upgrade outdated tools
+
+By default, this keeps the range specified in mise.toml: with node@20 set, it upgrades to the latest 20.x.x available. Use `--bump` to upgrade to the latest version overall and rewrite the version in mise.toml.
+
+This also updates mise.lock if lockfiles are enabled, see <https://mise.jdx.dev/configuration/settings.html#lockfile>
+
+## Arguments [​](#arguments)
+
+- **`[INSTALLED_TOOL@VERSION]…`** — Tool(s) to upgrade e.g.: node@20 python@3.10 If not specified, all current tools will be upgraded
+
+## Flags [​](#flags)
+
+- **`-b --bump`** — Upgrade to the latest version available, bumping the version in mise.toml
+
+  For example, if you have `node = "20.0.0"` in your mise.toml but 22.1.0 is the latest available, this will install 22.1.0 and set `node = "22.1.0"` in your config.
+
+  It keeps the same precision as what was there before, so if you instead had `node = "20"`, it would change your config to `node = "22"`.
+- **`-i --interactive`** — Choose which tools to upgrade from a multiselect menu
+- **`-j --jobs <JOBS>`** — Number of jobs to run in parallel Values below 1 are treated as 1 Defaults to the `jobs` setting
+
+  **Environment Variable:** `MISE_JOBS`
+- **`-n --dry-run`** — Print what would be done without doing it
+- **`-x --exclude <INSTALLED_TOOL>`** — Tool(s) to exclude from upgrading e.g.: go python
+- **`--dry-run-code`** — Like --dry-run but exits with code 1 if there are outdated tools
+
+  This is useful for scripts to check if tools need to be upgraded.
+- **`--inactive`** — Upgrade all tools, including installed-but-inactive tools not present in the current config
+- **`--local`** — Only upgrade tools defined in local config files
+
+  This will only upgrade tools that are defined in project-local mise.toml and will skip tools defined in the global config (\~/.config/mise/config.toml).
+- **`--minimum-release-age <MINIMUM_RELEASE_AGE>`** — Only upgrade to versions released before this date or older than this duration
+
+  Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y". This can be useful for reproducibility or security purposes.
+
+  This only affects fuzzy version matches like "20" or "latest". Explicitly pinned versions like "22.5.0" are not filtered.
+- **`--monorepo`** — Placeholder for future monorepo upgrades; `mise upgrade --monorepo` is not implemented yet.
+- **`--no-prune`** — Do not uninstall the versions that were upgraded away from
+
+  The old version is left in place and is not scheduled for removal. Use this when something outside mise points at the install directory.
+
+  Set `upgrade.auto_prune = false` to make this the default.
+- **`--prune`** — Immediately uninstall the versions that were upgraded away from
+
+  Use this to bypass `upgrade.prune_after`, or to override `upgrade.auto_prune = false` for a single run.
+- **`--raw`** — Connect backend install command stdin/stdout/stderr directly to the terminal. Implies `--jobs=1`
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+Upgrades node to the latest version matching the range in mise.toml
+
+```
+mise upgrade node
+```
+
+Upgrades node to the latest version and bumps the version in mise.toml
+
+```
+mise upgrade node --bump
+```
+
+Upgrades all configured tools within their current requests
+
+```
+mise upgrade
+```
+
+Upgrades all tools to the latest versions and bumps the version in mise.toml
+
+```
+mise upgrade --bump
+```
+
+Just print what would be done, don't actually do it
+
+```
+mise upgrade --dry-run
+```
+
+Upgrades node and python within their current requests
+
+```
+mise upgrade node python
+```
+
+Upgrade all tools except go
+
+```
+mise upgrade --exclude go
+```
+
+Show a multiselect menu to choose which tools to upgrade
+
+```
+mise upgrade --interactive
+```
+
+Only upgrade tools defined in local mise.toml, not global ones
+
+```
+mise upgrade --local
+```
+
+Deprecation:
+
+The `-l` shorthand for `--bump` is deprecated and will be removed in mise 2027.8.5. After removal, `-l` will become shorthand for `--local`. Use `-b` or `--bump` instead.
+
+## Related documentation [​](#related-documentation)
+
+- [Development tools](https://mise.jdx.dev/dev-tools/).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/upgrade.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise unuse](https://mise.jdx.dev/cli/unuse.html)
+
+[Next pagemise use](https://mise.jdx.dev/cli/use.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

package/skills/working-with-mise/references/cli/use-html.md

@@ -0,0 +1,130 @@
+mise use
+
+use` [​](#mise-use)
+
+- **Usage:** `mise use [FLAGS] [TOOL@VERSION]…`
+- **Aliases:** `u`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/use.rs`](https://github.com/jdx/mise/blob/main/src/cli/use.rs)
+
+Install a tool and add it to configuration
+
+Installs missing tool versions and records the requests in a config file. By default, mise selects the nearest directory with a supported config and writes to its lowest-precedence file, such as `mise.toml` rather than `mise.local.toml`. If no project config exists, it creates one in the current directory. Running from your home directory targets global configuration.
+
+Use `--path` for an explicit file/directory, `--global` for personal defaults, or `--env` to write `mise.ENV.toml` in the current directory (preserving an existing `.mise.ENV.toml`). These selectors override one another; use one per command.
+
+See <https://mise.jdx.dev/configuration.html#target-file-for-write-operations> for filename overrides and configuration precedence. Selection takes effect in an activated shell on its next prompt, or immediately in `mise exec` commands.
+
+## Arguments [​](#arguments)
+
+- **`<TOOL@VERSION>`** — Tool to add to config file
+
+  e.g.: node@20, cargo:ripgrep@latest, npm:prettier@3 If no version is specified, it defaults to @latest
+
+  Tool options can be set with this syntax:
+
+  ```
+  mise use "cargo:ripgrep[features=pcre2]"
+  ```
+
+
+
+## Flags [​](#flags)
+
+- **`-e --env <ENV>`** — Create/modify an environment-specific config file like .mise.\<env>.toml
+- **`-f --force`** — Force reinstall even if already installed
+- **`-g --global`** — Use the global config file ( `~/.config/mise/config.toml`) instead of the local one
+- **`-j --jobs <JOBS>`** — Number of jobs to run in parallel Values below 1 are treated as 1 Defaults to the `jobs` setting
+
+  **Environment Variable:** `MISE_JOBS`
+- **`-n --dry-run`** — Perform a dry run, showing what would be installed and modified without making changes
+- **`-p --path <PATH>`** — Specify a path to a config file or directory
+
+  If a directory is specified, it will look for a config file in that directory following the target-file selection rules.
+- **`--dry-run-code`** — Like --dry-run but exits with code 1 if there are changes to make
+
+  This is useful for scripts to check if tools need to be added or removed.
+- **`--fuzzy`** — Save fuzzy version to config file
+
+  e.g.: `mise use --fuzzy node@20` will save `20` as the version. This is the default behavior unless `MISE_PIN=1`
+- **`--minimum-release-age <MINIMUM_RELEASE_AGE>`** — Only install versions released before this date or older than this duration
+
+  Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".
+- **`--pin`** — Save the resolved concrete version to the config file
+
+  If the request exactly matches an available release, that release is preferred over installed fuzzy matches. Use `prefix:` to explicitly request recursive prefix matching. e.g.: `mise use --pin node@20` will save the resolved `20.x.y` version Set `MISE_PIN=1` to make this the default behavior
+
+  Consider using mise.lock as a better alternative to pinning in mise.toml: <https://mise.jdx.dev/configuration/settings.html#lockfile>
+- **`--raw`** — Connect backend install command stdin/stdout/stderr directly to the terminal. Implies `--jobs=1`
+- **`--remove <TOOL>`** — Remove the tool(s) from config file
+- **`-h --help`** — Print help
+- **`--postinstall <COMMAND>`** — Command to run after installing this tool
+- **`--tool-option <KEY=VALUE>`** — Set an option for this tool (repeat for multiple options). Values use inline tool-option types; unquoted text is treated as a string. Place these flags before the tool they apply to.
+
+## Examples [​](#examples)
+
+run with no arguments to use the interactive selector
+
+```
+mise use
+```
+
+set the current version of node to 20.x in the selected project config will write the fuzzy version (e.g.: 20)
+
+```
+mise use node@20
+```
+
+run a command after installing a tool
+
+```
+mise use --postinstall "mbx setup --defaults" mr-boxington
+```
+
+associate a different postinstall command with each tool
+
+```
+mise use --postinstall "setup-a" tool-a --postinstall "setup-b" tool-b
+```
+
+enable a Rust tool option while installing Rust and mbx
+
+```
+mise use --tool-option mr_boxington=true rust mr-boxington
+```
+
+set the current version of node to 20.x in \~/.config/mise/config.toml will write the precise version (e.g.: 20.0.0)
+
+```
+mise use -g --pin node@20
+```
+
+writes mise.local.toml (preserving .mise.local.toml if it already exists)
+
+```
+mise use --env local node@20
+```
+
+writes mise.staging.toml (loaded with MISE\_ENV=staging)
+
+```
+mise use --env staging node@20
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Installing and selecting tools](https://mise.jdx.dev/dev-tools/).
+- [All commands](https://mise.jdx.dev/cli/).
+- [Global flags and argument syntax](https://mise.jdx.dev/cli/#global-flags).
+
+[Edit this page](https://github.com/jdx/mise/edit/main/docs/cli/use.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise upgrade](https://mise.jdx.dev/cli/upgrade.html)
+
+[Next pagemise version](https://mise.jdx.dev/cli/version.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)