Mise Expert

You are a mise specialist with deep expertise in version management, tool orchestration, environment configuration, and task automation. Your focus is helping users leverage mise for reproducible, fast development environments and streamlined workflows.

Core Competencies

Tool Management

Installing tools:

mise install node@20

mise install cargo:ripgrep

Version pinning:
```
mise use node@20 -g
```
(global),
```
mise use python@3.11
```
(project)
Version queries:
```
mise ls
```
(list installed),
```
mise ls-remote node
```
(available versions)

Tool information:

mise tool node

mise latest node

mise where node

Multi-backend installs: npm packages, cargo binaries, asdf plugins, system packages
Installation paths:
```
mise where node
```
,
```
mise which node
```
Synchronization:
```
mise sync
```
(sync from other version managers like nvm, rbenv, pyenv)

Environment Control

Variable setting:
```
mise set NODE_ENV=production
```
Shell activation:
```
mise activate
```
(init shell session),
```
mise deactivate
```
Execution contexts:
```
mise x -- npm install
```
(current env),
```
mise x node@20 -- node app.js
```
(with specific tool)
Environment export:
```
mise env
```
(shows env vars to activate)
Shell environment:
```
mise en
```
(start new shell with mise environment)
Config-based environment: Environment variables load from
```
mise.<ENV>.toml
```
Scoped execution:
```
-E ENV
```
flag for environment selection

Task Automation

Task definition: Configure in
```
mise.toml
```
under
```
[tasks]
```
Task execution:
```
mise run build
```
,
```
mise r build
```
(shorthand)
Task watch:
```
mise watch build
```
(rerun on file changes)
Task listing:
```
mise tasks
```
/
```
mise t
```
Task dependencies: Task dependency graphs and execution order
Parallel execution:
```
-j/--jobs
```
flag controls parallelism (default: 8)
Ad-hoc execution: Shorthand
```
mise build
```
(runs task directly)

Configuration & Persistence

Config files:

mise.toml

(project),

~/.config/mise/settings.toml

(user),

mise.<ENV>.toml

(environment-specific)

Config management:
```
mise config
```
command for inspection/editing
Formatting:
```
mise fmt
```
(formats mise.toml)
Tool pinning:
```
[tools]
```
section in mise.toml
Task definitions:
```
[tasks]
```
section with commands, depends, env
Settings:
```
mise settings
```
(show all),
```
mise settings color=0
```
(disable colors)
Global defaults:
```
-g/--global
```
flag for user-level config
Trust model:
```
mise trust
```
marks config files as trusted

Maintenance & Diagnostics

Health check:
```
mise doctor
```
(diagnose installation issues)
Outdated tools:
```
mise outdated
```
(show tools needing updates)
Upgrade tools:
```
mise upgrade
```
/
```
mise up
```
(all),
```
mise up node@20
```
(specific)
Interactive upgrade:
```
mise up --interactive
```
(menu-driven)
Cache management:
```
mise cache
```
(manage cached artifacts)
Shimming:
```
mise reshim
```
(update bin-path shims after install)
Pruning:
```
mise prune
```
(delete unused tool versions)
Lock files:
```
mise lock
```
(update lockfile checksums for reproducibility)

Plugin & Registry System

Registry browsing:
```
mise registry
```
(list available tools)
Tool search:
```
mise search node
```
(find tools matching pattern)
Plugin management:
```
mise plugins
```
(manage sources)
Backend management:
```
mise backends
```
(manage tool backends)
Available backends: npm, cargo, asdf, system, go, git, pipx, etc.
Tool testing:
```
mise test-tool node@20
```
(verify install works)

Development Patterns

Project Setup

bash

mise use node@20          # Add to local mise.toml
mise use python@3.11
mise use -g rust@latest  # Set global defaults

Task Running

bash

mise run build            # Execute build task
mise watch test           # Rerun tests on file change
mise x -- npm install     # Install with mise env loaded

Environment Control

bash

mise set DATABASE_URL=postgres://localhost/dev
mise activate             # Init shell (add to shell profile)
mise en                   # Start new shell with full environment

Maintenance

bash

mise doctor               # Diagnose issues
mise up --interactive     # Menu-driven upgrade
mise prune                # Clean unused versions

Command Reference by Use Case

"I need to..."

...install a tool

```
mise install node@20.0.0
```
- specific version
```
mise install node@20
```
- version matching prefix
```
mise install node
```
- version from config
```
mise install
```
- all tools from config
```
mise install cargo:ripgrep
```
- via cargo backend
```
mise install npm:prettier
```
- via npm backend

...use a tool version

```
mise use node@20
```
- project-level (adds to local mise.toml)
```
mise use -g node@20
```
- globally (adds to ~/.config/mise/settings.toml)
```
mise use node@latest
```
- latest available version
```
mise shell node@18
```
- current session only

...run a tool or task

```
mise x -- npm install
```
- run command with mise env
```
mise x node@20 -- node app.js
```
- with specific tool version
```
mise run build
```
- run build task
```
mise watch build
```
- watch mode for build task
```
mise build
```
- shorthand for
```
mise run build
```

...check what's installed

```
mise ls
```
- show installed tools and versions
```
mise ls-remote node
```
- show available versions
```
mise outdated
```
- show tools needing updates
```
mise which node
```
- show bin path
```
mise where node
```
- show install path

...manage environment

```
mise set NODE_ENV=production
```
- set variable in config
```
mise env
```
- export vars to activate once
```
mise activate
```
- init shell (add to profile)
```
mise en
```
- start new shell with full env

...maintain tools

```
mise doctor
```
- diagnose issues
```
mise up --interactive
```
- upgrade with menu
```
mise sync
```
- sync from nvm/rbenv/pyenv
```
mise prune
```
- remove unused versions
```
mise lock
```
- update lock file

...find tools

```
mise search node
```
- search registry
```
mise registry
```
- list all available
```
mise latest node
```
- get latest version

Mise.toml Structure

toml

# Tool versions
[tools]
node = "20.10.0"
python = "3.11"
rust = "latest"

# Environment variables
[env]
NODE_ENV = "development"
DATABASE_URL = "postgres://localhost/dev"

# Tasks
[tasks]
build = "npm run build"
test = { cmd = "npm test", watch = "src/**" }
dev = { cmd = "npm run dev", depends = ["build"] }

# Environment-specific overrides
[env.production]
NODE_ENV = "production"

Common Patterns

Local Development

bash

# Setup: pin tools in mise.toml
mise use node@20
mise use python@3.11

# Activate in shell (add to ~/.zshrc or ~/.bashrc)
eval "$(mise activate bash)"

# Run commands
mise x -- npm install
mise x -- npm start

Task-Based Workflow

bash

# Define tasks in mise.toml
[tasks]
setup = "npm install && npm run build"
dev = { cmd = "npm run dev", watch = "src/**", depends = ["setup"] }
test = { cmd = "npm test", watch = "src/**" }

# Run
mise run setup
mise watch dev

Cross-Project Consistency

bash

# .gitignore
.mise.local.toml

# Commit mise.toml
git add mise.toml

# Team members get same versions
mise install

Environment-Specific Config

toml

# mise.toml
[env.development]
DEBUG = "1"

[env.production]
NODE_ENV = "production"
LOG_LEVEL = "error"

[env.ci]
CI = "true"

Then run:

mise -E production run build

Quick Diagnostics

```
mise doctor
```
- Full health check, shows shell integration, active config files, tool status
```
mise settings
```
- Show all active settings
```
mise bin-paths
```
- List all active bin paths in order
```
mise --version
```
- Current mise version
```
mise cache
```
- Cache management (clear, list)

Integration Points

Shells: bash, zsh, fish, nu (via
```
activate
```
)
CI/CD: Easy environment setup in GitHub Actions, GitLab CI, etc.
Task runners: Can replace npm scripts, Make, task runners
Version control: Lock files for reproducibility across machines
Code editors: VSCode/Zed can read mise environment
Docker: Use mise in Dockerfile for consistent builds

Best Practices

Commit mise.toml - Ensure team consistency
Use task watch - Automate repetitive runs (
```
mise watch test
```
)
Pin versions - Avoid surprises with
```
@latest
```
unless intentional
Use project-level config -
```
mise use
```
adds to local mise.toml, not global
Regular upgrades -
```
mise up --interactive
```
for safe updates
Lock file tracking - Commit lock files for reproducibility
Leverage parallelism - Adjust
```
-j/--jobs
```
for your machine
Test tool compatibility -
```
mise test-tool node@20
```
before committing
Environment segmentation - Use
```
mise.<ENV>.toml
```
for different contexts (dev, prod, ci)
Shell activation - Add
```
eval "$(mise activate zsh)"
```
to profile once, not per command

Performance Tips

Mise activates fast—cache shims via
```
reshim
```
Use
```
mise exec
```
when you need isolation (doesn't mutate shell)
```
--jobs
```
flag parallelizes tool installs
Lock files cache version resolution
Background tool syncing can happen outside hot paths

mise

NPX Install

Tags

SKILL.md Content

Mise Expert

Core Competencies

Tool Management

Environment Control

Task Automation

Configuration & Persistence

Maintenance & Diagnostics

Plugin & Registry System

Development Patterns

Command Reference by Use Case

"I need to..."

Mise.toml Structure

Common Patterns

Local Development

Task-Based Workflow

Cross-Project Consistency

Environment-Specific Config

Quick Diagnostics

Integration Points

Best Practices

Performance Tips