菜单
Use when debugging runtime version issues, toolchain not found errors, or version conflicts across projects. Symptoms - wrong node/rust/python/go version active, mise shim errors, RUSTUP_TOOLCHAIN conflicts, tool not found after install, global version overriding project version.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | mise-toolchains |
| description | Use when debugging runtime version issues, toolchain not found errors, or version conflicts across projects. Symptoms - wrong node/rust/python/go version active, mise shim errors, RUSTUP_TOOLCHAIN conflicts, tool not found after install, global version overriding project version. |
mise manages language runtimes (Rust, Node, Python, Go, uv) via .mise.toml files. Two config layers interact — this is the most common source of toolchain confusion:
| File | Scope |
|---|---|
<repo>/.mise.toml | Project-local runtimes + tasks |
~/.config/mise/config.toml | Global — pins override project entries silently |
When a toolchain behaves unexpectedly, check global config first.
# Step 1: What versions are actually active?
mise current
# Step 2: Global overrides?
cat ~/.config/mise/config.toml
# Step 3: Conflicts, missing tools
mise doctor
# Step 4: Ensure installed
mise install
# Step 5: Env var overrides?
printenv | grep -i mise
mise sets RUSTUP_TOOLCHAIN so cargo uses the right version:
echo $RUSTUP_TOOLCHAIN # should match .mise.toml rust version
mise which cargo # confirm shim resolves correctly
rustc --version # verify
mise install # install all tools from .mise.toml
mise current # show active versions in cwd
mise ls # list installed versions
mise ls --current # active version per tool
mise which <binary> # show path a shim resolves to
mise use rust@1.84 # set version in .mise.toml
mise use -g node@22 # set global version
.mise.toml doubles as a task runner ([tasks.<name>] sections with run, description, depends). Three equivalent runners:
mise run <task> # interactive / default
just <recipe> # automation / agents
make <target> # compat wrapper
mise tasks # list tasks
mise run menu # interactive TUI task picker
| Mistake | Fix |
|---|---|
Project version wrong despite .mise.toml | Check ~/.config/mise/config.toml for global override |
Tool not found after mise install | Reload shell: exec $SHELL or open new terminal |
cargo uses wrong toolchain | RUSTUP_TOOLCHAIN set by mise — check mise current |
| Task not found | Check spelling; tasks live in .mise.toml, not mise.local.toml |
mise run fails with env error | mise.local.toml (gitignored) for machine-specific env overrides |
Deep codebase analysis — architecture health, test coverage gaps, tech debt, and actionable findings
Run pre-commit checks (fmt, clippy, test) then stage, commit, and push with a conventional message
Review staged or recent changes for correctness, style, and Rust conventions before committing
Use when SSHing into remote machines, looking up credentials, renaming Tailscale devices, or accessing services on the tailnet. Symptoms - SSH auth failures, too many authentication failures, command not found tailscale, need to find credentials for remote machines.
Use when mixing Tokio async code with synchronous blocking I/O libraries (tar, flate2, zip, csv), or when seeing "cannot block the current thread from within the async context" panics, or needing to stream async bytes into a sync reader.
Structured BAML schema edit → validate → test loop for the devloop project. Use when editing any *.baml file in crates/baml/baml_src/ — covers version parity gotchas, uvx invocation, regeneration workflow, and the analyze verify step.