jdx/mise

▲ 42 stars today★ 35,854⑂ 1,527

dev tools, env vars, task runner

About jdx/mise

jdx/mise is an open-source project on GitHub, mainly written in Rust. dev tools, env vars, task runner It currently holds 35,854 stars and 1,527 forks with 19 open issues, and was last pushed on 2026-11-06 (repository created 2023-01-09).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #83 with 42 new stars today.

GitHub Repository Details

Repository jdx/mise · default branch main · size 160990 KB · watchers 46 · source: GitHub REST API and repository README

README

https://github.com/jdx/mise/blob/HEAD/mise
mise-en-place

https://github.com/jdx/mise/blob/HEAD/Crates.io https://github.com/jdx/mise/blob/HEAD/GitHub https://github.com/jdx/mise/blob/HEAD/GitHub Workflow Status https://github.com/jdx/mise/blob/HEAD/Discord

https://github.com/jdx/mise/blob/HEAD/Star History Rank https://github.com/jdx/mise/blob/HEAD/GitHub Trending Repository of the Day

Dev tools, env vars, and tasks in one CLI

Getting started • Docs • Dev tools • Environments • Tasks • Bootstrap

Sponsored by

https://github.com/jdx/mise/blob/HEAD/Entire     https://github.com/jdx/mise/blob/HEAD/Omacom Foundation

View all sponsors


What is mise?

mise (pronounced "meez", short for _mise-en-place_) manages a project's dev tools, environment variables, and tasks from one mise.toml that works across your shell, editor, and CI:

[tools]
node = "24"
python = "3.14"
rust = "stable"
"cargo:cargo-nextest" = "0.9"
"github:BurntSushi/ripgrep" = "15"
"npm:prettier" = "3"

[env] NODE_ENV = "development" _.file = ".env" _.path = "./node_modules/.bin"

[tasks.build] description = "Build the application" run = "npm run build"

[tasks.test] description = "Run the test suite" depends = ["build"] run = "pytest && npm test"

Go, Rust, and Terraform from a registry of 1,000+ tools or directly from backends like GitHub releases, Aqua, Cargo, npm, and PyPI, with separate versions per project. files, PATH entries, virtualenvs, and secrets automatically as you enter a directory. in mise-tasks/, with dependencies, parallel execution, file watching, and the project's tools and environment already configured. and mise dot apply to apply system packages, dotfiles, Git repositories, macOS defaults, and background services.

Adopt only the parts you need. Start with a single tool or task, and keep any existing .tool-versions files as they are; mise also reads .nvmrc, .python-version, and other idiomatic version files once enabled.

Demo of mise managing tools

See the demo transcript for the commands shown above.

Quickstart

1. Install mise

On macOS or Linux:

curl -fsSL https://mise.run | sh
~/.local/bin/mise --version

On Windows, run winget install jdx.mise. For Homebrew, apt, dnf, Scoop, and other package managers, see Installing mise.

The installer places the binary at ~/.local/bin/mise. If ~/.local/bin is not on your PATH yet, run ~/.local/bin/mise in place of mise until you activate mise in step 4.

2. Run a tool without changing your shell

mise exec node@24 -- node --version

v24.x.x

mise exec downloads Node.js 24 if needed and runs the command after -- with that version on PATH. Your shell and config files stay untouched.

3. Configure a project

Create a project directory, select Node.js 24, set an environment variable, and add a task:

mkdir my-project && cd my-project
mise use node@24
mise set NODE_ENV=development
mise tasks add hello -- node -e "console.log(process.version, process.env.NODE_ENV)"

These commands install Node.js 24 and write mise.toml:

[tools]
node = "24"

[env] NODE_ENV = "development"

[tasks.hello] run = 'node -e "console.log(process.version, process.env.NODE_ENV)"'

Run the task with mise run:

mise run hello

[hello] $ node -e "console.log(process.version, process.env.NODE_ENV)"

v24.x.x development

Commit mise.toml so teammates and CI get the same setup when they run mise install or mise run. "24" requests the latest release in the Node.js 24 series; run mise lock to record exact versions and checksums in a lockfile, or mise use --global node@24 to set a personal default in ~/.config/mise/config.toml.

4. Activate mise in your shell (optional)

Shell activation updates PATH and project environment variables whenever you change directories, so you can invoke node directly without mise exec. If you installed with mise.run, run the command for your shell once, then open a new terminal:

# bash
echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc

zsh

echo 'eval "$(~/.local/bin/mise activate zsh)"' >> "${ZDOTDIR:-$HOME}/.zshrc"

fish

mkdir -p ~/.config/fish echo '~/.local/bin/mise activate fish | source' >> ~/.config/fish/config.fish

If a package manager installed mise, use mise in place of ~/.local/bin/mise. With Homebrew, fish activates mise without this step.

For PowerShell, Nushell, Elvish, Xonsh, and IDE or CI shims, see Shell setup and Shims.

Everyday commands

| Command | Action | | --------------------------- | ----------------------------------------------------------------- | | mise use node@24 | Install a tool and record it in the current project's mise.toml | | mise use --global node@24 | Install a tool and set it as your global default | | mise install | Install all tools declared in the active config files | | mise exec -- | Run a command with the project's tools and environment | | mise run | Run a project task with its dependencies, tools, and environment | | mise set KEY=value | Set an environment variable in mise.toml | | mise env | Print the resolved environment variables and PATH changes | | mise ls --current | List the tool versions active in the current directory | | mise outdated | List tools with newer releases than the installed version | | mise upgrade | Install those newer releases | | mise lock | Write exact tool versions and checksums to mise.lock | | mise config ls | Show the config files loaded for the current directory | | mise doctor | Check your mise installation, shell activation, and configuration |

Set up a machine with mise bootstrap

Beyond project directories, ~/.config/mise/config.toml can declare the state of your machine:

[bootstrap.packages]
"apt:build-essential" = "latest"
"brew:jq" = "latest"

[bootstrap.repos] "~/src/app" = { url = "https://github.com/you/app.git" }

[dotfiles] "~/.zshrc" = { mode = "track" }

Preview and apply the configuration, or bootstrap a new machine directly from a Git repository:

mise bootstrap --dry-run
mise bootstrap
mise bootstrap --adopt you/dotfiles

See Bootstrap and Dotfiles for supported package managers, dotfile tracking and templating, services, and remote SSH targets.

Documentation

| Topic | Guides | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Onboarding | Getting started · Existing projects · Migrating from asdf | | Dev tools | Dev tools · Registry · Backends · Lockfile | | Environments and tasks | Environments · Secrets · Tasks · Task configuration | | Machine setup | Bootstrap · Packages · Dotfiles · Services | | Shells, editors, and CI | Shell setup · Shims · Editors and IDEs · Continuous integration | | Reference and troubleshooting | mise.toml · Settings · CLI reference · Troubleshooting · FAQ | | Contributing | Contributing · Writing docs |

Get help

Troubleshooting first, and include the command you ran, a minimal mise.toml, the expected and actual behavior, and your mise doctor output after reviewing it for private details. GitHub Discussions. For security reports and other inquiries, see Contact.

Special thanks

https://github.com/jdx/mise/blob/HEAD/Namespace
Thanks to Namespace for providing CI services for mise.

Contributors

Contributors

GitHub Stars & Activity

35,854Stars
1,527Forks
19Open issues
RustLanguage

GitHub Popularity

GitHub stars35,854
Forks1,527
Open issues19
Primary languageRust
LicenseMIT
Stars gained today42
Created2023-01-09
Last pushed2026-11-06

Trending History

Daily boardrank #83 · ▲ 42 stars

Related GitHub Projects

1

clash-verge-rev / clash-verge-rev

Rust★ 156,669⑂ 11,258▲ 246 stars
→
2

openai / codex

Rust★ 133,427⑂ 21,150▲ 172 stars
→
3

rustdesk / rustdesk

Rust★ 128,399⑂ 20,387▲ 139 stars
→
4

pbakaus / impeccable

Rust★ 104,331⑂ 6,187▲ 1,280 stars
→
5

vercel-labs / agent-browser

Rust★ 46,201⑂ 3,164▲ 150 stars
→
6

longbridge / gpui-kit

Rust★ 19,542⑂ 1,214▲ 285 stars
→
7

vercel-labs / agent-desktop

Rust★ 17,619⑂ 1,255▲ 2,173 stars
→
8

max-sixty / worktrunk

Rust★ 11,711⑂ 449▲ 546 stars
→

More Trending Repositories