Optional bootstrap packages

[nickdirienzo]

One thing that would simplify how we handle mise bootstrap is optional bootstrap packages.

Right now we have stuff that's actually required, eg:

[bootstrap.packages]
"brew-cask:orbstack" = { os = "macos" }
"brew-cask:1password" = { os = "macos" }

But then there's a bunch of stuff that's useful / commonly used but definitely shouldn't be required for every developer, eg:

"brew-cask:ghostty" = { os = "macos" }
"brew-cask:firefox" = { os = "macos" }
"brew-cask:rectangle" = { os = "macos" }

I ended up writing an interactive bootstrap script that asks y/n for these, but it feels like mise already has all of the primitives except for expressing "this package is optional."

Maybe something like:

[bootstrap.packages]
"brew-cask:orbstack" = { os = "macos" }

"brew-cask:ghostty" = { os = "macos", optional = true }
"brew-cask:firefox" = { os = "macos", optional = true }
"brew-cask:rectangle" = { os = "macos", optional = true }

Then an interactive mise bootstrap could prompt for optional packages, while non-interactive / --yes bootstrap could just skip them unless explicitly requested.

Maybe eventually:

mise bootstrap --with-optional
mise bootstrap --optional ghostty,firefox

The thing I like about this vs a separate shell script is that the package still has one declarative home. os, package manager, adoption, source/provenance, etc. all stay in mise.toml; the only additional bit of state is whether it's required.

Not sure if optional = true is the exact API, but the concept feels like it fits bootstrap pretty naturally.

[jdx]

I revised #12956 based on the follow-up discussion. Instead of an optional package state, bootstrap packages now accept an env selector alongside os:

[bootstrap.packages]
"brew-cask:ghostty" = { os = "macos", env = "desktop" }
"brew-cask:slack" = { env = ["work", "client"] }

env matches active config environments selected by -E or MISE_ENV. When both selectors are present, both must match. This keeps bootstrap deterministic and leaves package state as present or absent.

AI-assisted — Tool: Codex; model: OpenAI/GPT-5; version: unavailable.

[nickdirienzo]

Amazing. Thanks! Looking forward to killing off my script.