# Chrome Extension

The Process Intelligence (PI) Chrome Extension is a lightweight, browser-based solution designed to simplify task mining for web applications. As an alternative to the Windows Agent, it ensures quick setup and cross-platform compatibility, supporting both Windows and Mac operating systems.

### Key Benefits

* **Cross-Platform Compatibility:** The Chrome Extension extends functionality beyond Windows, enabling Mac users to seamlessly participate in task mining activities.
* **Quick and Easy Setup:** Available in the [Google Chrome Extension Store](https://chromewebstore.google.com/detail/process-intelligence-exte/ncjlmbknfafminepaonkggandokbojfc?pli=1), the extension can be installed and configured quickly, enabling rapid deployment and testing.
* **Platform for Browser-Based Features:** This extension lays the groundwork for new ProcessMaker features that integrate directly within your web browser environment.

{% hint style="warning" %}
**Important:** Do not use the Chrome Extension and Windows Agent simultaneously, as they are designed to operate independently.
{% endhint %}

***

## Installing the PI Chrome Extension

Follow these steps to install the Chrome extension:

1. Download and install the extension from the [Google Chrome Extension Store](https://chromewebstore.google.com/detail/process-intelligence-exte/ncjlmbknfafminepaonkggandokbojfc?pli=1).
2. Contact your PI Admin to obtain your invitation token.
3. Open the extension settings, paste the token into the **License Token** field, and click **Apply**.\
   ![](https://2793813092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GkXjeUIZVdsIJygBmnf%2Fuploads%2F223MiuWAfbJIDPgZyySA%2FPI%20License%20Token.png?alt=media\&token=3cf9d9c7-028d-4c5b-a2d9-4f3f9a1a29a6)<br>
4. Verify the connection by checking that the **Data Collection Status** indicator turns green.\
   ![](https://2793813092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GkXjeUIZVdsIJygBmnf%2Fuploads%2FBgHlvzfNOvTEjDU65Gjb%2FPI%20Apply%20License%20Token.png?alt=media\&token=3b230ebe-a104-4194-ac54-4c0ed0fb1057)

***

## Windows Agent vs. Chrome Extension

The table below highlights the key differences between the Windows Agent and the Chrome Extension:

| Feature                           | Windows Agent                     | Chrome Extension          |
| --------------------------------- | --------------------------------- | ------------------------- |
| **Installation Source**           | Downloadable MSI from Admin Panel | Chrome Extension Store    |
| **Setup Method**                  | IT-managed or by end users        | User-managed installation |
| **Supported Systems**             | Desktop and web applications      | Web applications only     |
| **Supported Browsers**            | Chrome, Edge, Opera, Firefox      | Chrome and Edge           |
| **Supported Operating Systems**   | Windows 11                        | Windows and MacOS         |
| **Process Identifier Collection** | Title, URL, or Metadata           | Title or URL              |
| **X-Ray Functionality**           | Yes                               | No                        |
| **Application Catalog**           | Full                              | Manual refresh required   |
| **Heartbeat Monitoring**          | Yes                               | No                        |

***

## Accessing Collected Data

Follow these steps to review the data sent to the PI Cloud:

1. Open the **Extensions** menu in your browser.
2. Click the **Service worker** option to access the DevTools Console.<br>

   <figure><img src="https://2793813092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GkXjeUIZVdsIJygBmnf%2Fuploads%2FnLaDrjZ6kSghMwLXGl1g%2Fimage.png?alt=media&#x26;token=51df35d4-fc05-4be6-ad65-4cdcce5007ac" alt=""><figcaption></figcaption></figure>
3. The console will display logs of the collected process data.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUd-pN3EUSfBZ7RJ98doTea4CHe1p6uBkOwfu1QVPQi87t4FZ9JK3gFT1CCRZ3k15BMpIxgeePpln0A4ychA5WF479Q7nNmXZ1-GxKVtO3rBq9kLQdJlnckpe5FUKQHnYT5_JkFU=s2048?key=ESHdCAio7l4IuAMROSToW3HW" alt=""><figcaption></figcaption></figure>

***

## Disabling or Uninstalling the Extension

Follow these steps to pause or remove the Chrome Extension:

1. Go to your browser’s **Extensions** menu.
2. Disable the extension or remove it like any other browser extension.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUew4dVitHIeRpibTe-_qZ28PREjtjQQbXcDzZwC-tTOoXZXHjwvRMS51U6tl5nNc-9yHVoRk9o5futfEYiRGpNFHnKecpFkNKrQN0kBMyEAYD3nzU4k6Vwa6tVNB_RtSthyUxr7=s2048?key=ESHdCAio7l4IuAMROSToW3HW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Disabling the extension immediately stops data collection.
{% endhint %}


---

# 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://processmaker.gitbook.io/process-intelligence/configuration/chrome-extension.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.