Desktop App Overview

The Pieces Desktop App is the central hub for your entire Pieces workflow. It provides direct access to all three pillars: Long-Term Memory, Conversational Search (Copilot), and Timeline.

Core Features

graph TB
    DA[Desktop App]
    DA --> TL[Timeline]
    DA --> CP[Copilot Chat]
    DA --> DR[Pieces Drive]
    DA --> ST[Settings & Config]
    TL --> SUM[Summaries]
    TL --> ACT[Activities]
    CP --> LLM[54+ LLMs]
    CP --> CTX[Context Engine]
    DR --> SAVE[Save Snippets]
    DR --> SEARCH[Search & Reuse]
    style DA fill:#000,stroke:#fff,color:#fff

Timeline

Your central workspace for reviewing workflow context captured by LTM-2.7. Generate one-click summaries, browse past activities, and search your workflow history.

Learn more about Timeline

Copilot

An intelligent AI assistant that uses your workflow context to provide relevant answers. Supports 54+ LLMs, both local and cloud-based.

Learn more about Copilot

Pieces Drive

Your personal code snippet library. Save, organize, search, edit, and share code snippets with enriched metadata.

Learn more about Pieces Drive

Getting Started

1. Download and install the Desktop App
2. Sign in with your preferred authentication method
3. Enable Long-Term Memory from the PiecesOS Quick Menu
4. Start capturing workflow context automatically

Platform Support

Platform	Minimum Version	Install Methods
macOS	13.0 (Ventura)	PKG, DMG, Homebrew
Windows	10 (1809)	AppInstaller, EXE, WinGet
Linux	Ubuntu 22.04+	Snap

Privacy and Data Storage

All Pieces data is stored locally in the following directories:

Platform	Path
macOS	~/Library/com.pieces.os/
Windows	C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\
Linux	~/.local/share/com.pieces.os/

Nothing leaves your device unless you explicitly enable cloud features like Personal Cloud or use a cloud-hosted LLM.

Updates

The Desktop App checks for updates automatically. You can also manually check:

1. Click your username in the top left
2. Hover over Update
3. Select Check for Desktop App Updates or Check for PiecesOS Updates

For troubleshooting, see the Troubleshooting guide.