Plori Desktop
Install Plori Desktop on a Mac so a Workspace agent can use its browser, your signed-in sites and a connected Android phone or emulator.
Plori Desktop is the Plori app for macOS. It lets a Workspace agent use Plori's browser on your Mac, including sites where you are signed in, and a connected Android phone or emulator. It runs on macOS 13 or later, on Apple silicon and Intel Macs. Using your computer with Plori is free during the beta.
Install Plori and sign in
- Download Plori for macOS.
- Open the disk image.
- Drag Plori into Applications.
- Open Plori.
- Choose Google, GitHub, X or email.
- Finish signing in through your usual browser.
Return to Plori to open a Workspace and chat with its agent. The sidebar also has Usage, Billing, Settings and This Mac. Use This Mac to choose what agents can access on this computer.
Turn on the browser
In This Mac, turn on Browser. Choose Turn On when Plori asks for access. Plori uses an installed copy of Chrome or Chromium with its own profile. The browser starts without a window. When an agent opens a page, its window starts minimized.
An agent can read pages, click buttons and fill in forms, including on sites where you sign in. Plori and the model receive the page content the agent reads.
Sign in to a site
Choose Open browser in This Mac to open your own window in Plori's browser. Sign in to the site you want the agent to use.
You can also import sign-ins from your regular Chrome profile.
- In This Mac, choose Manage beside Signed-in sites, then choose Import from Chrome.
- Choose the Chrome profile that you use for those sites.
- Select the sites to copy.
- Choose Import.
- When macOS asks for access to “Chrome Safe Storage”, choose Allow for this import. Always Allow also permits future imports.
To remove a sign-in, choose Manage beside Signed-in sites. Choose Remove beside the site. To clear all cookies in Plori's browser, choose Remove all and confirm.
Stop an agent in the browser
While an agent uses the browser, the Browser row shows In use by an agent. Choose Stop to close its tabs and end browser access for that run. To stop sharing the browser with all agents, turn off Browser.
Connect an Android phone
- Install Android SDK Platform-Tools on your computer if you need Android Debug Bridge (
adb). - Enable USB debugging on the phone.
- Connect the phone by USB.
- Allow USB debugging from this computer when the phone asks.
- In This Mac, turn on Android. Choose Turn On when Plori asks for access.
This gives agents permission to read your phone's screen, open apps, tap and type. Plori and the model receive the app content an agent reads. Turn off Android to end phone access.
Set up an Android emulator
- In This Mac, choose Set up emulator.
- Use the Android SDK folder and emulator that Plori found, or choose New emulator.
- Choose Review setup to see which packages you need and the download size.
- If packages are missing, review Google's licence. Select Accept licence for each licence you accept.
- Choose Install and start, or Start emulator if you already have the packages.
Your computer downloads missing packages directly from Google. A fresh setup takes about 2.1 to 2.2 GB of downloads. Turn on Android to give agents access to the emulator.
Run Plori from a terminal
The desktop CLI supports Linux and macOS. On Windows, use the web app. Install the Plori CLI. For browser access on Linux, run it from a graphical session with Chrome or Chromium installed.
- Run
plori desktop pair. - Open the address it prints. Confirm the pairing code.
- Run
plori desktop run --browser. Keep the command running during the task.
For Android, run plori desktop run --android. Add --adb /path/to/adb to choose an executable.
Use plori desktop run --browser --android to share both.
Use plori desktop sites to list sites in your Chrome profile.
For example, plori desktop import-cookies --site github.com copies that site's sign-in into Plori's profile.
On Linux, the importer skips cookies encrypted with the system keyring.
Use plori desktop status to see which device you paired. Run plori desktop unpair to remove the local pairing.
Which runs can use my computer?
Start the run from a Workspace in the Plori app or web app. You can also start it through the REST API with your own API key. If your computer is online with Browser on when the run starts, the agent uses Plori's browser on your computer. Otherwise it uses the cloud browser.
Scheduled runs and runs from AI clients or chat apps use the cloud browser. Other people in a shared Workspace can use only their own computers.
If your computer goes offline or sleeps and the connection expires, browser actions stop for the rest of that run. Start a new run after your computer reconnects to use its browser again.
Which browser actions need approval?
Plori asks for approval when it identifies an irreversible browser action, such as sending a message, making a payment or deleting an item. Review the pending action before you approve it. Each approval covers that one action.