From 640cc129dbb545505b2071dddda948133b519d1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pedro=20Pi=C3=B1era=20Buend=C3=ADa?=
 <663605+pepicrft@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:01:09 +0000
Subject: [PATCH] Document how to install pkl with Mise (#982)

---
 docs/modules/pkl-cli/pages/index.adoc | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/modules/pkl-cli/pages/index.adoc b/docs/modules/pkl-cli/pages/index.adoc
index ffdd6999..265cba9d 100644
--- a/docs/modules/pkl-cli/pages/index.adoc
+++ b/docs/modules/pkl-cli/pages/index.adoc
@@ -1,6 +1,8 @@
 = CLI
 include::ROOT:partial$component-attributes.adoc[]
 :uri-homebrew: https://brew.sh
+:uri-mise: https://mise.jdx.dev
+:uri-ubi: https://github.com/houseabsolute/ubi
 
 :uri-sonatype-snapshot-download: https://s01.oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=org.pkl-lang&v={pkl-artifact-version}
 :uri-pkl-macos-amd64-download: {uri-sonatype-snapshot-download}&a=pkl-cli-macos-amd64&e=bin
@@ -84,6 +86,29 @@ ifndef::is-release-version[]
 For instructions, switch to a release version of this page.
 endif::[]
 
+[[mise]]
+=== Mise
+
+On macOS, Linux, and Windows, release versions can be installed using {uri-ubi}[the Universal Binary Installer (UBI)] with {uri-mise}[Mise].
+
+ifdef::is-release-version[]
+To install Pkl, run:
+
+[source,shell]
+[subs="+attributes"]
+----
+mise use -g pkl@{pkl-version}
+----
+
+You can then run `mise use` to activate the latest version either globally or locally:
+
+[source,shell]
+----
+mise use -g ubi:apple/pkl@latest # Activate it globally
+mise use ubi:apple/pkl@latest
+----
+endif::[]
+
 [[download]]
 === Download