You can create a backup either directly through the application interface or manually by navigating your computer's file system. : Click your username in the top-left corner. Hover over Settings and select Personal Cloud . Click the Backup & Restore icon . Select Create Backup to save a snapshot. Manual Backup (Local) : Quit all Pieces applications (including Pieces OS). Locate the com.pieces.os folder on your machine: macOS : /Users/ /Library/com.pieces.os/ Windows : C:/Users/ /Documents/com.pieces.os/ Linux : /home/ /.local/share/com.pieces.os/
: Install Pieces OS on your new machine, then replace the newly created com.pieces.os folder with your backed-up version before restarting the app. Key Features and Availability
Copy this folder to a secure location, such as an external drive or cloud storage. How to Restore Your Data app-backup
Restoring your data is useful when moving to a new machine or recovering from a system failure.
: Access the same menu under Settings > Personal Cloud > Backup & Restore , choose a previous backup from the list, and click the Restore icon . You can create a backup either directly through
: Backups include not just code snippets, but all associated metadata like tags, related links, and AI-generated titles.
: Backups are private and stored locally unless you opt-in to the Personal Cloud . Click the Backup & Restore icon
In the application, the Backup & Restore feature allows you to safeguard your snippets, metadata, and generated context. This is especially important as Pieces functions as an on-device context engine, storing all your long-term memories locally by default. How to Create a Backup