MiseDeck
v1.1.0

MiseDeck

mise 的命令行,长成一个桌面应用。 The mise CLI, as a desktop app.

八个页面,每个对应 CLI 的一部分。安装、切换、升级、写入环境变量——每一步都真的执行一条 mise 命令,命令行、日志与退出码原样留在执行面板里。 Eight pages, each one a part of the CLI. Install, switch, upgrade, write an env var — every step runs a real mise command, and the panel keeps the argv, the logs, and the exit code exactly as they were.

独立的社区项目,与 mise 及其维护者没有隶属关系。macOS(Apple Silicon)打磨完成;Windows x64 与 Linux 为 beta。 An independent community project, not affiliated with mise or its maintainer. macOS on Apple Silicon is polished; Windows x64 and Linux are beta.

MIT licensed Tauri 2 + React macOS · Windows · Linux mise ≥ 2025.12.5

Pages

CLI 的哪一部分,就对应哪一页。 Each page is one part of the CLI.

不发明新概念:界面里的每个动作,都是一条 mise 命令。 No invented concepts: every action in the UI is a mise command.

mise version · mise self-update

首页Home

版本门禁、引导安装、一键自更新。 Version gate, guided install, one-click self-update.

mise ls · mise registry · mise ls-remote · mise install · mise use · mise uninstall · mise upgrade · mise unuse · mise outdated · mise link

工具Tools

已安装与已激活的工具;安装、切换版本、升级过时版本。 Installed and active tools; install, switch versions, upgrade outdated ones.

mise trust · mise ls · mise env · mise config ls

概览Overview

解析出的工具与环境变量、配置文件优先级、mise.lock,每行都标注来源。 Resolved tools and env vars, config files in precedence order, mise.lock — every row labeled with its source.

mise env · mise set · mise unset

环境变量Env

增删改环境变量,标注来源;超出写入范围时先提醒。 Add, edit, and unset variables with source badges; warns when a var sits outside the write scope.

mise tasks ls · mise run · mise tasks add · mise tasks edit · mise config ls

任务Tasks

列出、实时运行、创建与编辑 mise 任务。 List, run with live output, create, and edit mise tasks.

mise settings ls · mise settings set · mise settings unset

设置Settings

查看、筛选、修改 mise 设置,表类型键只读。 View, filter, and edit mise settings; table-typed keys are read-only.

mise doctor

诊断Doctor

健康状态、shell 激活、警告,以及一份可复制的报告。 Health, shell activation, warnings, and a report you can copy into a bug.

mise plugins ls · mise plugins install · mise plugins uninstall

插件Plugins

已安装插件、从 git 地址安装、卸载。 Installed plugins, install from a git URL, uninstall.

Execution panel

每一步都真的执行一条命令,过程原样可见。 Every action really runs a command, and you watch it happen.

执行面板记下确切的命令行、工作目录、逐行日志、耗时与退出码,可以随时复制命令。 The panel keeps the exact argv, the working directory, the streamed logs, the duration, and the exit code — copy the command whenever you need it.

执行面板Execution panel
$ mise use node@lts
✔ node@lts · 24.22.3 · 已安装· 24.22.3 · installed
解析自Resolved from ./mise.toml
$ mise env --json-extended
NODE_HOME /Users/you/.local/share/mise/installs/node/24.22.3
exit 0 · 0.4s · 复制命令· 0.4s · copy command

Screens

真的长这样。 This is what it actually looks like.

英文与简体中文界面,浅色主题。点击任意截图可放大查看。 English and Simplified Chinese, light theme. Click a screenshot to view it full size.

首页Home — 版本门禁、引导安装、一键自更新。 — the version gate, a guided install, one-click self-update.
概览Overview — 当前目录解析出的环境与配置文件。 — what the current directory resolves to.
工具Tools — 已安装与已激活的工具,一行看清来源。 — installed and active tools, each row with its source.
工具 · 版本管理Tools · Manage versions — 按版本安装、切换、升级:已激活、已安装、未安装,一屏看清。 — install, switch, and upgrade per version: active, installed, and not installed in one view.
环境变量Env — 解析结果带来源徽标,写入范围外会先提醒。 — resolved values with source badges; out-of-scope writes warn first.
任务Tasks — 任务的列表、运行与编辑。 — list, run, and edit tasks.
插件Plugins — 已安装插件,可从 git 地址安装或卸载。 — installed plugins; install from a git URL, uninstall.
诊断Doctor — mise doctor 的结果,报告可直接复制。 — mise doctor's report, copyable as is.
设置Settings — mise 的设置项与来源。 — mise's settings and where they come from.

Install

从 GitHub Releases 下载。 Download from GitHub Releases.

MiseDeck 调用 mise 的命令行,不捆绑它:机器上需要 mise ≥ 2025.12.5,首页可以引导安装。 MiseDeck calls the mise CLI rather than bundling it: mise ≥ 2025.12.5 must be on the machine — the Home page can guide the install.

macOSmacOS Apple SiliconApple Silicon

下载 dmg,拖入「应用程序」。没有 Intel macOS 构建;需要请从源码构建。Download the dmg, drag it into Applications. No Intel macOS build — build from source if you need one.

MiseDeck_1.1.0_aarch64.dmg

WindowsWindows x64 · beta

NSIS 安装包,无需管理员权限。NSIS installer, no administrator rights needed.

MiseDeck_1.1.0_x64-setup.exe

LinuxLinux x86_64 · beta

deb / rpm / AppImage。deb / rpm / AppImage.

MiseDeck_1.1.0_amd64.deb

每个发布都附带 SHA256SUMS: Every release ships a SHA256SUMS manifest: shasum -a 256 -c SHA256SUMS

macOS 构建未签名、未公证。首次打开会被 Gatekeeper 拦住:拖进「应用程序」后执行 xattr -dr com.apple.quarantine /Applications/MiseDeck.app,或在「系统设置 → 隐私与安全性」里点「仍要打开」。Windows 构建同样未签名,SmartScreen 提示时选「更多信息 → 仍要运行」。 The macOS build is unsigned and not notarized. Gatekeeper blocks the first launch: after dragging the app into Applications run xattr -dr com.apple.quarantine /Applications/MiseDeck.app, or use System Settings → Privacy & Security → Open Anyway. The Windows build is unsigned too — when SmartScreen appears, choose More info → Run anyway.

FAQ

常见问题。 Questions.

MiseDeck 和 mise 是什么关系? How is MiseDeck related to mise?

MiseDeck 是独立的社区项目,与 mise 及其维护者没有隶属关系。它只是给 mise 的命令行套了一层图形界面:界面里的每个动作,底层都是一条真实的 mise 命令。 MiseDeck is an independent community project, not affiliated with mise or its maintainer. It is a graphical layer over the mise CLI: every action in the UI is a real mise command underneath.

会捆绑 mise 吗? Does it bundle mise?

不会。MiseDeck 调用你机器上的 mise,需要 mise ≥ 2025.12.5。如果没装,首页会给出引导安装。 No. MiseDeck calls the mise on your machine and needs mise ≥ 2025.12.5. If it is missing, the Home page offers a guided install.

支持哪些平台? Which platforms are supported?

macOS(Apple Silicon)打磨完成;Windows x64 能跑,已在真实机器上走通,安装包也已实测安装;Linux 提供 deb / rpm / AppImage,但尚未在真实桌面环境验证。 macOS on Apple Silicon is polished. Windows x64 runs and has been exercised end-to-end on real hardware, including the installer. Linux ships deb / rpm / AppImage but is not yet verified on a real desktop.

macOS 上打不开怎么办? macOS says the app is damaged — now what?

那是 Gatekeeper 的隔离标记,不是文件损坏。执行 xattr -dr com.apple.quarantine /Applications/MiseDeck.app 即可;也可以在「系统设置 → 隐私与安全性」里点「仍要打开」。 That is Gatekeeper's quarantine flag, not a corrupted download. Run xattr -dr com.apple.quarantine /Applications/MiseDeck.app, or use System Settings → Privacy & Security → Open Anyway.

我的数据会离开本机吗? Does any of my data leave the machine?

不会。MiseDeck 没有账号、没有遥测,所有读取与写入都发生在本机,通过 mise 命令完成。对外请求只有两个,都是版本检查:手动触发的「检查 MiseDeck 更新」,以及启动十秒后的静默检查(最多一天一次)。两者读的是同一份 release feed——MiseDeck 不会下载或安装任何构建,发现新版本时只会指向它的发布页。 No. MiseDeck has no account and no telemetry; every read and write happens locally, through mise. Two outbound requests exist, and both are version checks: the manual Check for MiseDeck updates, and a silent check ten seconds after launch (at most once a day). Both read the same releases feed — MiseDeck never downloads or installs a build; a newer version only ever points at its Release page.

能和 mise CLI 一起用吗? Can I keep using the mise CLI alongside it?

可以,两者操作的是同一份配置。你在终端里 mise use 过的版本,MiseDeck 里立刻能看到;反过来也一样。 Yes — both act on the same configuration files. A version you use in the terminal shows up in MiseDeck immediately, and the other way round works too.