Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

fix(install): tell Intel Mac users the truth, and stop citing a script that does not exist (#339)

KageBinaryd6de7006ccf4
diff --git a/README.md b/README.md
index 2d148f69..5f024114 100644
--- a/README.md
+++ b/README.md
@@ -157,7 +157,10 @@ The install script sets up everything for you on macOS and Linux. It checks for
All you need beforehand is a terminal with `curl` (or `wget`). On Windows, install Node.js 22+ and Docker Desktop first, then run the installer.
-Works on macOS, Linux, and Windows, on both x86-64 and arm64.
+Works on macOS, Linux, and Windows. Pre-built CLI packages are published for
+Apple Silicon macOS, Linux (x86-64 and arm64) and Windows x86-64. **Intel Macs**
+have no pre-built package — install with Homebrew, which builds from
+source: `brew tap ix-infrastructure/ix https://github.com/ix-infrastructure/Ix && brew install ix`.
For the full list, including the endpoints the installer reaches and the directories it creates, see [docs/prerequisites.md](docs/prerequisites.md).
diff --git a/docs/prerequisites.md b/docs/prerequisites.md
index b3dfb2a5..dfd83fca 100644
--- a/docs/prerequisites.md
+++ b/docs/prerequisites.md
@@ -100,7 +100,10 @@ ix-memory-layer==latest
# Pre-built tarball from GitHub Releases, extracted to ~/.ix/cli/
# Wrapper script placed in /usr/local/bin/ix or ~/.local/bin/ix
-# Platforms: linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64
+# Platforms: linux-amd64, linux-arm64, darwin-arm64, windows-amd64
+# No darwin-amd64 (Intel Mac) tarball is published — install with Homebrew,
+# which builds from source. The README links here as the full list, so this
+# has to agree with it.
# ============================================================================
# ALSO INSTALLED (used by ix commands)
diff --git a/scripts/install/install.sh b/scripts/install/install.sh
index bbe68eab..8588b6d2 100755
--- a/scripts/install/install.sh
+++ b/scripts/install/install.sh
@@ -870,7 +870,39 @@ check_installed_version() {
fi
}
-if [ -x "$IX_BIN/ix" ]; then
+# Intel Macs have no pre-built asset on the current release matrix —
+# darwin-amd64 is deliberately omitted because the macos-13 runners queue
+# indefinitely. Decide this BEFORE the upgrade branch below removes the existing
+# install: reaching it after `rm -rf "$INSTALL_DIR"` would delete a working CLI
+# and then abort, leaving the user worse off than not running the script.
+#
+# Only for the resolved-latest path. IX_VERSION is an explicit request for a
+# specific release, and every build before #259 did publish darwin-amd64 — so a
+# pinned rollback is allowed through to the normal download-and-404 handling.
+SKIP_CLI_INSTALL=0
+if [ "$PLATFORM" = "darwin-amd64" ] && [ -z "${IX_VERSION:-}" ]; then
+ echo ""
+ warn "Ix does not publish a pre-built CLI for Intel Macs (darwin-amd64)."
+ echo ""
+ echo " Install the CLI with Homebrew instead — it builds from source:"
+ echo " brew tap ${GITHUB_ORG}/ix https://github.com/${GITHUB_ORG}/${GITHUB_REPO}"
+ echo " brew install ix"
+ echo ""
+ if [ -x "$IX_BIN/ix" ]; then
+ # A CLI is already here (Homebrew, or a pre-#259 release). Leave it exactly
+ # as it is and carry on with the backend setup, which is platform-neutral
+ # and is the rest of what this script does.
+ warn "Leaving your existing ix CLI untouched and continuing with the backend setup."
+ echo ""
+ SKIP_CLI_INSTALL=1
+ else
+ echo " Apple Silicon Macs are supported by this installer directly."
+ echo ""
+ err "No darwin-amd64 release asset. Install the CLI with Homebrew (above), then re-run this script to set up the backend."
+ fi
+fi
+
+if [ "$SKIP_CLI_INSTALL" = "0" ] && [ -x "$IX_BIN/ix" ]; then
existing_version=$(check_installed_version)
if [ "$existing_version" = "$VERSION" ]; then
info "ix CLI v${VERSION} is already installed"
@@ -880,7 +912,7 @@ if [ -x "$IX_BIN/ix" ]; then
fi
fi
-if [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; then
+if [ "$SKIP_CLI_INSTALL" = "0" ] && { [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; }; then
mkdir -p "$INSTALL_DIR"
TMP_DIR=$(mktemp -d)
@@ -898,9 +930,23 @@ if [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; then
echo " Check available releases at:"
echo " https://github.com/${GITHUB_ORG}/${GITHUB_REPO}/releases"
echo ""
- echo " Or build from source:"
- echo " git clone https://github.com/${GITHUB_ORG}/${GITHUB_REPO}.git"
- echo " cd ${GITHUB_REPO} && ./setup.sh"
+ # This branch is reached on every platform, so the advice has to work on
+ # every platform. Homebrew is the right answer on macOS specifically; it is
+ # no help at all to the Linux and Windows users who also land here.
+ case "$PLATFORM" in
+ darwin-*)
+ echo " Or install with Homebrew, which builds from source:"
+ echo " brew tap ${GITHUB_ORG}/ix https://github.com/${GITHUB_ORG}/${GITHUB_REPO}"
+ echo " brew install ix"
+ ;;
+ *)
+ # scripts/dev/setup.sh, not ./setup.sh — the root-level script this used
+ # to cite has never existed in this repo.
+ echo " Or build from source:"
+ echo " git clone https://github.com/${GITHUB_ORG}/${GITHUB_REPO}.git"
+ echo " cd ${GITHUB_REPO} && ./scripts/dev/setup.sh"
+ ;;
+ esac
echo ""
err "CLI download failed. See above for alternatives."
fi