OpenSource-Hub
M

mise

SHA-256
32.1k stars·Developer Tools·SHA-256 checksum verified

mise is a single CLI that manages dev tools, environment variables, and project tasks through a mise.toml file. Unlike asdf, it runs tools directly without shims; unlike direnv, it also handles tool versions and tasks. Simple, fast, and team-friendly.

Smart Download

Download Download Version

v2026.8.3 · 92.3 MB

One CLI to manage dev tools, environment variables, and tasks—clear and fast without shims.

Core Features

  • One file to rule them all: configure tools, environment variables, and tasks in mise.toml
  • No shims: uses real binary paths, faster and cleaner than asdf
  • Auto-load environment variables per directory, including .env files
  • Built-in task runner with dependency support
  • Install and switch versions for hundreds of tools (Node, Python, Go, Terraform, etc.)

What It Can't Do

  • mise uses real paths, not shims—some scripts or IDEs expecting asdf-style shims may need path adjustments
  • Don't blindly reuse another project's mise.toml; versions may be incompatible, test with your own stack
  • Tool downloads may slow down or fail in restricted networks; configure mirrors to match your environment
  • Windows native support is limited; the official recommendation is to use WSL for full functionality

Use Cases

  • Devs and teams who need to pin exact versions of Node, Python, or Go across projects without conflicts
  • Developers juggling multiple projects with different env vars and tools, wanting a single source of truth

Detailed Introduction

mise (mise-en-place) prepares your development environment before every command runs. It keeps project tools, environment variables, and task definitions in one mise.toml file, ensuring new shells, checkouts, and CI jobs all start from the same setup. You can install and switch between hundreds of dev tools (Node, Python, CMake, Terraform, etc.), load per-directory environment variables (including .env files), and define reusable build/test/deploy tasks. Compared to asdf, mise executes tools directly without shim overhead; compared to direnv, it also handles tool versions and tasks, not just environment variables. It supports macOS, Linux, and Windows (via WSL), integrates with all major shells, and is MIT-licensed.

Tags

dev-toolsenvironment-managertask-runnerversion-managerCLI

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Install the appropriate package for your distro (dpkg / rpm / AppImage)

3

Install mise: run curl https://mise.run | sh, verify with ~/.local/bin/mise --version

4

Add the activation line to your shell config (bash/zsh/fish/pwsh), e.g. echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc, then reload your shell

5

Create a mise.toml in your project, add tools/env/tasks (see README), then run mise install and mise run build to get started

Install Guide
  1. Install mise: run curl https://mise.run | sh, verify with ~/.local/bin/mise --version
  2. Add the activation line to your shell config (bash/zsh/fish/pwsh), e.g. echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc, then reload your shell
  3. Create a mise.toml in your project, add tools/env/tasks (see README), then run mise install and mise run build to get started
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

b09bfe160ffa33236f03547e6e0ef2bd937fcd7556b1feb5c2d227c174ef2a22

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Remove the mise binary (generally ~/.local/bin/mise), delete the activation line you added to your shell config, and optionally delete data/config directories (~/.local/share/mise, ~/.config/mise) to fully clean up.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-08-08T03:43:09Z
GitHub RepositoryOfficial Website

Similar Projects