Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/connorads/mise
@connorads mise guide 🪓
https://github.com/connorads/mise
Last synced: 12 days ago
JSON representation
@connorads mise guide 🪓
- Host: GitHub
- URL: https://github.com/connorads/mise
- Owner: connorads
- License: mit
- Created: 2023-06-30T08:30:40.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2024-01-30T11:27:15.000Z (5 months ago)
- Last Synced: 2024-01-30T23:38:18.752Z (5 months ago)
- Homepage:
- Size: 21.5 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Lists
- awesome-stars - mise
README
# mise
[`mise`](https://github.com/jdxcode/mise) (mise-en-place) is a CLI tool that can manage multiple language runtime versions on a per-project basis. It's like `asdf` but faster. It's also like `gvm`, `nvm`, `rbenv`, `tfenv` & `pyenv` (and more) all in one! (formerly called "`rtx`")
## Setup
### Install `mise`
```sh
brew install mise
```
### Add `mise` to shell
```sh
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
```
## Commands
### Set local idiomatic version file
```sh
echo 3.11 > .python-version # Python example
echo 20.5.1 > .node-version # Node example
```
### Install missing tools
Given missing tools specified in [local version files](#local-version-files) (e.g. `[WARN] Tool not installed: [email protected]`)
```sh
mise install
```
### Install missing plugin
If `mise install` is not working and you're not getting a warning (e.g. `[WARN] Tool not installed: [email protected]`) when there is an existing idiomatic version file (e.g. `.terraform-version`) you may need to install the corresponding plugin
```sh
mise plugins install terraform
```
### Set current shell session version
Sets a tool version for the current shell session. Useful if you're doing something quick and don't want to set a global or local version.
```sh
mise shell node@lts
```
### Set global version
If you're sure you want to have a specific version always available then you can set a global version
```sh
mise use -g node@lts
mise use -g [email protected]
mise use -g rust@latest
```
## Concepts
### Local version files
In order to automatically switch to the correct version of your runtime(s) when you're working on different projects it's useful to store the version number in a file in a project's directory.
#### Idiomatic version files
[`mise`](https://github.com/jdxcode/mise) supports idiomatic version files (just like `asdf`). They're language-specific files like `.node-version` and `.python-version`.
These are ideal for setting the runtime version of a project without forcing other developers to use a specific tool like `mise`/`asdf`.
They support aliases, which means you can have an `.nvmrc` file with `lts/hydrogen` and it will work in `mise` and `nvm`. Here are some of the supported legacy version files:
| Plugin | Idiomatic Version Files |
|------------|----------------------------------------------------|
| crystal | `.crystal-version` |
| elixir | `.exenv-version` |
| go | `.go-version`, `go.mod` |
| java | `.java-version`, `.sdkmanrc` |
| node | `.nvmrc`, `.node-version` |
| python | `.python-version` |
| ruby | `.ruby-version`, `Gemfile` |
| terraform | `.terraform-version`, `.packer-version`, `main.tf` |
| yarn | `.yarnrc` |
#### `.mise.toml`
[`.mise.toml`](https://mise.jdx.dev/configuration.html#mise-toml) is the native version file that is more customisable but requires that project collaborators use `mise`.
#### `.tool-versions`
[`.tool-versions`](https://mise.jdx.dev/configuration.html#tool-versions) is the `asdf` version file that supports multiple tools in one file but requires that project collaborators use `asdf` or `mise`.