Skip to main content
At times, Mistle may encounter difficulties setting up the tools for your computer. In such situations, refer to this guide to do it manually.

​
macOS fixes

Most installations will require a Terminal.
  • To open the Terminal: use Spotlight: press Command + Space, type Terminal, and hit Enter.
  • Or, open Finder → Applications → Utilities → Terminal.
  • Open the terminal, paste the following into the terminal and press enter. 
    xcode-select --install
  • Run the installer that pops up as a prompt or in the dock
  • Mistle requires Git version 2.31 or later. To check your version in terminal: 
    git --version
  • If missing or outdated, install via Homebrew. 
    brew install git
brew upgrade git
  • If you do not have homebrew, install: 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • Set your name/email so commits work. 
    git config --global user.name "Your Name"
git config --global user.email [email protected]
  • Install, then open a new terminal and verify. 
    curl -fsSL https://mise.jdx.dev/install.sh | sh
mise --version
  • If you see “command not found,” add the installer’s init block to your shell file, then restart Mistle.
    1. Check your shell (zsh is the macOS default):
    echo $SHELL
    1. Add the init block to the right file:
    • For zsh:
    echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc
source ~/.zshrc
    • For bash:
    echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bash_profile
source ~/.bash_profile
  • Install via mise (global): 
    mise use -g gh@latest
  • Authenticate: 
    gh auth login
  • Prompts: choose GitHub.com → HTTPS → login with browser (or paste a token) → confirm defaults.

​
Windows fixes

  • Run Powershell as Administrator when installing system tools.
  • Install, then restart Mistle so it can see Git. 
    winget install --id Git.Git -e
  • Install via winget. If blocked, reopen Mistle as Administrator and retry; restart after install. 
    winget install --id Microsoft.PowerShell -e
  • Install via winget. Restart Mistle if it asks; this adds mise shims to PATH. 
    winget install --id jdx.mise -e
  • If commands are not found afterward, add the activate snippet to your PowerShell profile, then reopen your terminal. 
    echo '(&mise activate pwsh) | Out-String | Invoke-Expression' >> $HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
  • If your shell does not support activate, add shims to PATH (default): 
    setx PATH "%LOCALAPPDATA%\mise\shims;%PATH%"
  • Install and authenticate. 
    winget install --id GitHub.cli -e
gh auth login
  • Prompts: choose GitHub.com → HTTPS → login with browser (or paste a token) → confirm defaults.