mise-ghcup

A mise backend plugin that installs Haskell tools through GHCup.

It lets you manage these tools with mise, pinned per project and reproducible across machines:

• mise-ghcup:ghc – the Glasgow Haskell Compiler
• mise-ghcup:hls – the Haskell Language Server

Note

These tools are also available, but we don't recommend to install them through GHCup, since they are installable through the Aqua backend, which provides better performance and supply chain safety:

• mise-ghcup:stack – the Stack build tool (just use the stack tool instead, will pull from Aqua)
• mise-ghcup:cabal – the Cabal build tool (just use the cabal tool instead, will pull from Aqua)

Prerequisites

• mise 2026.7.3 or newer
• An installed GHCup. You can manage it through Mise too, with the ghcup tool, by adding it to your mise.toml as shown below.

Usage

Add the plugin and the tools to your project's mise.toml:

# Minimum required mise version for this plugin.
min_version = "2026.7.3"

[tools]
# Set your preferred versions here:
"ghcup" = "latest"
"mise-ghcup:ghc" = "latest"
"mise-ghcup:hls" = "latest"

[plugins]
"vfox-backend:mise-ghcup" = "https://github.com/wasp-lang/mise-ghcup.git"

[settings]
# Backend plugins are experimental, so we need to enable them here.
experimental = true

Then install everything:

mise install

You can now use the tools, with mise managing the versions:

ghc --version

Choosing versions

List the versions GHCup offers for any tool:

mise ls-remote mise-ghcup:ghc

Pin a specific version in mise.toml instead of latest:

[tools]
"mise-ghcup:ghc" = "9.10.1"

License

MIT