Installing Prompteryx in Chrome
Add and set up Prompteryx in Chrome, our Chrome extension
Prerequisites
Prompteryx in Chrome works alongside Prompteryx Desktop, a desktop app for Windows. Make sure you have the Prompteryx Desktop installed and signed in before proceeding. You only need both for local runs: the AI Browser Agent also runs on Cloud Browser without them.
Installation Steps
Prompteryx in Chrome is on the Chrome Web Store. Adding it takes a few seconds, works on Chrome, Edge and Brave, and it updates itself.
Add to Chrome- On the Chrome Web Store page, click Add to Chrome
- Pin the Prompteryx icon from the puzzle-piece menu
- Reload prompteryx.ai — the status badge turns green
Can't use the Chrome Web Store? Load the same extension from the ZIP on the Download page.
For easy access, pin the extension to your Chrome toolbar:
- Click the puzzle piece icon (Extensions) in Chrome's toolbar
- Find "Prompteryx AI Browser Agent" in the list
- Click the pin icon next to it
The Prompteryx icon will now always be visible in your toolbar.
The side panel runs with the Prompteryx account the desktop app is signed in to, and uses that account's AI Credits. With the desktop app running:
- Click the Prompteryx icon in your toolbar
- The sidebar panel will open
- If the panel says "Not signed in", click "Sign in"
- Sign in to your Prompteryx account in the new tab
- Return to the sidebar—it picks up the sign-in by itself and shows "Signed in as …"
The line under the panel header shows which Prompteryx site and account the panel is using. Click "Switch" there to change the site.
Make sure Prompteryx Desktop is running on your computer. The extension communicates with the desktop app to execute browser automations. It only talks to the desktop app on your own computer (127.0.0.1), pairs with it using a secret created for your install, and only accepts messages from prompteryx.ai.
How to verify:
- Look for the Prompteryx icon in your system tray
- In the sidebar header, the status should show "Ready" ("Desktop app not running" means the panel can't reach the desktop app)
- Try sending a simple command like "Go to google.com"
Multiple Chrome Profiles
Prompteryx in Chrome keeps some state per Chrome profile and shares some across them. This means:
- Separate settings: Each profile can have its own preferences
- Separate chat history: Chat history follows the Prompteryx account each Chrome profile is signed in to on prompteryx.ai
- One desktop app account: Runs from every Chrome profile go through the same Prompteryx Desktop and are billed to the account the desktop app is signed in to. If a profile's Prompteryx account differs, the "Switch" dialog says which account is billed.
Keep this in mind if several people share one computer with different Chrome profiles.
Troubleshooting
If the panel still says "Not signed in" after signing in:
- Make sure you signed in on the site shown under the panel header (use "Switch" to change it)
- Sign the desktop app in directly: right-click the Prompteryx tray icon → Sign in… and approve it in your browser
- Try closing and reopening the sidebar panel
If the extension can't connect to Prompteryx Desktop:
- Verify Prompteryx Desktop is running (check system tray)
- Restart the desktop app if needed
- Update both if either is old: the extension must be 3.0.0 or later and the desktop app 1.1.0 or later, or they can't pair
- Check your firewall isn't blocking localhost connections
- Try restarting Chrome
- Click the puzzle piece icon (Extensions) in Chrome
- Make sure Prompteryx is enabled
- Click the pin icon to add it to your toolbar
- Try reinstalling the extension if it's not visible at all