3 +description: "Use when editing/diagnosing mise: mise.toml, tools, env vars, tasks, activation, shims, trust, or backends."
8 +Mise declares project tools, env, and tasks in TOML.
12 +- Config = system/user/global + project/env files, discovered upward; use `mise config ls`, `-E`.
13 +- Shared config: `mise.toml`; legacy tools: `.tool-versions`; local/secrets: local config.
14 +- `[tools]` requests versions via backends; `[env]` changes env/PATH; `[tasks]` and task files run in mise context.
15 +- `activate` mutates shells; `exec`/`x` wraps one command; shims wrap executables.
16 +- Trust gates env/code effects; inspect directives, hooks, templates, sourced files, plugins/backends.
20 +1. Read config and repo conventions.
21 +2. Ask local CLI first: `mise --help`, `mise <cmd> --help`, `mise doctor`, `mise config ls`, `mise env`, `mise ls`, `mise tasks ls`.
22 +3. Fetch/cite docs for exact syntax, installs, backends, flags, or changed behavior.
23 +4. Probes: prefer `--no-config`; if loading config isolate `MISE_DATA_DIR`/`MISE_CACHE_DIR` and combine `MISE_AUTO_INSTALL=0`, `--dry-run`, `status`, `--path`/`--local`, `--skip-tools --no-deps`.
24 +5. Treat `use`, `settings`, aliases, bootstrap, dotfiles, prune/uninstall/implode as mutating unless dry-run/local.
25 +6. Make the smallest style-matching change; never print secrets from env files or `mise env`.
29 +- `mise trust --show` inspects state.
30 +- Never trust real config, trust all, or set trusted paths without explicit approval.
31 +- If blocked, name exact file + risky features; ask before trusting it.
32 +- Auto-trust only isolated temp configs you created.
36 +- Sources: `references/sources.md`.
37 +- Verified shape: `examples/patterns.md`.