docs: Change exec command to use bash for variable echo by kuboon · Pull Request #9567 · jdx/mise

kuboon · 2026-05-03T13:51:26Z

https://mise.jdx.dev/environments/

bash parses $MY_VAR before mise exec.
This document does not work.

mise set MY_VAR=123
mise exec -- echo $MY_VAR
# 123

https://mise.jdx.dev/environments/ bash parses `$MY_VAR` before mise exec. This document does not work. ```bash mise set MY_VAR=123 mise exec -- echo $MY_VAR # 123 ```

greptile-apps · 2026-05-03T13:52:27Z

Greptile Summary

This PR fixes a documentation example in docs/environments/index.md where $MY_VAR was expanded by the invoking shell before mise exec could inject its managed environment, making the example misleading. The fix wraps the command in bash -c '...' using single quotes, so the variable is evaluated inside the mise-managed environment as intended.

Confidence Score: 5/5

Documentation-only fix; safe to merge.

The change is a single-line documentation correction that accurately fixes a misleading shell example. No code, logic, or tests are affected.

No files require special attention.

Important Files Changed

Filename	Overview
docs/environments/index.md	Single-line doc fix: replaces `echo $MY_VAR` (shell-expanded before mise exec) with `bash -c 'echo $MY_VAR'` (evaluated inside mise's environment) — fix is correct.

Sequence Diagram

sequenceDiagram
    participant Shell as User Shell
    participant Mise as mise exec
    participant Cmd as echo / bash -c

    Note over Shell,Cmd: Before fix (broken)
    Shell->>Shell: expands $MY_VAR → "" (not set in shell)
    Shell->>Mise: mise exec -- echo ""
    Mise->>Cmd: echo ""
    Cmd-->>Shell: (empty output)

    Note over Shell,Cmd: After fix (correct)
    Shell->>Mise: mise exec -- bash -c 'echo $MY_VAR'
    Mise->>Mise: injects MY_VAR=123 into environment
    Mise->>Cmd: bash -c 'echo $MY_VAR'
    Cmd-->>Shell: 123

_{Reviews (1): Last reviewed commit: "Change exec command to use bash for vari..." | Re-trigger Greptile}

gemini-code-assist

Code Review

This pull request updates the documentation for environment variables to demonstrate correct variable expansion using mise exec. The feedback suggests using the built-in -c flag instead of manually invoking bash -c, which is more idiomatic and avoids hardcoding a specific shell.

gemini-code-assist · 2026-05-03T13:52:31Z

 ```shell
 mise set MY_VAR=123
-mise exec -- echo $MY_VAR
+mise exec -- bash -c 'echo $MY_VAR'


While using bash -c correctly prevents the current shell from expanding the variable prematurely, mise exec provides a built-in -c (or --command) flag specifically for this purpose. Using it is more idiomatic and avoids hardcoding bash as the execution shell.

Suggested change

mise exec -- bash -c 'echo $MY_VAR'

mise exec -c 'echo $MY_VAR'

wow, I did not know this option.

@jdx

### 🚀 Features - **(conda)** graduate conda backend out of experimental by @jdx in [#9544](#9544) - **(deps)** Add dart and flutter providers by @tjarvstrand in [#9505](#9505) - **(registry)** add neo4j by @mnm364 in [#9525](#9525) - **(registry)** add rustfs by @mnm364 in [#9530](#9530) - **(task)** support exclusion patterns in task sources by @jlarmstrongiv in [#9496](#9496) - **(vfox)** add stat function to lua file module by @esteve in [#9497](#9497) ### 🐛 Bug Fixes - **(backend)** flag regex prerelease versions by @jdx in [#9500](#9500) - **(backend)** mark -nightly/-canary/-experimental as prereleases by @jdx in [#9523](#9523) - **(backend)** suppress no-versions warning for unresolved-latest backends by @jdx in [#9548](#9548) - **(backend)** include dotnet prereleases from package flags by @jdx in [#9551](#9551) - **(backend)** scope PEP 440 prerelease detection to Python backends by @jdx in [#9558](#9558) - **(cargo)** Apply install_env during cargo install by @c22 in [#9502](#9502) - **(copr)** drop epel-9 chroots since rust >= 1.91 is unavailable by @jdx in [#9484](#9484) - **(github)** skip attestations on non-default api_url by @jdx in [#9486](#9486) - **(github)** retry ip allow list errors without auth by @risu729 in [#9506](#9506) - **(http)** update versions host tracking endpoint by @jdx in [#9527](#9527) - **(install)** don't warn for configured tools when version is passed via CLI by @jdx in [#9522](#9522) - **(install)** refresh latest before installing missing tools by @jdx in [#9545](#9545) - **(install)** don't cache nonexistent install paths by @jdx in [#9553](#9553) - **(lockfile)** don't propagate ad-hoc CLI overrides into the project lockfile by @jdx in [#9562](#9562) - **(plugin)** detect plugin types after cloning by @risu729 in [#9540](#9540) - **(release)** pass --no-git-checks to aube publish by @jdx in [#9483](#9483) - **(task)** convert PATH to MSYS Unix form when spawning POSIX shells on Windows by @JamBalaya56562 in [#9547](#9547) ### 📚 Documentation - **(contributing)** require popularity check for registry PRs by @jdx in [7bbeebe](7bbeebe) - **(watch)** update pitchfork domain to en.dev by @risu729 in [#9536](#9536) - document ghtkn GitHub token setup by @jdx in [#9546](#9546) - clarify registry backend acceptance policy by @jdx in [#9543](#9543) - Change exec command to use bash for variable echo by @kuboon in [#9567](#9567) ### 🧪 Testing - **(e2e)** run test-tool targets in parallel by @jdx in [#9564](#9564) - **(e2e)** run tests in parallel by @jdx in [#9563](#9563) - **(e2e)** bind-mount /tmp on disk and surface failed tests in CI summary by @jdx in [#9570](#9570) - **(tasks)** migrate test_task_help atask to usage field by @jdx in [#9549](#9549) ### 📦️ Dependency Updates - update fedora:45 docker digest to 8b838b3 by @renovate[bot] in [#9507](#9507) - update ghcr.io/jdx/mise:deb docker digest to f02194c by @renovate[bot] in [#9509](#9509) - update taiki-e/install-action digest to 7769b73 by @renovate[bot] in [#9512](#9512) - update ghcr.io/jdx/mise:alpine docker digest to 581f8a8 by @renovate[bot] in [#9508](#9508) - update rust crate ctor to v0.10.1 by @renovate[bot] in [#9515](#9515) - update ghcr.io/jdx/mise:rpm docker digest to a5c9655 by @renovate[bot] in [#9510](#9510) - update rust docker digest to a9cfb75 by @renovate[bot] in [#9511](#9511) - update rust crate age to v0.11.3 by @renovate[bot] in [#9514](#9514) - update rust crate jiff to v0.2.24 by @renovate[bot] in [#9516](#9516) - update dependency vitepress-plugin-tabs to ^0.9.0 by @renovate[bot] in [#9518](#9518) - update autofix-ci/action action to v1.3.4 by @renovate[bot] in [#9513](#9513) - update rust crate usage-lib to v3.2.1 by @renovate[bot] in [#9517](#9517) - update apple-actions/import-codesign-certs action to v7 by @renovate[bot] in [#9519](#9519) - update taiki-e/install-action digest to 51cd0b8 by @renovate[bot] in [#9531](#9531) - exclude taiki-e/install-action from renovate by @jdx in [#9532](#9532) - update rust crate blake3 to v1.8.5 by @renovate[bot] in [#9533](#9533) ### 📦 Registry - enable shellcheck on windows by @zeitlinger in [#9487](#9487) - add google-java-format by @zeitlinger in [#9488](#9488) - add expert ([aqua:expert-lsp/expert](https://github.com/expert-lsp/expert)) by @AlternateRT in [#9498](#9498) - update entry for checkmake by @eread in [#9504](#9504) - add systemctl-tui ([aqua:rgwood/systemctl-tui](https://github.com/rgwood/systemctl-tui)) by @2xdevv in [#9521](#9521) - add codon by @3w36zj6 in [#9538](#9538) - add tool yr (backend:github:VirusTotal/yara-x) by @adam-moss in [#9542](#9542) - add tool betterleaks (backend:aqua/betterleaks/betterleaks) by @adam-moss in [#9541](#9541) - add `git-filter-repo` by @garysassano in [#9550](#9550) - add umoci ([aqua:opencontainers/umoci](https://github.com/opencontainers/umoci)) by @2xdevv in [#9555](#9555) - add aqua backend for elixir-ls by @AlternateRT in [#9557](#9557) - deny inline backend options by @risu729 in [#9565](#9565) ### Chore - **(ci)** fail registry tests without summary by @jdx in [#9559](#9559) - **(ci)** use !cancelled() instead of always() for test-ci aggregator by @jdx in [#9569](#9569) - **(ci)** use namespace runners for ci jobs by @jdx in [#9561](#9561) - **(config)** deprecate shorthands_file setting by @risu729 in [#9534](#9534) - **(docs)** remove shrill.en.dev analytics script by @jdx in [#9539](#9539) - **(release)** replace bc with awk in release-plz star formatting by @jdx in [d7f177f](d7f177f) - bump hk to 1.44.3 by @jdx in [#9493](#9493) - invert CLAUDE.md/AGENTS.md so AGENTS.md is canonical by @jdx in [#9560](#9560) - set dev profile debug to 1 by @jdx in [#9572](#9572) ### New Contributors - @kuboon made their first contribution in [#9567](#9567) - @AlternateRT made their first contribution in [#9557](#9557) - @2xdevv made their first contribution in [#9555](#9555) - @adam-moss made their first contribution in [#9541](#9541) - @jlarmstrongiv made their first contribution in [#9496](#9496) - @tjarvstrand made their first contribution in [#9505](#9505)

Change exec command to use bash for variable echo

d5b01d7

https://mise.jdx.dev/environments/ bash parses `$MY_VAR` before mise exec. This document does not work. ```bash mise set MY_VAR=123 mise exec -- echo $MY_VAR # 123 ```

gemini-code-assist Bot reviewed May 3, 2026

View reviewed changes

jdx changed the title ~~fix document error: Change exec command to use bash for variable echo~~ docs: fix document error: Change exec command to use bash for variable echo May 3, 2026

jdx changed the title ~~docs: fix document error: Change exec command to use bash for variable echo~~ docs: Change exec command to use bash for variable echo May 3, 2026

jdx merged commit 73983a6 into jdx:main May 3, 2026
36 of 37 checks passed

kuboon deleted the patch-1 branch May 3, 2026 14:14

mise-en-dev mentioned this pull request May 3, 2026

chore: release 2026.5.0 #9485

Merged

BrewTestBot mentioned this pull request May 3, 2026

mise 2026.5.0 Homebrew/homebrew-core#280712

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: Change exec command to use bash for variable echo#9567

docs: Change exec command to use bash for variable echo#9567
jdx merged 1 commit intojdx:mainfrom
kuboon:patch-1

kuboon commented May 3, 2026

Uh oh!

greptile-apps Bot commented May 3, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

gemini-code-assist Bot May 3, 2026

Uh oh!

kuboon May 3, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	mise exec -- bash -c 'echo $MY_VAR'
	mise exec -c 'echo $MY_VAR'

Uh oh!

Conversation

kuboon commented May 3, 2026

Uh oh!

greptile-apps Bot commented May 3, 2026

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Sequence Diagram

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist Bot May 3, 2026

Choose a reason for hiding this comment

Uh oh!

kuboon May 3, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants