# macOS Standard Installation

## Prerequisites

| Requirement       | Detail                                                     |
| ----------------- | ---------------------------------------------------------- |
| **OS**            | macOS 10.13 (High Sierra) or later                         |
| **Hardware**      | Minimum: any supported Mac. Recommended: 8 GB RAM, SSD     |
| **Apple Silicon** | Rosetta must be installed if prompted (Apple Silicon Macs) |
| **Antivirus**     | Add an exception for MyZen if a third-party AV is active   |

## Download the Installer

1. Log in to the We360.ai web portal.
2. Click the **Download Apps** button in the top bar.
3. In the **Mac** section, click **Standard** to download `MyZenV2.pkg`.

## Install (PKG Installer)

1. Double-click `MyZenV2.pkg` in your Downloads folder.
2. macOS may block the installer. If prompted with a security warning, click **OK**, then open **System Settings > Privacy & Security**.
3. Scroll to the **Security** section. You will see: *"MyZenV2 was blocked from use because it is not from an identified developer."* Click **Open Anyway**.
4. Click **Open** on the confirmation dialog.
5. The MyZenV2 Installer window appears. Click **Continue**.
6. Select the destination disk and click **Continue**.
7. Click **Install**, then enter your macOS credentials and click **Install Software**.
8. When "The installation was successful" appears, click **Close**.
9. Optionally keep or discard the PKG file when prompted.

## Grant Required Permissions

After installation, macOS will prompt for permissions. These are mandatory for data collection.

1. **Accessibility:** A prompt to enable Accessibility access appears. Click **Open System Settings**, locate **MyZenV2**, and toggle it **ON**. Authenticate if prompted.
2. **Screen Recording:** A prompt for screen and audio recording appears. Click **Open System Settings**, locate **MyZenV2**, and toggle it **ON**. After granting this permission, you must **log out and log back in** (or restart MyZen) for it to take effect.
3. **Browser URL Reading:** When you open a browser for the first time after installation, MyZen will prompt for permission to read browser URLs. This permission cannot be granted beforehand and is not skippable -- you must approve it when prompted.
4. Click **Quit & Reopen** when prompted to restart MyZen with the new permissions.

## Sign In

1. The MyZen app opens. Enter your **Workspace** name and click **Sign in**.
2. Enter your **Email** and **Password**.
3. Click **Punch In** to begin tracking.

### Post-Installation Notes

* The app will not automatically start until the user logs out and back in (or restarts).
* MyZen updates itself automatically.

## Install Locations (Reference)

| Item           | Path                                                    |
| -------------- | ------------------------------------------------------- |
| Application    | `/Applications/MyZenV2.app`                             |
| Version file   | `/Applications/MyZenV2.app/Contents/MacOS/version.txt`  |
| Launch agent   | `/Library/LaunchAgents/ai.we360.MyZenV2.plist`          |
| Updater daemon | `/Library/LaunchDaemons/ai.we360.MyZenV2-updater.plist` |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.we360.ai/deployment-and-it-ops/agent-deployment-hub/manual-installation/macos-standard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.