Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
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.mdindex 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 forAll 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.mdindex 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.shindex 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" ]; thenexisting_version=$(check_installed_version)if [ "$existing_version" = "$VERSION" ]; theninfo "ix CLI v${VERSION} is already installed"@@ -880,7 +912,7 @@ if [ -x "$IX_BIN/ix" ]; thenfifi-if [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; then+if [ "$SKIP_CLI_INSTALL" = "0" ] && { [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; }; thenmkdir -p "$INSTALL_DIR"TMP_DIR=$(mktemp -d)@@ -898,9 +930,23 @@ if [ ! -x "$IX_BIN/ix" ] || [ "$(check_installed_version)" != "$VERSION" ]; thenecho " 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"+ ;;+ esacecho ""err "CLI download failed. See above for alternatives."fi