Web Extension Prerequisites
Before you begin, make sure you have:
-
PiecesOS: The core engine that powers all Pieces extensions. Learn more about PiecesOS.
-
A Supported Browser: Your browser must meet the minimum version requirement and must also be on the list of supported browsers, as not all browsers are supported at this time.
You must have PiecesOS to use the Pieces Web Extension. We also recommend downloading the Pieces for Developers Desktop App.
Supported Browsers
Pieces Web Extension supports most Chromium and Gecko-based browsers.
Find their respective install pages below:
Installing the Pieces Web Extension
After going to your browser's install page, you typically see an Add to Browser button. Clicking the button automatically opens to add the Pieces Web Extension to your browser.
To ensure you have fully installed the Pieces Web Extension, restart your browser.
Setting up PiecesOS
PiecesOS is required for the Pieces Web Extension to work.
If you haven’t installed it yet, click the buttons to download PiecesOS via the recommended method or follow the alternative steps below.
macOS 13.0 (Ventura) or higher
macOS 13.0 (Ventura) or higher
Windows 10 (20H0) or higher required
Ubuntu 22.04+ required.
Run these commands in order to install and properly set up the Pieces Desktop App and it’s core dependencies:
-
sudo snap install pieces-os -
sudo snap connect pieces-os:process-control :process-control
Then, type pieces-os to launch the application directly from your terminal.
Click here for alternative PiecesOS installation methods, or install the PiecesOS and the Pieces Desktop App together for Windows, macOS, and Linux.
Updating
The Pieces Web Extension will automatically update when a new version is available.
This depends on how your browser handles extensions—most browsers automatically update extensions.
You can also manually update by visiting the extension's install page, uninstalling it, and then reinstalling the extension.
Pieces Cloud
Disconnecting from the Pieces Cloud logs you out of your Pieces account.
Connecting to the Pieces Cloud is optional.
However, it provides additional features like data backups, shareable links, and more. You can still enjoy the main functionalities of Pieces without an account.
To disconnect from the Pieces Cloud:
Open the Extension
Click the Pieces Icon in the extensions bar of your browser to open the Pieces Web Extension.
Click the Sandwich Menu Icon
Select the sandwich menu icon in the top right of the Pieces extension. This will open up the Quick Settings menu.
Click Account Settings
In the new popup menu, select the settings gear icon.
Click Log Out
Select the Sign Out button at the bottom of the section. This will only say Sign Out if you are logged in.
Onboarding
The Pieces Web Extension features an interactive walkthrough that shows you the magic behind the Long Term Memory (LTM-2) and how to get the most out of the web extension.
Activating LTM-2
Click Activate LTM, and the welcome page appears with an overview of LTM-2.
You'll have the option to close the page or click I'm In to continue. Click I'm In, and the magic window pops up with interactive features that guide you through the process.
Inside the magic window, click Generate Secret Message, and a browser window opens to display an example snippet for LTM. Y
ou'll be prompted to paste your copied prompt—“What was my secret message from Pieces for Developers?”—and then click Submit.
Once submitted, Pieces celebrates your activation, showing you that LTM-2 is enabled and ready to go!
Uninstalling
To uninstall the Pieces extension in Chrome based browsers, click the three dots in the top right to open your browser menu.
Select More Tools > Extensions, locate the Pieces extension, then click Remove. When the verification popup appears, click Remove again to confirm.
To uninstall in Gecko/Firefox based browsers, click the settings icon (or the hamburger menu), then go to Add-ons and Themes and find the Pieces extension.
Click Remove, and confirm when prompted. The extension will be fully removed from your browser.