https://github.com/jdx/mise

dev tools, env vars, task runner
https://github.com/jdx/mise

Last synced: 7 days ago
JSON representation

dev tools, env vars, task runner

• Host: GitHub
• URL: https://github.com/jdx/mise
• Owner: jdx
• License: mit
• Created: 2023-01-09T14:44:21.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-04-16T16:36:48.000Z (7 days ago)
• Last Synced: 2025-04-16T18:34:56.568Z (7 days ago)
• Language: Rust
• Homepage: https://mise.jdx.dev
• Size: 23.2 MB
• Stars: 14,738
• Watchers: 31
• Forks: 458
• Open Issues: 40
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Security: SECURITY.md
  • Roadmap: docs/roadmap.md

Awesome Lists containing this project

• my-awesome-github-stars - jdx/mise - dev tools, env vars, task runner (Rust)
• awesome-github-repos - jdx/mise - dev tools, env vars, task runner (Rust)
• awesome-version-managers - mise - An `asdf` drop-in replacement written in Rust. (Version Managers / Generic)
• jimsghstars - jdx/mise - dev tools, env vars, task runner (Rust)
• definitive-opensource - mise
• awesome-repositories - jdx/mise - dev tools, env vars, task runner (Rust)
• awesomeLibrary - mise - dev tools, env vars, task runner (语言资源库 / rust)
• stars - mise
• stars - mise
• stars - jdx/mise - dev tools, env vars, task runner (Rust)
• awesome-rust-tools - mise
• awesome-rainmana - jdx/mise - dev tools, env vars, task runner (Rust)

README

        




  


  mise-en-place











The front-end to your dev env.



## What is it?

- Like [asdf](https://asdf-vm.com) (or [nvm](https://github.com/nvm-sh/nvm) or [pyenv](https://github.com/pyenv/pyenv) but for any language) it manages [dev tools](https://mise.jdx.dev/dev-tools/) like node, python, cmake, terraform, and [hundreds more](https://mise.jdx.dev/registry.html).

- Like [direnv](https://github.com/direnv/direnv) it manages [environment variables](https://mise.jdx.dev/environments/) for different project directories.

- Like [make](https://www.gnu.org/software/make/manual/make.html) it manages [tasks](https://mise.jdx.dev/tasks/) used to build and test projects.

## Demo

The following demo shows how to install and use `mise` to manage multiple versions of `node` on the same system.

Note that calling `which node` gives us a real path to node, not a shim.

It also shows that you can use `mise` to install and many other tools such as `jq`, `terraform`, or `go`.

[![demo](./docs/tapes/demo.gif)](https://mise.jdx.dev/demo.html)

See [demo transcript](https://mise.jdx.dev/demo.html).

## Quickstart

### Install mise

See [Getting started](https://mise.jdx.dev/getting-started.html) for more options.

```sh-session

$ curl https://mise.run | sh

$ ~/.local/bin/mise --version

2025.4.4 macos-arm64 (a1b2d3e 2025-04-15)

```

Hook mise into your shell (pick the right one for your shell):

```sh-session

# note this assumes mise is located at ~/.local/bin/mise

# which is what https://mise.run does by default

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

echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc

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

echo '~/.local/bin/mise activate mise activate pwsh | Out-String | Invoke-Expression' >> ~/.config/powershell/Microsoft.PowerShell_profile.ps1

```

### Execute commands with specific tools

```sh-session

$ mise exec node@22 -- node -v

mise node@22.x.x ✓ installed

v22.x.x

```

### Install tools

```sh-session

$ mise use --global node@22 go@1

$ node -v

v22.x.x

$ go version

go version go1.x.x macos/arm64

```

See [dev tools](https://mise.jdx.dev/dev-tools/) for more examples.

### Manage environment variables

```toml

# mise.toml

[env]

SOME_VAR = "foo"

```

```sh-session

$ mise set SOME_VAR=bar

$ echo $SOME_VAR

bar

```

Note that `mise` can also [load `.env` files](https://mise.jdx.dev/environments/#env-directives).

### Run tasks

```toml

# mise.toml

[tasks.build]

description = "build the project"

run = "echo building..."

```

```sh-session

$ mise run build

building...

```

See [tasks](https://mise.jdx.dev/tasks/) for more information.

### Example mise project

Here is a combined example to give you an idea of how you can use mise to manage your a project's tools, environment, and tasks.

```toml

# mise.toml

[tools]

terraform = "1"

aws-cli = "2"

[env]

TF_WORKSPACE = "development"

AWS_REGION = "us-west-2"

AWS_PROFILE = "dev"

[tasks.plan]

description = "Run terraform plan with configured workspace"

run = """

terraform init

terraform workspace select $TF_WORKSPACE

terraform plan

"""

[tasks.validate]

description = "Validate AWS credentials and terraform config"

run = """

aws sts get-caller-identity

terraform validate

"""

[tasks.deploy]

description = "Deploy infrastructure after validation"

depends = ["validate", "plan"]

run = "terraform apply -auto-approve"

```

Run it with:

```sh-session

mise install # install tools specified in mise.toml

mise run deploy

```

Find more examples in the [mise cookbook](https://mise.jdx.dev/mise-cookbook/).

## Full Documentation

See [mise.jdx.dev](https://mise.jdx.dev)

## Contributors

[![Contributors](https://contrib.rocks/image?repo=jdx/mise)](https://github.com/jdx/mise/graphs/contributors)