Getting Help

The fastest way to get a response depends on what you need—pick the option that matches your situation.

We read every report, reply to GitHub issues directly, and our founders regularly hop on calls with users to make sure Pieces fits your workflow.

Talk directly with our Founders & Engineering Leaders—great for onboarding help, workflow feedback, or walking through an issue together. Report bugs, request features, or track known issues for PiecesOS, the Desktop App, and any MCP integration. Chat with the team and other power users, catch release notes, and join weekly community events. Prefer not to use GitHub? Drop us a note—bug reports and feature requests both welcome. If you're reporting a bug, please include your logs. See [Finding Your Logs](#finding-your-logs) below—attaching them to your GitHub issue helps us reproduce and fix the problem much faster.

Finding Your Logs

PiecesOS and the Desktop App store logs in separate folders on some platforms. Zip the latest two or three log files before attaching them to a GitHub issue or sending them to support.

For database paths, manual backups, and cloud restore, see On-Device Storage.

### macOS Open Finder, press `⌘+shift+g`, and paste the path below: 
```plaintext
~/Library/com.pieces.os/production/Support/logs/
```

<Callout type="tip">
  If the `Library` folder is hidden, press `⌘+shift+.` (period) in Finder to toggle hidden files.
</Callout>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/support/mac_support.png" alt="" align="center" fullwidth="true" />

> Locating Pieces log files on macOS
### Windows Press `Win+R` to open the Run dialog, then paste: 
**PiecesOS:**
```powershell
C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support
```

**Desktop App:**
```powershell
C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs
```

<Callout type="tip">
  Replace `<username>` with your system username. If `AppData` is hidden, enable `View → Show → Hidden items` in File Explorer.
</Callout>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/support/windows_support.png" alt="" align="center" fullwidth="true" />

> Locating Pieces log files on Windows
### Linux Open your file manager or a terminal and navigate to: 
```bash
~/.local/share/com.pieces.os/
```

<Callout type="tip">
  In most file managers, press `ctrl+h` to toggle hidden files so you can see the `.local` directory.
</Callout>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/support/linux_support.png" alt="" align="center" fullwidth="true" />

> Locating Pieces log files on Linux

Joining the Community

If you're looking for longer-form conversations, feature brainstorms, or answers from other developers, our community spaces are the right place.

We use these channels to inform the roadmap—feature requests and discussions here genuinely shape what we build next.

  • Discord — live chat, release announcements, and weekly community events.
  • GitHub Discussions — longer-form threads, Q&A, and roadmap input.

Next Steps

Not finding what you need in the docs? Browse common setup and account questions, or jump back to the product overview.

Troubleshooting PiecesOS →

Privacy, Security & Your Data →