# Installing Codex Plugin

SailPoint Agentic Fabric plugins govern agent activity in Codex. [Agentic Audit](../ai_plugins/index.md#agentic-audit) logs tool calls and applies [Endpoint Agent AuthZ](../../../policy_center/endpoint_agent_authz.md) policies from the Policy Center.

## Before You Begin

- Install the Codex CLI for the users who will run the plugin.
- On macOS, the install requires `bash` and `curl`.
- On Windows, the install requires Windows PowerShell 5.1 or later.
- Download the AI plugin package after you select Codex. Refer to [Installing AI Plugins](../ai_plugins/index.md).

## Installing the Plugin

Use the AI plugin package you downloaded. The package contains one archive for Windows and one archive for macOS. Each archive installs the plugin into the Codex CLI. Each archive is a local marketplace named `sailpoint`. Add that marketplace to Codex, then install Agentic Audit from it. Codex requires you to review and trust the plugin hooks before they run.

### Installing the Plugin on Windows

The Windows archive is `agent-marketplace-codex-windows.zip`.

**To install the plugin on Windows:**

1. Unzip the AI plugin package you downloaded.
2. Unzip `agent-marketplace-codex-windows.zip` to a folder you plan to keep, for example `%USERPROFILE%\sailpoint-codex`. The folder must contain `.agents` and `plugins`.
3. Open PowerShell in the unzipped folder.
4. Add the folder as a Codex marketplace.

```
    codex plugin marketplace add .
    ```

5. Install the plugin.

```
    codex plugin add agentic-audit@sailpoint
    ```

6. Start Codex.
7. Run `/hooks`.
8. Review and trust the `agentic-audit` hooks.

**To verify the plugin:**

1. In PowerShell, list the plugins in the marketplace.

```
    codex plugin list --marketplace sailpoint
    ```

2. Confirm that `agentic-audit` is installed.
3. In Codex, run `/hooks` and confirm that the `agentic-audit` hooks are trusted.

### Installing the Plugin on macOS

The macOS archive is `agent-marketplace-codex-mac.zip`.

**To install the plugin on macOS:**

1. Unzip the AI plugin package you downloaded.
2. Unzip `agent-marketplace-codex-mac.zip` to a folder you plan to keep, for example `~/sailpoint-codex`. The folder must contain `.agents` and `plugins`.
3. Open Terminal in the unzipped folder.
4. Add the folder as a Codex marketplace.

```
    codex plugin marketplace add .
    ```

5. Install the plugin.

```
    codex plugin add agentic-audit@sailpoint
    ```

6. Start Codex.
7. Run `/hooks`.
8. Review and trust the `agentic-audit` hooks.

**To verify the plugin:**

1. In Terminal, list the plugins in the marketplace.

```
    codex plugin list --marketplace sailpoint
    ```

2. Confirm that `agentic-audit` is installed.
3. In Codex, run `/hooks` and confirm that the `agentic-audit` hooks are trusted.

Installing Codex Plugin

SailPoint Agentic Fabric plugins govern agent activity in Codex. Agentic Audit logs tool calls and applies Endpoint Agent AuthZ policies from the Policy Center.

Before You Begin

Install the Codex CLI for the users who will run the plugin.
On macOS, the install requires bash and curl.
On Windows, the install requires Windows PowerShell 5.1 or later.
Download the AI plugin package after you select Codex. Refer to Installing AI Plugins.

Installing the Plugin

Use the AI plugin package you downloaded. The package contains one archive for Windows and one archive for macOS. Each archive installs the plugin into the Codex CLI. Each archive is a local marketplace named sailpoint. Add that marketplace to Codex, then install Agentic Audit from it. Codex requires you to review and trust the plugin hooks before they run.

Installing the Plugin on Windows

The Windows archive is agent-marketplace-codex-windows.zip.

To install the plugin on Windows:

Unzip the AI plugin package you downloaded.
Unzip agent-marketplace-codex-windows.zip to a folder you plan to keep, for example %USERPROFILE%\sailpoint-codex. The folder must contain .agents and plugins.
Open PowerShell in the unzipped folder.
Add the folder as a Codex marketplace.
```
codex plugin marketplace add .
```

Install the plugin.

codex plugin add agentic-audit@sailpoint

Start Codex.
Run /hooks.
Review and trust the agentic-audit hooks.

To verify the plugin:

In PowerShell, list the plugins in the marketplace.
```
codex plugin list --marketplace sailpoint
```
Confirm that agentic-audit is installed.
In Codex, run /hooks and confirm that the agentic-audit hooks are trusted.

Installing the Plugin on macOS

The macOS archive is agent-marketplace-codex-mac.zip.

To install the plugin on macOS:

Unzip the AI plugin package you downloaded.
Unzip agent-marketplace-codex-mac.zip to a folder you plan to keep, for example ~/sailpoint-codex. The folder must contain .agents and plugins.
Open Terminal in the unzipped folder.
Add the folder as a Codex marketplace.
```
codex plugin marketplace add .
```

Install the plugin.

codex plugin add agentic-audit@sailpoint

Start Codex.
Run /hooks.
Review and trust the agentic-audit hooks.

To verify the plugin:

In Terminal, list the plugins in the marketplace.
```
codex plugin list --marketplace sailpoint
```
Confirm that agentic-audit is installed.
In Codex, run /hooks and confirm that the agentic-audit hooks are trusted.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.