# Download And Install

Use this page when someone asks where ZoneGaze Matrix comes from, which installer to use, or how
updates work.

## Official Download Starting Point

The current product catalog points users to:

- `https://zonegaze.com/downloads`

For Android, the source also documents this current direct APK endpoint:

- `https://zonegaze.com/ZoneGaze-debug.apk`

Use the download hub first. Do not tell users to install from random mirrors.

## Choose The Right Install Path

| User type | Recommended path | Primary doc |
| --- | --- | --- |
| Mac desktop user | Direct Mac app | [Direct Mac application](../platforms/direct-mac-application.md) |
| Android user | Direct Android app | [Direct Android application](../platforms/android-application.md) |
| CLI user | `npx zonegaze-flow` or global package | [CLI reference](../reference/cli.md) |
| Contributor | Repository checkout and local dev commands | [Developer onboarding](../developer/onboarding.md) |

## Mac Install

1. Open `https://zonegaze.com/downloads`.
2. Download the Mac DMG for the correct CPU:
   - Apple Silicon: `ZoneGaze Matrix-<version>-arm64.dmg`
   - Intel: `ZoneGaze Matrix-<version>-x64.dmg`
3. Open the DMG.
4. Drag `ZoneGaze Matrix.app` into `/Applications`.
5. Open the app from Applications, Finder, or Spotlight.

Deeper guide:

- [Direct Mac application](../platforms/direct-mac-application.md)

## Android Install

1. Open `https://zonegaze.com/downloads`, or use the currently documented APK endpoint when that
   is the active release path.
2. Download the ZoneGaze Matrix APK.
3. Open the APK on the device.
4. Allow installation from the chosen browser or file manager if Android asks.
5. Open `ZoneGaze Matrix`.

Deeper guide:

- [Direct Android application](../platforms/android-application.md)

## CLI Install

The CLI path is for package users, automation, or contributors who prefer terminal launch.

```bash
npx zonegaze-flow
```

Optional global install:

```bash
npm install -g zonegaze-flow
zonegaze-flow
```

Deeper guide:

- [CLI reference](../reference/cli.md)

## Requirements Summary

- Mac direct app: a Git project plus either a supported CLI agent or a configured native Cline
  provider.
- Android direct app: the ZoneGaze Matrix APK and completion of owned runtime setup in the app.
- CLI path: Node.js 22 or newer and a Git repository to run inside.

## Updates

- Mac direct app: install a newer DMG from the same trusted distribution channel.
- Android direct app: install a newer APK and let the app refresh its bundled runtime when needed.
- CLI path: use the package update flow documented in the CLI/runtime docs.

## Related Docs

- [Help center](README.md)
- [Setup and first run](setup-and-first-run.md)
- [Platform application guides](../platforms/README.md)
- [Getting started](../user/getting-started.md)
- [Troubleshooting](../user/troubleshooting.md)
