diff --git a/README.md b/README.md index 6aeec01b3..9902a860e 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ Homebrew remains on the stable v1.20.0 line: brew install gentleman-programming/tap/engram ``` -For Windows, Linux, source builds, and all installation methods, see [Installation](docs/INSTALLATION.md). +For Windows, Linux, [mise](https://mise.jdx.dev), source builds, and all installation methods, see [Installation](docs/INSTALLATION.md). ### Set up your agent diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index 629c62edd..39aa68850 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -4,6 +4,7 @@ - [Choose a release channel before installing](#choose-a-release-channel-before-installing) - [Homebrew (macOS / Linux)](#homebrew-macos--linux) +- [mise (macOS / Linux / Windows)](#mise-macos--linux--windows) - [Windows](#windows) - [Install from source (macOS / Linux)](#install-from-source-macos--linux) - [Download binary (all platforms)](#download-binary-all-platforms) @@ -40,6 +41,26 @@ brew update && brew upgrade engram --- +## mise (macOS / Linux / Windows) + +[mise](https://mise.jdx.dev) is a polyglot toolchain and version manager. Pin engram with: + +```bash +mise use -g engram@latest +``` + +> **Release channel:** mise tracks the stable v1 line, so `engram@latest` resolves to the latest v1 release. The v2 release candidates are not published to the mise registry, so they cannot be installed this way yet. See [Choose a release channel before installing](#choose-a-release-channel-before-installing). + +> **Note:** `mise use -g` only registers the pin, it does not by itself put `engram` on your `PATH`. You also need either `mise activate` (shell integration, see the [mise docs](https://mise.jdx.dev/getting-started.html)) or shims configured. If you haven't set either up, run engram through mise instead: +> +> ```bash +> mise exec -- engram version +> ``` + +This works the same way on macOS, Linux, and Windows. + +--- + ## Windows **Option A: Install via `go install` (recommended for technical users)** @@ -193,7 +214,7 @@ Grab the latest release for your platform from [GitHub Releases](https://github. ## Requirements -- **Go 1.24+** to build from source (not needed if installing via Homebrew or downloading a binary) +- **Go 1.25.10** to build from source (not needed if installing via Homebrew, mise, or downloading a binary) - That's it. No runtime dependencies. The binary includes SQLite (via [modernc.org/sqlite](https://pkg.go.dev/modernc.org/sqlite) — pure Go, no CGO). Works natively on **macOS**, **Linux**, and **Windows** (x86_64 and ARM64).