A desktop GUI for mise, the polyglot tool version manager. Faithful to the command line you already know: every screen maps to a mise command, and every action shows you the exact command it runs.
- See everything: installed tools, active versions, outdated upgrades, per-directory overrides with their config source — no mental PATH math.
- Act safely: every mutation shows the exact
misecommand and its live logs. Nothing happens in a black box. - Learn as you go: the GUI teaches the CLI instead of hiding it.
- Per-directory without the terminal: point the app at a directory and see (and edit) what mise would resolve there.
- Global tool management: install, uninstall, switch, upgrade, and see outdated badges in one table.
- Directory context: resolved tools, env vars, and lockfile for any directory, with config-source badges.
- Env vars: first-class env-var management per directory or global (
mise env/mise set/mise unset), plus config-file visibility on Preview. - Tasks: list, run with live output, and simple edits.
- Trust UX: untrusted directories stay read-only until you choose to trust them.
- Settings, doctor, and plugin/backend browsing: inspect and tweak settings, run
mise doctor, and browse the registry. - mise self-management: guided install when mise is missing and one-click self-update.
- Activation helpers: open the current directory in a terminal, copy the activation command, and check shell setup.
- English and Simplified Chinese UI.
| English | 简体中文 |
|---|---|
 |
 |
 |
 |
 |
|
 |
More screenshots, including the i18n switcher, execution panel, and visual-system gallery, are in docs/screenshots/.
Pre-built unsigned binaries are available on GitHub Releases.
# macOS (recommended)
brew install --cask cherishfall/tap/misedeckmacOS builds are not signed or notarized. On first open you may see a Gatekeeper dialog saying the app is from an unidentified developer, or—after dragging the app out of the DMG—macOS may report that "misedeck" is damaged and can't be opened. This is Gatekeeper's quarantine flag on an unsigned app.
To open the app, remove the quarantine attribute from the copy in /Applications:
xattr -dr com.apple.quarantine /Applications/misedeck.appThen launch it normally. Alternatively, open System Settings → Privacy & Security → Security and click Open Anyway after a launch attempt.
Windows .exe/.msi and Linux .deb/.rpm/.AppImage beta builds are produced by CI and attached to each release.
Agent-friendly by design: start at AGENTS.md, the glossary in CONTEXT.md, and decisions in docs/adr/.
MiseDeck is a community project, not affiliated with or endorsed by the official mise project.