https://github.com/jdx/mise
dev tools, env vars, task runner
https://github.com/jdx/mise
Last synced: 17 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 3 years ago)
- Default Branch: main
- Last Pushed: 2026-02-18T16:28:42.000Z (3 months ago)
- Last Synced: 2026-02-18T17:00:36.672Z (3 months ago)
- Language: Rust
- Homepage: https://mise.jdx.dev
- Size: 36 MB
- Stars: 24,697
- Watchers: 38
- Forks: 889
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-github-repos - jdx/mise - dev tools, env vars, task runner (Rust)
- awesome-platform-engineering - mise - development environment setup tool that manages dev tools, runtimes, envvars and task runners (Dependency management / Shell into containers)
- my-awesome-github-stars - jdx/mise - dev tools, env vars, task runner (Rust)
- awesomeLibrary - mise - dev tools, env vars, task runner (语言资源库 / rust)
- stars - jdx/mise - dev tools, env vars, task runner (Rust)
- awesome-rust-tools - mise
- stars - mise
- jimsghstars - jdx/mise - dev tools, env vars, task runner (Rust)
- awesome-version-managers - mise - An `asdf` drop-in replacement written in Rust. (Version Managers / Generic)
- my-awesome - jdx/mise - 05 star:28.2k fork:1.1k dev tools, env vars, task runner (Rust)
- fucking-awesome-rust - mise - Polyglot tool version manager and task runner; drop-in replacement for asdf with faster performance. [](https://github.com/jdx/mise/actions/workflows/test.yml) (Development tools / Workflow Automation)
- awesome-rainmana - jdx/mise - dev tools, env vars, task runner (Rust)
- awesome-cli - jdx/mise
- awesome-rust - mise - Polyglot tool version manager and task runner; drop-in replacement for asdf with faster performance. [](https://github.com/jdx/mise/actions/workflows/test.yml) (Development tools / Workflow Automation)
- definitive-opensource - mise
- awesome - jdx/mise - dev tools, env vars, task runner (Rust)
- awesome-rust-with-stars - mise - Polyglot tool version manager and task runner; drop-in replacement for asdf with faster performance. | 2026-04-05 | (Development tools / Workflow Automation)
README
mise-en-place
Dev tools, env vars, and tasks in one CLI
Getting Started •
Documentation •
Dev Tools •
Environments •
Tasks
> [!TIP]
> My latest project, [aube](https://aube.en.dev) just hit stable! It's the fastest Node.js package manager with strong security defaults and is compatible with npm/pnpm/yarn lockfiles!
## What is it?
`mise` prepares your development environment before each command runs. It keeps
project tools, environment variables, and tasks in one `mise.toml` file so new
shells, checkouts, and CI jobs all start from the same setup.
- Install and switch between [dev tools](https://mise.en.dev/dev-tools/) like node, python, cmake, terraform, and [hundreds more](https://mise.en.dev/registry.html).
- Load [environment variables](https://mise.en.dev/environments/) per project directory, including values from `.env` files and other sources.
- Define and run [tasks](https://mise.en.dev/tasks/) for building, testing, linting, and deploying 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`.
[](https://mise.en.dev/demo.html)
See [demo transcript](https://mise.en.dev/demo.html).
## Quickstart
### Install mise
See [Getting started](https://mise.en.dev/getting-started.html) for more options.
```sh-session
$ curl https://mise.run | sh
$ ~/.local/bin/mise --version
_ __
____ ___ (_)_______ ___ ____ ____ / /___ _________
/ __ `__ \/ / ___/ _ \______/ _ \/ __ \______/ __ \/ / __ `/ ___/ _ \
/ / / / / / (__ ) __/_____/ __/ / / /_____/ /_/ / / /_/ / /__/ __/
/_/ /_/ /_/_/____/\___/ \___/_/ /_/ / .___/_/\__,_/\___/\___/
/_/ by @jdx
2026.5.8 macos-arm64 (2026-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
echo '~/.local/bin/mise activate pwsh | Out-String | Invoke-Expression' >> ~/.config/powershell/Microsoft.PowerShell_profile.ps1
```
### Execute commands with specific tools
```sh-session
$ mise exec node@26 -- node -v
mise node@26.x.x ✓ installed
v26.x.x
```
### Install tools
```sh-session
$ mise use --global node@26 go@1
$ node -v
v26.x.x
$ go version
go version go1.x.x macos/arm64
```
See [dev tools](https://mise.en.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.en.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.en.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.en.dev/mise-cookbook/).
## Full Documentation
See [mise.en.dev](https://mise.en.dev)
## GitHub Issues & Discussions
Due to the volume of issue submissions mise received, using GitHub Issues became unsustainable for
the project. Instead, mise uses GitHub Discussions which provide a more community-centric platform
for communication and require less management on the part of the maintainers.
Please note the following discussion categories, which match how issues are often used:
- [Announcements](https://github.com/jdx/mise/discussions/categories/announcements)
- [Ideas](https://github.com/jdx/mise/discussions/categories/ideas): for feature requests, etc.
- [Troubleshooting & Bug Reports](https://github.com/jdx/mise/discussions/categories/troubleshooting-and-bug-reports)
## Special Thanks
Thanks to Namespace for providing CI services for mise.
## Contributors
[](https://github.com/jdx/mise/graphs/contributors)