Troubleshooting Pieces for Obsidian

Having Trouble with Pieces for Obsidian?

If the Pieces for Obsidian Plugin isn’t working as expected, try the following troubleshooting steps.

All your Pieces data, including snippets, tags, embeddings, LTM-2 memory, settings, logs, and Pieces Copilot history, is securely stored in the com.pieces.os and com.pieces.pfd folders on your device.

This gives you full control over backups, sharing, and privacy.

Database & Log Paths

You can find your database and support logs at the path below for your specific platform.

macOS—~/Library/com.pieces.os/
Windows—C:\Users\<username>\Documents\com.pieces.os\
Linux—~/.local/share/com.pieces.os/

Don’t forget to switch username with our actual system username.

Logs, Backups & Cloud Functionality

This dedicated On-Device Storage documentation provides more information about finding your logs, creating manual backups outside of the Pieces Desktop App, and opting in to cloud-only features.

Sharing Logs—Zip the latest 2–3 files from …/production/support/logs/ and attach them to your issue or DM.
Backup & Reset—Copy com.pieces.os to back up your database—or copy zip it, and rename it something other than production to reset your database.
Cloud Functionality—Nothing moves off-device unless you enable Personal Cloud or call a third-party model (e.g. OpenAI).

Ensure You Have the Latest Versions

Confirm you’re using the latest version of the Pieces for Obsidian Plugin from the Obsidian community plugins marketplace. The minimum functioning version permitted is currently 1.7.7, and the newest version of PiecesOS, which has a minimum functioning version of 11.0.0.

Check PiecesOS Status

Ensure that PiecesOS is running. It must be active for the Pieces for Obsidian Plugin to function properly.

Restart Obsidian After Updates

If you’ve recently installed or updated PiecesOS or the Pieces for Obsidian Plugin, restart Obsidian to apply the updates properly.

If the issue still persists, contact the Pieces support team.

Refreshing Copilot Chats

If you're using the Pieces Copilot chat and disconnect from WiFi or encounter issues with a cloud-based LLM, you may need to refresh the chat. This can resolve issues such as the LLM appearing to "hang" (e.g., generating a response that turns out to be an infinite loop).

Click the three vertical dots in the top-right corner of your Copilot Chat window and select Refresh.