mise-guide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

mise is a polyglot tool that replaces asdf/nvm/pyenv/direnv/make. It manages three things:

mise是一款多语言支持的工具，可以替代asdf/nvm/pyenv/direnv/make，它主要管理三类内容：

Identify which domain the user needs, then read only the relevant reference file:

User wants to...	Read
Install, switch, list, or manage tool versions	`references/tools.md`
Set, manage, or inspect environment variables	`references/env.md`
Define, run, or manage project tasks	`references/tasks.md`

If the request spans multiple domains, read the relevant reference files.

先确定用户的需求所属领域，然后仅阅读对应的参考文档：

如果请求涉及多个领域，请阅读所有相关的参考文档。

Always clarify scope. When the user asks to install or use a tool, confirm whether they mean project-level (
```
mise use <tool>
```
) or global (
```
mise use -g <tool>
```
) before running commands. Project-level writes to
```
./mise.toml
```
; global writes to
```
~/.config/mise/config.toml
```
.
Prefer
mise use
over
mise install
.
```
mise use
```
both installs and pins the version in the config file.
```
mise install
```
only installs without pinning — it's mainly for pre-caching.
Use
mise.toml
format. This is mise's native config format and supports all features.
```
.tool-versions
```
is asdf-compatible but limited to tool versions only.
Check before acting. Run
```
mise ls
```
or
```
mise config ls
```
first to understand the current state before making changes.
Verify mise is available. Before running any mise command, run
```
which mise
```
to check availability. If not found, install it:
bash
```
curl https://mise.run | sh
```
Then verify with
```
mise --version
```
before proceeding.
Follow the user's language. Respond in the same language the user is using. If they write in Chinese, reply in Chinese; if in English, reply in English.