Edit online

Installation and Connection

Quick Installation

You can drag the following Install button and drop it into the main editor in Oxygen to quickly initiate the installation process:

Install

Manual Installation

To manually install this add-on, follow this procedure:
  1. Go to Help > Install new add-ons to open an add-on selection dialog box. Enter or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml in the Show add-ons from field or select it from the drop-down menu.
    Note:
    If you have issues connecting to the default update site, you can download the add-on package, unzip it, then use the Browse for local files action in the Install new add-ons dialog box to locate the downloaded addon.xml file.
  2. Select the Oxygen AI Positron Assistant add-on and click Next.
    Important:
    There are two different iterations of the add-on and you can only have one or the other installed at once:
    • Oxygen AI Positron Assistant - The regular version of the add-on.
    • Oxygen AI Positron Assistant Enterprise - This Enterprise version is for those who want to connect to their own company-specific AI service.
  3. Read the end-user license agreement. Then select the I accept all terms of the end-user license agreement option and click Install.
  4. Restart the application.

Result: The AI Positron Assistant side view is now available. If the view is not displayed, it can be opened by selecting it from Window > Show View.

Connecting to the Oxygen AI Positron Service

You can use the AI Positron Assistant side view to easily configure login details and connect to the Oxygen Positron Service in the web browser.

To initiate the connection process, use the Connect button in the AI Positron Assistant view (or from the user drop-down menu at the top-right corner of the view).

By default, the Oxygen Positron Service uses the GPT-4.1 model from OpenAI for generating content.

You can select the latest OpenAI, Anthropic Claude, and Google Gemini AI models in the Chat view to use for invoking AI actions or chatting with the AI. The default model can also be changed in the AI Service Configuration Preferences page. The same AI models are available when re-generating responses or can be referenced directly by a custom AI Positron action definition.

Privacy policies for the supported AI providers:

Subscriptions for AI Server Requests and Credits

Each user has a limit to the number of requests that are sent to the AI server each month and this is managed through the use of credits.

When you first log in, you get a free trial month for working with the add-on's various useful actions and experimenting with it on your content.

During or after your free trial month, in the Subscriptions page, you can either personally subscribe to one of the plans or use the Share buy link button to copy to clipboard a URL that can be shared with the person in charge of buying subscriptions for your company.

Note:
You can cancel your subscription at anytime and any remaining credits can still be used up until the expiration date. Cancelled subscriptions cannot be renewed (a new subscription is required in this case).
Important:
To use your own company-specific AI service, the Oxygen AI Positron Assistant Enterprise add-on needs to be installed instead of the regular version of the add-on.

Oxygen AI Positron Service Team Management

In your Oxygen AI Positron Service web account, you can click the profile image and choose to create a new team. You can invite existing members to your team by creating a sharable link.

Once a team is created and members are invited to it, you can use the Team drop-down button to generate an overall usage report that shows the amount of consumed credits for each client.

The Invoices tab allows you to download invoices for each member of the team who has an active subscription.

Note:
When invoices are generated, if a subscription has been refunded, the system will show the refund invoice after the refund finishes processing.