Local-First Architecture

Pieces stores and processes everything on your device by default—code snippets, LTM-2.7 memory, user settings, Conversational Search history, and diagnostic logs all stay local.

When data can move to the cloud: Only when you explicitly enable Personal Cloud or use a cloud-based model provider (OpenAI, Anthropic, Google). In those cases, data is handled by the provider's privacy policy.

We're **SOC 2 Type II** certified and never use your data to train models. You can delete everything at any time by removing the `com.pieces.os` folder.

Where Your Database Lives

Platform Default path
macOS /Users/<username>/Library/com.pieces.os/
Windows C:/Users/<username>/Documents/com.pieces.os/
Linux /home/<username>/.local/share/com.pieces.os/

Inside com.pieces.os, the production folder contains your LTM-2.7 context and all other Pieces data. You can copy, compress, or relocate this folder to sync via OneDrive or migrate to another machine.

Replace `` with your OS account name.

Finding Your Logs

When opening a GitHub issue or contacting support, attaching recent logs helps diagnose problems quickly.

Platform Log path
macOS /Users/<username>/Library/com.pieces.os/production/support/logs/
Windows C:/Users/<username>/Documents/com.pieces.os/production/support/logs
Linux /home/<username>/.local/share/com.pieces.os/logs/

Logs rotate daily and are timestamped (e.g., log-05062025). Zip the latest two or three files and attach them to your GitHub issue or Discord DM.

Create a Manual Backup

Close the Pieces Desktop App and PiecesOS. Copy the entire `com.pieces.os` folder to your backup location (USB, NAS, or cloud storage): 
* **macOS:** `/Users/<username>/Library/com.pieces.os/`
* **Windows:** `C:/Users/<username>/Documents/com.pieces.os/`
* **Linux:** `/home/<username>/.local/share/com.pieces.os/`

Restore on a New Machine

Install PiecesOS on the new machine via the [Pieces Desktop App](/products/desktop/onboarding) or [manual installation](/products/core-dependencies/pieces-os/manual-installation). Replace the newly created `com.pieces.os` folder with your backup. Relaunch PiecesOS and the Pieces Desktop App.

Start Fresh (Reset)

Close the Pieces Desktop App and PiecesOS. Rename the `production` folder inside `com.pieces.os` to something else (e.g., `production-backup`). Relaunch PiecesOS. It will create a brand-new, empty database. Keep the renamed folder as a backup in case you need it.

Need Help?

Open a GitHub issue for PiecesOS, the Pieces Desktop App, or any MCP integration at our GitHub repository.

You can also leave feedback or report a bug here.