> For the complete documentation index, see [llms.txt](https://docs.we360.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.we360.ai/deployment-and-it-ops/deployment/agent-deployment-hub/manual-installation/macos-standard.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
