@xgent-ai/skills 0.1.0 → 0.3.0

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

@@ -0,0 +1,45 @@
+mise patrons
+
+patrons` [​](#mise-patrons)
+
+- **Usage:** `mise patrons [-J --json] [--refresh]`
+- **Effect:** read-only
+- **Source code:** [`src/cli/patrons.rs`](https://github.com/jdx/mise/blob/main/src/cli/patrons.rs)
+
+Show the individuals supporting mise as Patron-tier members
+
+Lists the individuals on the Patron tier from <https://jdx.dev/patrons.json>. The list refreshes daily; supporting terminals will render each patron's name as a clickable link via OSC 8 hyperlinks.
+
+To appear here, become a patron at <https://jdx.dev/sponsors.html>.
+
+## Flags [​](#flags)
+
+- **`-J --json`** — Output in JSON format
+- **`--refresh`** — Bypass the local cache and re-fetch
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+```
+mise patrons
+mise patrons -J
+mise patrons --refresh
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Supporting mise](https://mise.jdx.dev/about.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/patrons.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise packslip pins](https://mise.jdx.dev/cli/packslip/pins.html)
+
+[Next pagemise plugins](https://mise.jdx.dev/cli/plugins.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,46 @@
+mise plugins
+
+plugins` [​](#mise-plugins)
+
+- **Usage:** `mise plugins [FLAGS] [SUBCOMMAND]`
+- **Aliases:** `p`, `plugin`, `plugin-list`
+- **Effect:** read-only
+- **Source code:** [`src/cli/plugins/mod.rs`](https://github.com/jdx/mise/blob/main/src/cli/plugins/mod.rs)
+
+Manage plugins
+
+## Flags [​](#flags)
+
+- **`-c --core`** — Only show built-in (core) plugins These are hidden by default
+- **`-u --urls`** — Show the git url for each plugin e.g.: <https://github.com/mise-plugins/vfox-cmake.git>
+- **`--user`** — List installed plugins
+
+  This is the default behavior but can be used with --core to show core and user plugins
+- **`-h --help`** — Print help
+
+## Subcommands [​](#subcommands)
+
+- [`mise plugins install [FLAGS] [NEW_PLUGIN] [GIT_URL]`](https://mise.jdx.dev/cli/plugins/install.html)
+- [`mise plugins link [-f --force] <NAME> [DIR]`](https://mise.jdx.dev/cli/plugins/link.html)
+- [`mise plugins ls [FLAGS]`](https://mise.jdx.dev/cli/plugins/ls.html)
+- [`mise plugins ls-remote [-u --urls] [--only-names]`](https://mise.jdx.dev/cli/plugins/ls-remote.html)
+- [`mise plugins uninstall [-a --all] [-p --purge] [PLUGIN]…`](https://mise.jdx.dev/cli/plugins/uninstall.html)
+- [`mise plugins update [-j --jobs <JOBS>] [PLUGIN]…`](https://mise.jdx.dev/cli/plugins/update.html)
+
+## Related documentation [​](#related-documentation)
+
+- [Plugin selection and maintenance](https://mise.jdx.dev/plugin-usage.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/plugins.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise patrons](https://mise.jdx.dev/cli/patrons.html)
+
+[Next pagemise plugins install](https://mise.jdx.dev/cli/plugins/install.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,56 @@
+mise prune
+
+prune` [​](#mise-prune)
+
+- **Usage:** `mise prune [FLAGS] [INSTALLED_TOOL]…`
+- **Effect:** destructive — may delete or irreversibly overwrite
+- **Source code:** [`src/cli/prune.rs`](https://github.com/jdx/mise/blob/main/src/cli/prune.rs)
+
+Delete unused versions of tools
+
+mise tracks which config files have been used in \~/.local/state/mise/tracked-configs Versions which are no longer the latest specified in any of those configs are deleted. Versions installed only with environment variables `MISE_<TOOL>_VERSION` will be deleted, as will versions only referenced on the command line `mise exec <TOOL>@<VERSION>`.
+
+Tool stubs that have been executed are tracked in \~/.local/state/mise/tracked-stubs. Versions still referenced by a tracked stub are not deleted.
+
+You can list prunable tools with `mise ls --prunable`
+
+## Arguments [​](#arguments)
+
+- **`[INSTALLED_TOOL]…`** — Prune only these tools
+
+## Flags [​](#flags)
+
+- **`-n --dry-run`** — Do not actually delete anything
+- **`--configs`** — Prune only tracked and trusted configuration links that point to nonexistent configurations
+- **`--dry-run-code`** — Like --dry-run but exits with code 1 if there are tools to prune
+
+  This is useful for scripts to check if tools need to be pruned.
+- **`--monorepo`** — Placeholder for future monorepo pruning; `mise prune --monorepo` is not implemented yet.
+- **`--tools`** — Prune only unused versions of tools
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+Preview unused versions without deleting them. Example output: `rm -rf ~/.local/share/mise/installs/node/20.0.0` and `rm -rf ~/.local/share/mise/installs/node/20.0.1`.
+
+```
+mise prune --dry-run
+```
+
+## 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/prune.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise plugins update](https://mise.jdx.dev/cli/plugins/update.html)
+
+[Next pagemise registry](https://mise.jdx.dev/cli/registry.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,59 @@
+mise registry
+
+registry` [​](#mise-registry)
+
+- **Usage:** `mise registry [FLAGS] [NAME]`
+- **Effect:** read-only
+- **Source code:** [`src/cli/registry.rs`](https://github.com/jdx/mise/blob/main/src/cli/registry.rs)
+
+List registry shorthand names and their backends
+
+The registry maps short names to installation backends. For example, `node` uses the built-in Node backend. A tool may have multiple candidates; explicit backend syntax and configuration can override registry selection.
+
+This is not a list of every tool mise can install. Use an explicit identifier such as `github:owner/repo` for a supported source without a registry shorthand.
+
+## Arguments [​](#arguments)
+
+- **`[NAME]`** — Show only the specified tool's full name
+
+## Flags [​](#flags)
+
+- **`-b --backend <BACKEND>`** — Show only tools for this backend
+- **`--hide-aliased`** — Hide aliased tools
+- **`-J --json`** — Output in JSON format
+- **`--security`** — Include security features for each tool's backends in JSON output
+
+  Requires --json. Security info is de-duplicated across all of a tool's backends. This can add noticeable time for large listings since each backend's security info is resolved individually.
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+List the registry, then inspect node. The second command prints `core:node`.
+
+```
+mise registry
+mise registry node
+```
+
+```
+mise registry --backend aqua
+mise registry --json
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Registry and explicit backends](https://mise.jdx.dev/registry.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/registry.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise prune](https://mise.jdx.dev/cli/prune.html)
+
+[Next pagemise reshim](https://mise.jdx.dev/cli/reshim.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,46 @@
+mise reshim
+
+reshim` [​](#mise-reshim)
+
+- **Usage:** `mise reshim [-f --force] [--system]`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/reshim.rs`](https://github.com/jdx/mise/blob/main/src/cli/reshim.rs)
+
+Create shims for executables provided by installed tools
+
+Run this when an executable was added to an existing installation outside mise, for example after a language package manager installed a CLI globally. It rebuilds the user shim directory by default; `--system` selects the shared system shim farm.
+
+Shims are created for all installed versions. The shim resolves which version to run from the current configuration when invoked. `--force` rebuilds mise-owned shims; it does not turn unrelated files into mise-owned shims.
+
+## Flags [​](#flags)
+
+- **`-f --force`** — Rebuild all mise-owned shims
+- **`--system`** — Rebuild the system shim farm
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+Rebuild shims, then check node. Example output: `v20.0.0`.
+
+```
+mise reshim
+~/.local/share/mise/shims/node -v
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Shims](https://mise.jdx.dev/dev-tools/shims.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/reshim.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise registry](https://mise.jdx.dev/cli/registry.html)
+
+[Next pagemise run](https://mise.jdx.dev/cli/run.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,152 @@
+mise run
+
+run` [​](#mise-run)
+
+- **Usage:** `mise run [FLAGS] [TASK] [ARGS]…`
+- **Aliases:** `r`
+- **Source code:** [`src/cli/run.rs`](https://github.com/jdx/mise/blob/main/src/cli/run.rs)
+
+Run tasks and their dependencies
+
+Use `mise run TASK [ARGS...]` for one task, or separate task invocations with `:::` to schedule several. Put mise flags before the task name; following arguments are passed to that task. With no task, mise runs `default` when defined or opens the task selector in an interactive terminal.
+
+Tasks are defined in `mise.toml` or task directories. A task with `sources` and `outputs` can skip execution when its outputs are fresh. `--force` bypasses freshness checks; task output caching has separate `--task-cache` controls.
+
+For a project that already has npm build scripts and its dependencies installed:
+
+toml
+
+```
+[tasks.build]
+run = "npm run build"
+sources = ["src/**/*.ts", "package.json", "package-lock.json"]
+outputs = ["dist/**/*.js"]
+```
+
+To create a standalone script task, use `mise tasks add --file hello -- echo hello`. Then run `mise run hello`. See <https://mise.jdx.dev/tasks/> for task directories, arguments, caching, and dependency configuration.
+
+## Flags [​](#flags)
+
+- **`--affected`** — Run matching tasks only for projects affected by Git changes
+- **`--affected-base <REV>`** — Git base revision for --affected Defaults to MISE\_AFFECTED\_BASE, CI metadata, or HEAD\~1
+- **`--affected-explain`** — Explain why projects and tasks were selected by --affected
+- **`--affected-head <REV>`** — Git head revision for --affected Defaults to MISE\_AFFECTED\_HEAD, CI metadata, or HEAD
+- **`--affected-json`** — Output affected projects and tasks as JSON without running tasks
+- **`--all`** — Open the interactive selector with all tasks from the entire monorepo
+- **`-c --continue-on-error`** — Continue running tasks even if one fails
+- **`-C --cd <CD>`** — Change to this directory before executing the command
+- **`-f --force`** — Force the tasks to run even if outputs are up to date
+- **`-j --jobs <JOBS>`** — Number of tasks to run in parallel Values below 1 are treated as 1 Defaults to the `jobs` setting or the `MISE_JOBS` env var
+
+  **Environment Variable:** `MISE_JOBS`
+- **`-n --dry-run`** — Don't actually run the task(s), just print them in order of execution
+- **`-o --output <OUTPUT>`** — How task output is displayed
+  - `prefix` - Print stdout/stderr by line, prefixed with the task's label
+  - `interleave` - Print directly to stdout/stderr instead of by line
+  - `replacing` - Stdout is replaced each time, stderr is printed as is
+  - `timed` - Only show stdout lines if they are displayed for more than 1 second
+  - `keep-order` - Print stdout/stderr by line, prefixed with the task's label, but keep the order of the output
+  - `quiet` - Don't show extra output
+  - `silent` - Don't show any output including stdout and stderr from the task except for errors
+
+  **Environment Variable:** `MISE_TASK_OUTPUT`
+- **`-q --quiet`** — Don't show extra output
+
+  **Environment Variable:** `MISE_QUIET`
+- **`-r --raw`** — Read/write directly to stdin/stdout/stderr instead of by line Redactions are not applied with this option Configure with `raw` config or `MISE_RAW` env var
+- **`-s --shell <SHELL>`** — Shell to use to run toml tasks
+
+  Defaults to `sh -o errexit -c` on unix, and `cmd /c` on Windows Can also be set with the setting `MISE_UNIX_DEFAULT_INLINE_SHELL_ARGS` or `MISE_WINDOWS_DEFAULT_INLINE_SHELL_ARGS` Or it can be overridden with the `shell` property on a task.
+- **`-S --silent`** — Don't show any output except for errors
+
+  **Environment Variable:** `MISE_SILENT`
+- **`-t --tool <TOOL@VERSION>`** — Tool(s) to run in addition to what is in mise.toml files e.g.: node@20 python@3.10
+- **`--allow-env <VAR>`** — Allow specific env var through (implies --deny-env for everything else) Supports wildcards, e.g. --allow-env='MYAPP\_\*'
+- **`--allow-net <HOST>`** — Allow network to specific host (implies --deny-net for everything else) Per-host filtering is unsupported on Linux and returns an error. See the sandboxing guide for current macOS host-filter limitations. On Windows, sandboxing is unavailable: mise warns and runs without host filtering.
+- **`--allow-read <PATH>`** — Allow reads from specific path (implies --deny-read for everything else)
+- **`--allow-write <PATH>`** — Allow writes to specific path (implies --deny-write for everything else)
+- **`--deny-all`** — Block reads, writes, network, and env vars
+- **`--deny-env`** — Block env var inheritance except PATH, HOME, USER, SHELL, TERM, COLORTERM, LANG
+- **`--deny-net`** — Block all network access
+- **`--deny-read`** — Block filesystem reads (system libs and tool dirs still accessible)
+- **`--deny-write`** — Block all filesystem writes
+- **`--fresh-env`** — Bypass the environment cache and recompute the environment
+- **`--no-cache`** — Do not use cache on remote tasks
+
+  **Environment Variable:** `MISE_TASK_REMOTE_NO_CACHE`
+- **`--no-deps`** — Skip automatic dependency preparation
+- **`--no-timings`** — Hide the elapsed time printed after each task completes
+
+  Set `MISE_TASK_TIMINGS=0` to hide it by default
+- **`--skip-deps`** — Run only the specified tasks skipping all dependencies
+
+  **Environment Variable:** `MISE_TASK_SKIP_DEPENDS`
+- **`--skip-tools`** — Skip installing tools before running tasks
+
+  Can also be set persistently with the `task.run_auto_install` setting or `MISE_TASK_RUN_AUTO_INSTALL=false` env var
+- **`--task-cache <TASK_CACHE>`** — Set task output cache access for this run
+  - `read-write` - Read cached results and write new results
+  - `read-only` - Read cached results without writing new results
+  - `write-only` - Write new results without reading cached results
+  - `off` - Disable task output caching
+  - `local-only` - Read and write only the local cache; currently equivalent to `read-write`
+
+  **Choices:** `read-write`, `read-only`, `write-only`, `off`, `local-only`
+
+  **Default:** `read-write`
+
+  **Environment Variable:** `MISE_TASK_CACHE`
+- **`--task-cache-explain`** — Explain the inputs that produced each task's output cache key
+- **`--task-cache-explain-json`** — Output cache-key input details as JSON Lines without running tasks
+- **`--task-cache-stats`** — Report task output cache hits, restored bytes, and time saved
+- **`--timeout <TIMEOUT>`** — Timeout for the task to complete e.g.: 30s, 5m
+
+## Examples [​](#examples)
+
+Run the "lint" task, defined either in mise.toml or as a standalone script.
+
+```
+mise run lint
+```
+
+Force the "build" task to run even if its sources are up to date.
+
+```
+mise run --force build
+```
+
+Run "test" with stdin/stdout/stderr all connected to the current terminal. This forces `--jobs=1` to prevent interleaving of output.
+
+```
+mise run --raw test
+```
+
+Run the "lint", "test", and "check" tasks in parallel.
+
+```
+mise run lint ::: test ::: check
+```
+
+Run multiple tasks, each with its own arguments.
+
+```
+mise run cmd1 arg1 arg2 ::: cmd2 arg1 arg2
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Running tasks](https://mise.jdx.dev/tasks/running-tasks.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/run.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise reshim](https://mise.jdx.dev/cli/reshim.html)
+
+[Next pagemise search](https://mise.jdx.dev/cli/search.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,69 @@
+mise search
+
+search` [​](#mise-search)
+
+- **Usage:** `mise search [FLAGS] [NAME]`
+- **Effect:** read-only
+- **Source code:** [`src/cli/search.rs`](https://github.com/jdx/mise/blob/main/src/cli/search.rs)
+
+Search for available tools
+
+Searches the registry and installed backend catalogs for tools matching NAME.
+
+By default, it will show all tools that fuzzy match the search term. For non-fuzzy matches, use the `--match-type` flag.
+
+## Arguments [​](#arguments)
+
+- **`[NAME]`** — The tool to search for
+
+## Flags [​](#flags)
+
+- **`-i --interactive`** — Show an interactive search menu
+- **`-m --match-type <MATCH_TYPE>`** — Match type: equal, contains, or fuzzy
+
+  **Choices:** `equal`, `contains`, `fuzzy`
+
+  **Default:** `fuzzy`
+- **`--no-header`** — Don't display headers
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+```
+mise search jq
+Tool  Description
+jq    Command-line JSON processor. https://github.com/jqlang/jq
+jqp   A TUI playground to experiment with jq. https://github.com/noahgorstein/jqp
+jiq   jid on jq - interactive JSON query tool using jq expressions. https://github.com/fiatjaf/jiq
+gojq  Pure Go implementation of jq. https://github.com/itchyny/gojq
+```
+
+```
+mise search --interactive
+Tool
+Search a tool
+❯ jq    Command-line JSON processor. https://github.com/jqlang/jq
+  jqp   A TUI playground to experiment with jq. https://github.com/noahgorstein/jqp
+  jiq   jid on jq - interactive JSON query tool using jq expressions. https://github.com/fiatjaf/jiq
+  gojq  Pure Go implementation of jq. https://github.com/itchyny/gojq
+/jq
+esc clear filter • enter confirm
+```
+
+## Related documentation [​](#related-documentation)
+
+- [Registry and explicit backends](https://mise.jdx.dev/registry.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/search.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise run](https://mise.jdx.dev/cli/run.html)
+
+[Next pagemise self-update](https://mise.jdx.dev/cli/self-update.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,42 @@
+mise self-update
+
+self-update` [​](#mise-self-update)
+
+- **Usage:** `mise self-update [FLAGS] [VERSION]`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/self_update.rs`](https://github.com/jdx/mise/blob/main/src/cli/self_update.rs)
+
+Update mise itself
+
+Uses the GitHub Releases API to find the latest release and binary. By default, this will also update any installed plugins. Uses mise's GitHub token resolution chain for authenticated requests.
+
+Packagers can disable this command so that mise is updated through the package manager instead. See <https://mise.jdx.dev/contributing.html#packaging-and-self-update-instructions>
+
+## Arguments [​](#arguments)
+
+- **`[VERSION]`** — Update to a specific version
+
+## Flags [​](#flags)
+
+- **`-f --force`** — Update even if already up to date
+- **`-y --yes`** — Skip confirmation prompt
+- **`--no-plugins`** — Disable auto-updating plugins
+- **`-h --help`** — Print help
+
+## Related documentation [​](#related-documentation)
+
+- [Installing and updating mise](https://mise.jdx.dev/installing-mise.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/self-update.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise search](https://mise.jdx.dev/cli/search.html)
+
+[Next pagemise set](https://mise.jdx.dev/cli/set.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)

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

@@ -0,0 +1,116 @@
+mise set
+
+set` [​](#mise-set)
+
+- **Usage:** `mise set [FLAGS] [ENV_VAR]…`
+- **Aliases:** `ev`, `env-vars`
+- **Effect:** modifies state
+- **Source code:** [`src/cli/set.rs`](https://github.com/jdx/mise/blob/main/src/cli/set.rs)
+
+Set environment variables in mise.toml
+
+By default, this command selects the nearest configuration directory and modifies its lowest-precedence TOML file, creating `mise.toml` here if none exists. If multiple config files exist (e.g., both `mise.toml` and `mise.local.toml`), the lowest precedence file (`mise.toml`) will be used. See <https://mise.jdx.dev/configuration.html#target-file-for-write-operations>
+
+Use `-E <env>` to create/modify environment-specific config files like `mise.<env>.toml`.
+
+## Arguments [​](#arguments)
+
+- **`[ENV_VAR]…`** — Environment variable(s) to set e.g.: NODE\_ENV=production
+
+## Flags [​](#flags)
+
+- **`-E --env <ENV>`** — Create/modify an environment-specific config file like .mise.\<env>.toml
+- **`-g --global`** — Set the environment variable in the global config file
+- **`--age-encrypt`** — \[experimental] Encrypt the value with age before storing
+- **`--age-key-file <PATH>`** — \[experimental] Age identity file for encryption
+
+  Defaults to \~/.config/mise/age.txt if it exists
+- **`--age-recipient <RECIPIENT>`** — \[experimental] Age recipient (x25519 public key) for encryption
+
+  Can be used multiple times. Requires --age-encrypt.
+- **`--age-ssh-recipient <PATH_OR_PUBKEY>`** — \[experimental] SSH recipient (public key or path) for age encryption
+
+  Can be used multiple times. Requires --age-encrypt.
+- **`--file <FILE>`** — The TOML file to update
+
+  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`
+- **`--no-redact`** — Show raw values instead of redacting secrets
+- **`--prompt`** — Prompt for environment variable values
+- **`--stdin`** — Read the value from stdin (for multiline input)
+
+  When using --stdin, provide a single key without a value. The value will be read from stdin until EOF.
+- **`-h --help`** — Print help
+
+## Examples [​](#examples)
+
+```
+mise set NODE_ENV=production
+```
+
+Read NODE\_ENV; example output: `production`.
+
+```
+mise set NODE_ENV
+```
+
+Create or modify mise.staging.toml.
+
+```
+mise set -E staging NODE_ENV=staging
+```
+
+List keys, values, and source files.
+
+```
+mise set
+```
+
+Prompt for PASSWORD with hidden input.
+
+```
+mise set --prompt PASSWORD
+```
+
+Read a multiline value from stdin.
+
+```
+cat private.key | mise set --stdin MY_KEY
+```
+
+Store a multiline value from a pipeline.
+
+```
+printf "line1\nline2" | mise set --stdin MY_KEY
+```
+
+Encrypt the value with age (experimental).
+
+```
+mise set --age-encrypt API_KEY=secret
+```
+
+Prompt with hidden input and encrypt with age (experimental).
+
+```
+mise set --age-encrypt --prompt API_KEY
+```
+
+## 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/set.md)
+
+Last updated:
+
+Pager
+
+[Previous pagemise self-update](https://mise.jdx.dev/cli/self-update.html)
+
+[Next pagemise settings](https://mise.jdx.dev/cli/settings.html)
+
+MIT License·Copyright © 2026· [![](https://github.com/jdx.png?size=96)jdx.dev](https://jdx.dev)