https://github.com/jdx/mise

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

Last synced: 4 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 (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T00:17:52.000Z (about 2 months ago)
• Last Synced: 2024-10-29T11:28:55.547Z (about 1 month ago)
• Language: Rust
• Homepage: https://mise.jdx.dev
• Size: 14.8 MB
• Stars: 9,825
• Watchers: 30
• Forks: 280
• Open Issues: 260
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.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)
• awesome-repositories - jdx/mise - dev tools, env vars, task runner (Rust)
• awesomeLibrary - mise - dev tools, env vars, task runner (语言资源库 / rust)
• stars - mise
• stars - mise

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/plugins.html).

- Like [direnv](https://github.com/direnv/direnv) it manages [environment variables](https://mise.jdx.dev/environments.html) 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.

## 30 Second Demo

The following shows using mise to install different versions

of [node](https://nodejs.org).

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

[![demo](./docs/demo.gif)](./docs/demo.gif)

## Quickstart

Install mise (other methods [here](https://mise.jdx.dev/getting-started.html)):

```sh-session

$ curl https://mise.run | sh

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

2024.12.3 macos-arm64 (a1b2d3e 2024-12-08)

```

or install a specific a version:

```sh-session

$ curl https://mise.run | MISE_VERSION=v2024.5.16 sh

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

2024.5.16 macos-arm64 (8838098 2024-05-14)

```

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

```

Install a runtime and set it as the global default:

```sh-session

$ mise use --global node@20

$ node -v

v20.0.0

```

## 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)