diff --git a/public/content/cli.md b/public/content/cli.md index 262d9ec..e6d90b2 100644 --- a/public/content/cli.md +++ b/public/content/cli.md @@ -30,7 +30,7 @@ The Pieces CLI offers users a straightforward way to manage and utilize saved co - Pieces Quick Guides help you quickly understand and utilize powerful features like the Long-Term (LTM-2.7) Memory Engine and Conversational Search. [Click here to get started.](/products/quick-guides/overview) + Pieces Quick Guides help you quickly understand and utilize powerful features like the Long-Term (LTM-2.7) Memory Engine and Conversational Search. [Get started with Quick Guides.](/products/quick-guides/overview) This software is designed to offer **two main features**: AI Assistance with Conversational Search and material management within the Pieces Drive. diff --git a/public/content/core-dependencies/ollama/manual-installation.md b/public/content/core-dependencies/ollama/manual-installation.md index 1dfce62..3dc55d7 100644 --- a/public/content/core-dependencies/ollama/manual-installation.md +++ b/public/content/core-dependencies/ollama/manual-installation.md @@ -116,4 +116,4 @@ If you no longer need local AI models or wish to remove the Ollama wrapper from ## Next Steps -You can read documentation about what [local LLMs are currently available](/products/core-dependencies/ollama/supported-models) on Ollama and are supported by PiecesOS, or [click here for troubleshooting](/products/core-dependencies/ollama/troubleshooting) if you’re experiencing installation issue. \ No newline at end of file +You can read documentation about what [local LLMs are currently available](/products/core-dependencies/ollama/supported-models) on Ollama and are supported by PiecesOS, or the [Ollama troubleshooting guide](/products/core-dependencies/ollama/troubleshooting) if you’re experiencing installation issue. \ No newline at end of file diff --git a/public/content/core-dependencies/on-device-storage.md b/public/content/core-dependencies/on-device-storage.md index 845e22a..5912e5a 100644 --- a/public/content/core-dependencies/on-device-storage.md +++ b/public/content/core-dependencies/on-device-storage.md @@ -15,7 +15,7 @@ Pieces stores and processes everything on your device by default—code snippets **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. + 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` and `com.pieces.pfd` folders from your Library (macOS) or equivalent paths on other platforms. ## Where Your Database Lives @@ -23,11 +23,14 @@ Pieces stores and processes everything on your device by default—code snippets | **Platform** | **Default path** | | --- | --- | | *macOS* | `/Users//Library/com.pieces.os/` | -| *Windows* | `C:/Users//Documents/com.pieces.os/` | +| *Windows (PiecesOS)* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\` | +| *Windows (Desktop App)* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\` | | *Linux* | `/home//.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. +The Pieces Desktop App stores additional data in a separate `com.pieces.pfd` folder (`~/Library/com.pieces.pfd/` on macOS, or `...\Pieces for Developers\com.pieces.pfd\` on Windows). For a full backup, copy both folders from their respective parent directories on Windows. + Replace `` with your OS account name. @@ -38,13 +41,30 @@ When opening a GitHub issue or contacting support, attaching recent logs helps d | **Platform** | **Log path** | | --- | --- | -| *macOS* | `/Users//Library/com.pieces.os/production/support/logs/` | -| *Windows* | `C:/Users//Documents/com.pieces.os/production/support/logs` | +| *macOS (PiecesOS)* | `/Users//Library/com.pieces.os/production/Support/logs/` | +| *macOS (Desktop App)* | `/Users//Library/com.pieces.pfd/production/logs/` | +| *Windows (PiecesOS)* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support\` | +| *Windows (Desktop App)* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs\` | | *Linux* | `/home//.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. + + On Windows, if `AppData` is hidden in File Explorer, enable `View` → `Show` → `Hidden items`. You can also press `Win+R` and paste the path above. PiecesOS and the Desktop App use different parent folders under `Mesh Intelligent Technologies, Inc\`. + + +Zip the latest two or three log files from the path above and attach them to your GitHub issue or Discord DM. + +## Backup & Restore -## Create a Manual Backup +Pieces supports two backup approaches. Use **manual folder backup** for a full copy of your on-device database (including Long-Term Memory). Use **Personal Cloud backup** for snapshots of app data you can restore from the Desktop App on any device where you're signed in. + +| Method | Best for | Requires | +| --- | --- | --- | +| **Manual folder backup** | Full LTM database, migration, offline archives | Quitting Pieces, copying `com.pieces.os` (and `com.pieces.pfd`) | +| **Personal Cloud backup** | Snippets, Drive files, settings, chat history | Connected [Personal Cloud](/products/desktop/configuration/account#personal-cloud) | + +### Manual Backup + +Copy your on-device database folders directly. This is the most complete option if you need everything in `production`, including Long-Term Memory context. @@ -54,21 +74,49 @@ Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two Copy the entire `com.pieces.os` folder to your backup location (USB, NAS, or cloud storage): - * **macOS:** `/Users//Library/com.pieces.os/` - * **Windows:** `C:/Users//Documents/com.pieces.os/` + * **macOS:** `/Users//Library/` (copy both `com.pieces.os` and `com.pieces.pfd`) + * **Windows:** Copy `...\Pieces OS\com.pieces.os\` and `...\Pieces for Developers\com.pieces.pfd\` from `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\` * **Linux:** `/home//.local/share/com.pieces.os/` +### Backup via Personal Cloud + +Create a snapshot from the Pieces Desktop App. Backups are stored in your personal Pieces Cloud and can be restored or deleted from the same modal. + + + + Click your `User Profile` in the top left, then hover over `Settings` and select `Account`. + + + + Scroll to the *Personal Cloud* section. In *Backup & Restore Data*, click the `Restore Icon` (circular arrow) to open the modal. + + + + In the *Create Backup* section, click the `Cloud Icon with Upward Arrow` to upload a new backup to your personal Pieces Cloud. + + + +Cloud backups include snippets, Pieces Drive files, user preferences, Conversational Search data, search and tagging data, and linked account connections (without passwords). They do not replace a full manual copy of your `com.pieces.os` database if you need to preserve raw Long-Term Memory data. + + + For the full backup workflow, including what's included, viewing backups, and deleting old snapshots, see [Backup & Restore Data](/products/desktop/configuration/account#backup--restore-data) in Account settings. + + ## Restore on a New Machine +### Restore a Manual Backup + +Use this when you copied `com.pieces.os` (and optionally `com.pieces.pfd`) to another drive or 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. + Replace the newly created `com.pieces.os` folder with your backup. Also restore `com.pieces.pfd` if you backed it up. @@ -76,6 +124,24 @@ Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two +### Restore a Personal Cloud Backup + +Use this when you created a backup through *Backup & Restore Data* in Account settings. + + + + On the target machine, open `Settings` → `Account`, scroll to *Personal Cloud*, and connect your cloud if you are not already signed in. + + + + In the *Personal Cloud* section, click the `Restore Icon` in *Backup & Restore Data* to open the modal. + + + + In the *Backups* list, find the snapshot you want, then click the `Restore Icon` on that entry and confirm when prompted. + + + ## Start Fresh (Reset) @@ -94,6 +160,12 @@ Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two *** +## Next Steps + +* [Long-Term Memory settings](/products/desktop/configuration/long-term-memory) — clear stored data, app access, and permissions. +* [Account settings](/products/desktop/configuration/account#backup--restore-data) — Personal Cloud backup and restore. +* [Support](/products/support) — report issues and find platform log paths. + ## Need Help? Open a GitHub issue for PiecesOS, the Pieces Desktop App, or any MCP integration at our GitHub repository. diff --git a/public/content/core-dependencies/pieces-os.md b/public/content/core-dependencies/pieces-os.md index bd36ab7..a5b535a 100644 --- a/public/content/core-dependencies/pieces-os.md +++ b/public/content/core-dependencies/pieces-os.md @@ -13,9 +13,7 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o **PiecesOS** is a background service that runs on your machine. It orchestrates local data processing, manages on-device machine learning models, and serves as the bridge between your workflow and every Pieces product—including the [Pieces Desktop App](/products/desktop/onboarding), [MCP integrations](/products/mcp), and the [CLI](/products/cli). -PiecesOS bridging all Pieces products and services - -> PiecesOS bridging all Pieces products and services + ## What PiecesOS Does diff --git a/public/content/core-dependencies/pieces-os/cloud-services-deprecation.md b/public/content/core-dependencies/pieces-os/cloud-services-deprecation.md new file mode 100644 index 0000000..7607f06 --- /dev/null +++ b/public/content/core-dependencies/pieces-os/cloud-services-deprecation.md @@ -0,0 +1,64 @@ +--- +title: "Update Required for Cloud Services" +path: /core-dependencies/pieces-os/cloud-services-deprecation +visibility: PUBLIC +status: PUBLISHED +description: "Action required by Friday, June 5th 2026: cloud services for PiecesOS versions prior to 12.4.0 will be deprecated. Update before that date to continue using Chat, Work Summaries, and Single Click Summaries." +metaTitle: "Update Required for Cloud Services | PiecesOS" +metaDescription: Cloud services for PiecesOS versions prior to 12.4.0 will be deprecated on Friday, June 5th 2026. Update to 12.4.0 or later to continue using Chat, Work Summaries, and Single Click Summaries. +--- + +## Summary + +On Friday, June 5th 2026, we will be deprecating cloud services for all PiecesOS versions prior to 12.4.0. If you are running an older version of PiecesOS, you will need to update to 12.4.0 or later before that date to continue using cloud-backed features. + +## Who is Affected + +You are affected if your PiecesOS version is lower than 12.4.0. + +To check your version: + +* **Desktop App**: `Settings` → `About` → *PiecesOS Version* + +## What Will Stop Working After June 6th, 2025 + +On deprecated versions, the following features will no longer function and will return an error: + +* **Chat** — conversations, follow-ups, and any model-backed responses will fail +* **Work Summaries** — will fail to generate +* **Single Click Summaries** — will fail to generate + +All other functionality (local features, account access, etc.) will continue to work as expected. + +## What You Need to Do + +Update PiecesOS to 12.4.0 or later before Friday, June 5th 2026. This is the only required action. + +### Recommended: Update from the Pieces Tray Icon + +On all operating systems, the easiest way to update is directly from the Pieces icon in your system tray / toolbar. Click the Pieces icon, and PiecesOS will check for updates automatically — if a new version is available, you can install it from there. + +### Alternative: Update from Inside the Desktop App + +You can also trigger the update from within the Pieces Desktop App by opening the user menu in the top-left and selecting `Check for Updates`. + +### Other Install Methods + +* **Homebrew (macOS/Linux)**: `brew upgrade pieces-os` +* **Manual installs**: follow the [manual installation guide](/products/core-dependencies/pieces-os/manual-installation) + +After updating, restart PiecesOS and verify your version is 12.4.0 or higher. + +## Why We Are Making This Change + +Older PiecesOS versions were built against legacy cloud infrastructure that we are retiring in favor of our new agentic engine and updated backend. Maintaining backward compatibility with the old infrastructure was holding back security, reliability, and the ability to ship improvements to Chat and the broader product. + +## Need Help? + +If you run into trouble updating, or if updating doesn't resolve your issue: + +* Open a new issue in this repository with your PiecesOS version, OS, and a description of what you're seeing +* Or email us directly at [support@pieces.app](mailto:support@pieces.app) +* Or book a quick [support call](https://calendar.google.com/calendar/u/0/appointments/schedules/AcZssZ3bJHPPSJJHom2WwsPf5KcNlu-vRZsVa3DO1gJ7q4VIwExD1NUFBXlc7w8JGnEoSd2TLxP3eFbh) + +Thanks for being part of the Pieces community. diff --git a/public/content/core-dependencies/pieces-os/long-term-memory.md b/public/content/core-dependencies/pieces-os/long-term-memory.md index 7dadccf..9248dfb 100644 --- a/public/content/core-dependencies/pieces-os/long-term-memory.md +++ b/public/content/core-dependencies/pieces-os/long-term-memory.md @@ -42,7 +42,7 @@ The agent decides what to access based on your question. You don't need to confi ### What This Enables -The agentic foundation powers features like [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep) (summaries that take action on your behalf), [Reflection Mode](/products/desktop/conversational-search/using-conversational-search#reflection-mode) (metacognition for the agent), and deeper multi-step investigations in chat. +The agentic foundation powers features like [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep) (summaries that take action on your behalf), [Reflection Mode](/products/desktop/conversational-search#reflection-mode) (metacognition for the agent), and deeper multi-step investigations in chat. *** diff --git a/public/content/core-dependencies/pieces-os/troubleshooting.md b/public/content/core-dependencies/pieces-os/troubleshooting.md index 3d6858c..967447a 100644 --- a/public/content/core-dependencies/pieces-os/troubleshooting.md +++ b/public/content/core-dependencies/pieces-os/troubleshooting.md @@ -162,24 +162,23 @@ An outdated operating system can prevent PiecesOS from running. Minimum requirem ## Windows: Controlled Folder Access -If you've enabled Controlled Folder Access (CFA), PiecesOS may fail to launch because it writes data to the Documents folder. Add the PiecesOS executable path to your CFA allowlist, or disable CFA if it's not required. +If you've enabled Controlled Folder Access (CFA), PiecesOS may fail to launch if Windows blocks writes under AppData. Add the PiecesOS executable to your CFA allowlist, or disable CFA if it's not required. ## Finding Pieces Logs -Attach recent logs when opening a GitHub issue or contacting support—it helps diagnose problems in minutes. +Attach recent logs when opening a GitHub issue or contacting support. It helps diagnose problems in minutes. -**PiecesOS logs:** +See [Finding Your Logs](/products/core-dependencies/on-device-storage#finding-your-logs) for the full path table, or use these quick references: -| **Platform** | **Path** | +| **Platform** | **PiecesOS logs** | | --- | --- | -| *macOS* | `/Users//Library/com.pieces.os/production/support/logs/` | -| *Windows* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\` | +| *macOS* | `/Users//Library/com.pieces.os/production/Support/logs/` | +| *Windows* | `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support\` | | *Linux* | `/home//.local/share/com.pieces.os/logs/` | -**Pieces Desktop logs (Windows):** -``` -C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces Desktop\com.pieces.os\production\ -``` +**Desktop App logs (Windows):** `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs\` + +**Desktop App logs (macOS):** `/Users//Library/com.pieces.pfd/production/logs/` Replace `` with your OS account name. Zip the latest two or three log files and attach them to your GitHub issue. diff --git a/public/content/desktop.md b/public/content/desktop.md index 1f51271..de37918 100644 --- a/public/content/desktop.md +++ b/public/content/desktop.md @@ -80,7 +80,7 @@ Use [Conversational Search](/products/desktop/conversational-search) as your mai ## Configuration -Customize your Pieces Desktop App experience through *Settings*, which includes options for Account (with Personal Cloud and Telemetry), Long-Term Memory, Models, Copilot Chats, Machine Learning, Model Context Protocol (MCP), Connected Applications, Views & Layouts, Appearance, and Troubleshooting. +Customize your Pieces Desktop App through *Settings*: **Account** (profile, Personal Cloud, backup, telemetry), **Long-Term Memory**, **MCP**, **Connectors**, **Appearance**, and **Troubleshooting**. Choose models from the Conversational Search chat picker; see [Models in chat](/products/desktop/conversational-search/models) for cloud vs local selection. Explore all configuration options to customize your Pieces Desktop experience. diff --git a/public/content/desktop/configuration.md b/public/content/desktop/configuration.md index 9c5e7bf..93c6e7e 100644 --- a/public/content/desktop/configuration.md +++ b/public/content/desktop/configuration.md @@ -13,8 +13,8 @@ metaDescription: Customize Pieces with settings for visuals, Pieces Timeline enr Open Settings from the home view to adjust account and cloud behaviors, check your application versions, change views and layouts, and more. - - Click your profile picture in the top left of the home view. + + Click your `User Profile` in the top left of the home view. Profile menu open with Settings and quick category options @@ -24,7 +24,7 @@ Open Settings from the home view to adjust account and cloud behaviors, check yo - You can either select one of the quick options (Account, Long-Term Memory, Models, MCP, Appearance, Troubleshooting) to jump directly to that category, or select `All` at the top of the quick options to open the full Settings view with all categories. You can also select `Log Out` at the bottom of the menu to sign out of your account. + You can either select one of the quick options (Account, Long-Term Memory, MCP, Connectors, Appearance, Troubleshooting) to jump directly to that category, or select `All` at the top of the quick options to open the full Settings view with all categories. You can also select `Log Out` at the bottom of the menu to sign out of your account. @@ -79,16 +79,16 @@ Manage long-term memory preferences and data. Configure the Long-Term Memory Eng Configure the Long-Term Memory Engine, manage app access control, system permissions, and optimize performance. -## Models +## Connectors -Manage AI models and model preferences. Configure processing modes, set up local model runtime with Ollama, and control which AI models are available for use in Pieces. +Link external services such as Google Calendar so Pieces can read calendar context and take actions on your behalf. Manage connections from the Connectors tab in Settings. -Models settings with capabilities, local runtime, and model management +Connectors settings showing Google Calendar and upcoming integrations -> Models settings showing Model Capabilities, Local Model Runtime, and Model Management sections +> Connectors settings showing connected and available integrations - - Configure processing modes, set up Ollama for local models, and enable or disable specific AI models. + + Connect Google Calendar, authorize services, and learn how calendar context appears in summaries. ## Model Context Protocol (MCP) diff --git a/public/content/desktop/configuration/long-term-memory.md b/public/content/desktop/configuration/long-term-memory.md index dfc354a..208f223 100644 --- a/public/content/desktop/configuration/long-term-memory.md +++ b/public/content/desktop/configuration/long-term-memory.md @@ -260,8 +260,8 @@ Remove persisted data captured by the Long-Term Memory Engine. You can scope del Click your `User Profile` in the top left, then hover over `Settings` and select `Long-Term Memory`. - - In the *Stored Data* section, click `Manage Data` to open the data management panel. + + In the *Stored Data* section, click `Clear Long-Term Memory Data...` to open the data management panel. diff --git a/public/content/desktop/conversational-search.md b/public/content/desktop/conversational-search.md index 2c359dd..87cb12d 100644 --- a/public/content/desktop/conversational-search.md +++ b/public/content/desktop/conversational-search.md @@ -3,9 +3,9 @@ title: Conversational Search path: /desktop/conversational-search visibility: PUBLIC status: PUBLISHED -description: Conversational Search is the ability to talk with your memories. Have conversations with your captured workflow context with LTM-2.7. +description: Chat with workflow context captured by Long-Term Memory in the Pieces Desktop App. metaTitle: Conversational Search | Pieces Docs -metaDescription: Conversational Search is the ability to talk with your memories. Have conversations with your captured workflow context with LTM-2.7. +metaDescription: Use Conversational Search in Pieces Desktop to ask questions about captured workflow context, with optional filters and file attachments. --- -> Homepage showing Conversational Search section with suggested chats, recent chats, and Start New Chat +> Conversational Search homepage with suggested chats, recent chats, and Start New Chat -## The Conversational Search Homepage +## Getting Started on the Homepage -When you open Conversational Search, the homepage gives you three ways to get started: +When you open Conversational Search from the Desktop App home view, you have three entry points: -* **Suggested Chats for You** — Pieces generates personalized conversation starters based on your recent workflow activity. Click any suggestion to jump straight into a focused chat. -* **Resume Recent Chats** — Pick up where you left off with your most recent conversations, displayed as scrollable cards showing the chat title and memory count. -* **Start New Chat** — Type a question into the input field at the bottom to begin a brand new conversation with your memories. +* **Suggested Chats for You** — Conversation starters based on recent activity. Click one to open a thread; responses include Related Timeline Events showing which memories were used. +* **Resume Recent Chats** — Cards for your latest threads. Click any card to continue with full history intact. +* **Start New Chat** — Type in the input at the bottom and press `Enter` to ask your own question. -## Filter by Apps, Time & Modality + + Click `Refresh suggestions` (circular icon beside the suggestions grid) to regenerate prompts from your latest activity. Click `Reveal previous chats in timeline` (panel icon on the *Resume Recent Chats* row) to open older threads in [Pieces Timeline](/products/desktop/timeline). + -Click the `Filter By...` button in the bottom toolbar to scope which memories are included. Filter by **Apps** (e.g., Chrome, VS Code), **Time** (presets like "Yesterday" or custom ranges), or **Modality** (Vision, Clipboard, Audio, Google Calendar). +**Example questions:** -## Chat from a Specific Event +* "Why did we choose PostgreSQL over MySQL for the auth project?" +* "What was the blocker I hit last Tuesday afternoon?" +* "What did Sarah and I discuss about the API redesign in Teams?" -Ask questions about one specific memory or Timeline Event with pre-loaded context. Perfect for drilling into details of a particular workflow moment. +## While You Chat -* **Review decisions** — understand why past choices were made -* **Review work sessions** — dive deep into what happened during a particular period -* **Get details** about a specific Timeline Event, including discussions, code, and decisions +The bottom toolbar controls how each conversation runs: -## Reflection Mode +| Control | What it does | +| --- | --- | +| `+` | Attach files or folders (or drag and drop into the input) | +| `Filter By...` | Limit memories by app, time, or modality | +| Model selector | Pick a cloud model mode (Fast, Balanced, or Extra Thinking) | +| `lotus icon` | Toggle *Reflection Mode* for deeper reasoning on hard questions | +| `Send` | Send a message (`Enter` queues a follow-up while the agent is still responding) | -Reflection Mode enables the agent to reflect on its own reasoning and self-correct in real time. When enabled, the agent produces higher-quality responses by evaluating its logic as it generates answers, catching errors and refining its output before delivering it to you. +On active threads, the `⋮` menu at the top lets you **Pin**, **Refresh**, or **Delete** the chat. Token usage appears in the chat header so you can see input, output, reasoning, and cache totals for metered or BYOK plans. -Toggle Reflection Mode on or off using the `lotus icon` in the *bottom toolbar* next to the model selector. Deep research and analysis activate dynamically when needed based on the complexity of your prompt—no manual activation required. +To scope a chat to **one** Timeline Event or summary, open that item in Timeline and choose `Chat` from the three-dots menu (⋮). See [Add Context to Your Chats](/products/desktop/conversational-search/setting-context). *** ## Explore Conversational Search - Use Apps, Time, and Modality filters to narrow which memories you're searching through. + Use the Filter By menu to narrow which memories the agent can use in a thread. - Control LTM context, start chats from Timeline Events, and view source memories. + Attach files, start chats from Timeline Events, and review source memories in the Relevant Summaries sidebar. - Switch between cloud and local AI models, browse the catalog, and download on-device models. + Switch between Fast, Balanced, and Extra Thinking modes for Claude, Gemini, and GPT. - Use specific keywords, time ranges, source apps, and follow-up techniques for better results. + Use keywords, time ranges, app names, and follow-ups to get sharper answers. + +*** + +If Conversational Search is not what you need, explore [Pieces Timeline](/products/desktop/timeline) to browse captured events and summaries, or [Single-Click Summaries](/products/desktop/single-click-summaries) for one-click workflow reports. diff --git a/public/content/desktop/conversational-search/setting-context.md b/public/content/desktop/conversational-search/setting-context.md index 20b2269..c979fc7 100644 --- a/public/content/desktop/conversational-search/setting-context.md +++ b/public/content/desktop/conversational-search/setting-context.md @@ -55,6 +55,25 @@ Start context-specific chats directly from any Timeline Event. When you start a You can also use the **three-dots menu** (⋮) on any event and choose `Chat` to scope a conversation to that item. See [Chat from a summary](/products/desktop/timeline/event-actions#chat-from-a-summary). +## Attach Files and Folders + +Add local files or folders so Conversational Search can use their contents alongside LTM memories. + + + + Click the `+` button to the left of the chat input field. + + + Browse and select files or folders, or drag and drop them into the input area. + + + Attached items appear as context chips above the input field. + + + Type your question. The agent uses file contents together with your captured memories. + + + ## Viewing the Relevant Summaries Sidebar After receiving a response, see exactly which Timeline Events were used to generate it. diff --git a/public/content/desktop/conversational-search/using-conversational-search.md b/public/content/desktop/conversational-search/using-conversational-search.md index 3eacf89..19d0b64 100644 --- a/public/content/desktop/conversational-search/using-conversational-search.md +++ b/public/content/desktop/conversational-search/using-conversational-search.md @@ -8,6 +8,10 @@ metaTitle: Talk with Your Memories | Pieces Docs metaDescription: Learn how to talk with your memories, filter searches, switch models, and work with responses in Conversational Search. --- + + Use [Conversational Search](/products/desktop/conversational-search) and its subpages ([Filter by Apps, Time & Modality](/products/desktop/conversational-search/scoping-your-prompt), [Add Context](/products/desktop/conversational-search/setting-context), [Choose a Model](/products/desktop/conversational-search/models), [Write Better Prompts](/products/desktop/conversational-search/prompting-guide)) for current documentation. + + ***Conversational Search*** is the ability to talk with your memories through **Agentic Chats**. Powered by [Agentic Long-Term Memory](/products/core-dependencies/pieces-os#ltm-27), the agent reasons across your artificial memory in multiple turns, following threads, cross-referencing context, and building toward complete answers instead of guessing in one shot. Ask specific questions, search through your memories, and filter by apps or time ranges to customize which memories you're talking with. The agent can search your memories, the web, your calendar, local files, and browser history to build complete answers. diff --git a/public/content/desktop/download.md b/public/content/desktop/download.md index 77d995f..f76aef5 100644 --- a/public/content/desktop/download.md +++ b/public/content/desktop/download.md @@ -58,7 +58,7 @@ For detailed instructions, refer to our comprehensive [Windows installation and *Windows 10 (1809) or higher* -If you want alternative installation methods (`.exe`, WinGet), [click here.](/products/desktop/troubleshooting/windows#alternative-installation-methods) +For alternative installation methods (`.exe`, WinGet), see [Windows alternative installers](/products/desktop/troubleshooting/windows#alternative-installation-methods). ### Linux diff --git a/public/content/desktop/navigation/settings.md b/public/content/desktop/navigation/settings.md index 2cf8eb0..b91716a 100644 --- a/public/content/desktop/navigation/settings.md +++ b/public/content/desktop/navigation/settings.md @@ -24,15 +24,11 @@ You can also open the **Power Menu**, type ‘settings’ in the search field, a ## Understanding the Settings Layout -When you open **Settings**, you’ll find several configuration categories on the left side and an `All` tab at the top. +When you open **Settings**, you'll see categories in the left sidebar and an `All` tab at the top. -Click any category to reveal its associated options in the main panel. +In Pieces 6.0, the sidebar includes **Account**, **Long-Term Memory**, **MCP**, **Connectors**, **Appearance**, and **Troubleshooting**. Click any category to show its options, or select `All` to view every setting at once. -* `Categories`: Organized for quick navigation. - -* `All`**:** Displays every setting in one place. - -You can review each section individually or see everything at once by selecting `All`**.** +From your profile menu, quick paths jump directly to **LTM-2.7**, **LTM Sources**, **LTM Audio**, or full **Settings**. ### Account & Integrations @@ -74,35 +70,21 @@ The [Long-Term Memory](/products/desktop/configuration/long-term-memory) setting * `Clear LTM Data`: Remove persisted data captured by the Long-Term Memory Engine. -### Models - -The [Models](/products/desktop/configuration/models) settings allow you to configure processing modes, set up local model runtime with Ollama, and control which AI models are available for use in Pieces. - -* `Processing Mode`: Choose between Cloud, Local, or Blended processing modes. - -* `Ollama Status`: Check if Ollama is installed, activated, and ready for local model processing. - -* `Model Management`: Enable or disable specific AI models from different providers (OpenAI, Anthropic, Google, Microsoft, Meta, IBM, etc.). - -Processing mode selection for ML in Settings - -### Views & Layouts - -[Views & Layouts](/products/desktop/configuration/views-layouts) controls how you see content in Pieces. +### Model Context Protocol (MCP) -You can set a `Default Layout`, choose how items are sorted in list or gallery views, and select a `Default Search Mode` like `Neural Code Search (NCS)`. +The [MCP](/products/desktop/configuration/mcp) tab shows server URLs and setup links for integrating Pieces with Cursor, GitHub Copilot, Goose, and other MCP-compatible tools. -You’ll also find options for `Confirmation Settings` (for specific actions), toggles for usage or metrics summaries, and a `Default Toolbar` for newly saved snippets. +### Connectors -* `Default Layout`: Choose your preferred view on launch. +[Connectors](/products/desktop/connectors) link external services (such as Google Calendar) so Pieces can read calendar context and perform actions on your behalf. -* `Default Search Mode`: Select how you search by default. +* `Connect`: Authorize a service from the Connectors pane. -* `Confirmation Settings`: Control dialog prompts. +* `Status`: See which connectors are connected. -* `Default Toolbar`: Assign a default toolbar to new snippets. +### Models (in chat) -Changing Workstream Activity view layout +In Pieces 6.0, you choose AI models from the picker in [Conversational Search](/products/desktop/conversational-search/models), not from a top-level Settings category. For Ollama setup and processing modes, see [Models settings](/products/desktop/configuration/models) if your build still exposes that page. ### Appearance diff --git a/public/content/desktop/onboarding.md b/public/content/desktop/onboarding.md index dac6973..815fc2d 100644 --- a/public/content/desktop/onboarding.md +++ b/public/content/desktop/onboarding.md @@ -112,7 +112,7 @@ Conversational Search lets you ask questions about your workflow and get context ### Accessing Conversational Search -Access Conversational Search directly from the homepage to ask questions about your workflow, with LTM providing context from your captured memories. You can switch between cloud-hosted and local models using the model selector in the chat interface. +Access Conversational Search directly from the homepage to ask questions about your workflow, with LTM providing context from your captured memories. Switch models from the [chat model selector](/products/desktop/conversational-search/models). Typing a question into Conversational Search diff --git a/public/content/desktop/troubleshooting/macos.md b/public/content/desktop/troubleshooting/macos.md index a1be109..f9fc542 100644 --- a/public/content/desktop/troubleshooting/macos.md +++ b/public/content/desktop/troubleshooting/macos.md @@ -30,7 +30,7 @@ If you're having trouble installing the Pieces Desktop App using the recommended Our `.pkg` files install both PiecesOS and the Pieces Desktop App in a single guided sequence. - If you’re not sure which installer you need based on your device’s CPU, [click here.](/products/desktop/troubleshooting/macos#checking-cpu-type) + Not sure which installer you need? See [how to check your CPU type](/products/desktop/troubleshooting/macos#checking-cpu-type) diff --git a/public/content/desktop/troubleshooting/windows.md b/public/content/desktop/troubleshooting/windows.md index abb40d9..49c0d07 100644 --- a/public/content/desktop/troubleshooting/windows.md +++ b/public/content/desktop/troubleshooting/windows.md @@ -143,13 +143,13 @@ To decide which apps PiecesOS has access to, you can [easily enable and disable ## Accessing Pieces Logs -On Windows machines, Pieces writes its log files under your local AppData folder. You’ll find two separate folders depending on which component you’re using: +On Windows, PiecesOS and the Desktop App store logs under separate folders in AppData. See [On-Device Storage](/products/core-dependencies/on-device-storage#finding-your-logs) for backup and database paths. -* **Pieces OS (POS) logs**:\ +* **PiecesOS logs:**\ `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support` -- **Pieces Desktop (PFD) logs**:\ - `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.pfd\production\Support` +* **Desktop App logs:**\ + `C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs` Replace \ with your Windows account name. diff --git a/public/content/meet-pieces.md b/public/content/meet-pieces.md index 145d9ec..25e6fcd 100644 --- a/public/content/meet-pieces.md +++ b/public/content/meet-pieces.md @@ -14,7 +14,7 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o ## Introducing Pieces -This documentation is designed to provide a high-level overview of Pieces' features and functionalities, with a quick-start and troubleshooting guides for macOS, Windows, and Linux to help you get started with Pieces as quickly as possible. +This documentation provides a high-level overview of the [Pieces Desktop App](/products/desktop) and [PiecesOS](/products/core-dependencies/pieces-os), with quick-start and troubleshooting guides for macOS, Windows, and Linux to help you get started as quickly as possible. Let’s answer a few basic questions: @@ -24,11 +24,11 @@ At its core, Pieces is an all-in-one productivity tool that helps you work *smar There are **\[3]** core pillars of Pieces functionality: -1. [Long-Term Memory Engine (LTM-2.7)](/products/meet-pieces/fundamentals#ltm-27): A powerful, AI-powered live context framework that understands what you’re working on across your entire development workflow. The LTM-2.7 helps by outsourcing the burden of memory and retrieval from the developer to AI to maximize space for creativity driven by human intent. +1. [Long-Term Memory Engine (LTM-2.7)](/products/core-dependencies/pieces-os/long-term-memory): A powerful, AI-powered live context framework that understands what you’re working on across your entire development workflow. The LTM-2.7 helps by outsourcing the burden of memory and retrieval from the developer to AI to maximize space for creativity driven by human intent. 2. [Pieces Timeline](/products/desktop/timeline): Your central workspace for accessing workflow context captured by Long-Term Memory. Generate summaries, review past activities, browse captured memories, and interact with your workflow history—all in one place. -3. [Conversational Search](/products/meet-pieces/fundamentals#pieces-copilot): An intelligent assistant that helps with answering questions, generating content, and providing guidance while utilizing a LLM of your choice—with an adjustable context window ranging from conversation-only to entire project folders. +3. [Conversational Search](/products/desktop/conversational-search): An intelligent assistant that helps with answering questions about your workflow, generating content, and providing guidance using the model you choose—with filters for apps, time ranges, and modalities, plus optional file and folder context. ### Who is Pieces For? @@ -206,7 +206,7 @@ By installing PiecesOS, you enable the full functionality of the desktop app and 3. Work as usual—Pieces captures context automatically - Pro tip: See how to toggle Long-Term Memory in the Quick Menu [here](https://docs.pieces.app/products/core-dependencies/pieces-os/quick-menu#ltm-25-engine). + Pro tip: See how to toggle Long-Term Memory in the [Quick Menu](/products/core-dependencies/pieces-os/quick-menu). **Captured automatically:** diff --git a/public/content/meet-pieces/linux-installation-guide.md b/public/content/meet-pieces/linux-installation-guide.md index 4e09bca..913ae38 100644 --- a/public/content/meet-pieces/linux-installation-guide.md +++ b/public/content/meet-pieces/linux-installation-guide.md @@ -35,4 +35,4 @@ Pieces for Linux is available via **Snap** (recommended for Ubuntu) or **Flatpak ## Additional Resources -Click here for additional [documentation on troubleshooting](/products/meet-pieces/troubleshooting/linux) or reach out to [support.](/products/support) +See the [Linux troubleshooting guide](/products/meet-pieces/troubleshooting/linux) or reach out to [support](/products/support) for help. diff --git a/public/content/meet-pieces/linux-installation-guide/flatpak.md b/public/content/meet-pieces/linux-installation-guide/flatpak.md index 3cdf39f..0a54d5a 100644 --- a/public/content/meet-pieces/linux-installation-guide/flatpak.md +++ b/public/content/meet-pieces/linux-installation-guide/flatpak.md @@ -148,7 +148,7 @@ You can remove PiecesOS and the Pieces Desktop App using Flatpak commands. The p - Flatpak stores app data separately from your personal Pieces data. The commands above remove Flatpak-managed state (settings, cache). Your actual Pieces data in `~/Documents/com.pieces.os` and `~/Documents/com.pieces.pfd` is preserved and must be deleted manually if desired. + Flatpak stores app data separately from your personal Pieces data. The commands above remove Flatpak-managed state (settings, cache). Your actual Pieces data in `~/.local/share/com.pieces.os/` is preserved and must be deleted manually if desired. See [On-Device Storage](/products/core-dependencies/on-device-storage) for paths on all platforms. ### Troubleshooting diff --git a/public/content/meet-pieces/linux-installation-guide/snap.md b/public/content/meet-pieces/linux-installation-guide/snap.md index 01603c4..2914c8c 100644 --- a/public/content/meet-pieces/linux-installation-guide/snap.md +++ b/public/content/meet-pieces/linux-installation-guide/snap.md @@ -36,7 +36,7 @@ Snap is the recommended installation method for Ubuntu users. It provides automa Then, type `pieces-for-developers` to launch the application directly from your terminal. -Click here for documentation [on determining your OS version.](/products/meet-pieces/troubleshooting/linux#checking-ubuntu-version) +See our guide on [determining your OS version].(/products/meet-pieces/troubleshooting/linux#checking-ubuntu-version) ### Connect System Interfaces diff --git a/public/content/meet-pieces/macos-installation-guide.md b/public/content/meet-pieces/macos-installation-guide.md index 7313968..d5dbd5b 100644 --- a/public/content/meet-pieces/macos-installation-guide.md +++ b/public/content/meet-pieces/macos-installation-guide.md @@ -49,12 +49,12 @@ You can also manually check for updates by hovering over your username in the to ## Uninstalling -On your macOS device, navigate to **Finder**, then select **Applications**. - -Scroll or search until you find both `Pieces` and `PiecesOS`. Right-click on these two applications and select `Move to Trash`. +To quickly remove the applications, open **Finder** → **Applications** and drag both `Pieces` and `PiecesOS` to the Trash. Uninstalling Pieces from macOS Applications folder +For a complete uninstall that removes all data, preferences, and caches, see the [Complete Uninstall Guide](/products/meet-pieces/macos-installation-guide/uninstall). + ## Additional Resources -Click here for additional [documentation on troubleshooting](/products/meet-pieces/troubleshooting/macos) or reach out to [support](/products/support). +See the [macOS troubleshooting guide](/products/meet-pieces/troubleshooting/macos) or reach out to [support](/products/support) for help. diff --git a/public/content/meet-pieces/macos-installation-guide/dmg.md b/public/content/meet-pieces/macos-installation-guide/dmg.md index 29ab051..4a8a8c5 100644 --- a/public/content/meet-pieces/macos-installation-guide/dmg.md +++ b/public/content/meet-pieces/macos-installation-guide/dmg.md @@ -64,7 +64,7 @@ The DMG installer is the recommended method for installing Pieces on macOS. Choo | *RAM (Cloud Mode)* | 8 GB total system RAM with 1 GB free | 16 GB total system RAM or more | Applies when PiecesOS is running in cloud mode. | | *Disk Space* | 2 GB minimum (1 GB for PiecesOS + 0.5–1 GB for data), with at least 4 GB free | 8 GB with at least 6 GB free or more | Ensure additional free space for data storage and future growth. | -Click here for a quick guide on [determining your OS type](/products/meet-pieces/troubleshooting/macos#checking-os-version), and here for [how to check your device's CPU architecture](/products/meet-pieces/troubleshooting/macos#checking-cpu-type). +See our guide on [determining your OS type](/products/meet-pieces/troubleshooting/macos#checking-os-version), and here for [how to check your device's CPU architecture](/products/meet-pieces/troubleshooting/macos#checking-cpu-type). ## Next Steps diff --git a/public/content/meet-pieces/macos-installation-guide/uninstall.md b/public/content/meet-pieces/macos-installation-guide/uninstall.md new file mode 100644 index 0000000..1147704 --- /dev/null +++ b/public/content/meet-pieces/macos-installation-guide/uninstall.md @@ -0,0 +1,112 @@ +--- +title: Complete Uninstall Guide | macOS +path: /meet-pieces/macos-installation-guide/uninstall +visibility: PUBLIC +status: PUBLISHED +description: Completely remove Pieces and all associated data from your Mac. Step-by-step guide to uninstall applications, data folders, preferences, and caches. +metaTitle: Complete Uninstall Guide | macOS +metaDescription: Learn how to completely uninstall Pieces from macOS, including removing all application data, preferences, caches, and saved content. +--- + +## Complete Uninstall Guide + +This guide walks you through completely removing Pieces from your Mac, including all application data, saved snippets, and Long-Term Memory. + + + This process permanently deletes all your saved snippets, conversations, and Long-Term Memory data. If you want to preserve this data, see [backing up your data](/products/privacy-security-your-data#local-backup) before proceeding. + + +## Complete Uninstall + +To remove Pieces and all associated data: + + + + Click the Pieces icon in your menu bar and select `Quit`. If Pieces isn't responding, open **Activity Monitor** (Applications → Utilities), search for "Pieces", select any Pieces processes, and click the **X** button to force quit. + + + + Open **Finder** → **Applications**, then drag both `Pieces` and `PiecesOS` to the Trash. + + + + Open **Finder**, press `Cmd + Shift + G` to open "Go to Folder", and navigate to: + + ``` + ~/Library/ + ``` + + Delete the following folders if they exist: + - `com.pieces.os` — Contains your snippets, Long-Term Memory, and engine data + - `com.pieces.pfd` — Contains Desktop App settings and logs + + + + In the same `~/Library/` location, open the `Preferences` folder and delete any files starting with `com.pieces`: + + ``` + ~/Library/Preferences/com.pieces.* + ``` + + + + Navigate to the `Caches` folder and delete any Pieces-related folders: + + ``` + ~/Library/Caches/com.pieces.* + ``` + + + + Right-click the Trash icon in your Dock and select `Empty Trash` to permanently delete the files. + + + +### Homebrew Users + +If you installed Pieces via Homebrew, run this command instead of manually removing the applications: + +```bash +brew uninstall --cask pieces +``` + +Then continue with Steps 3-6 above to remove application data. + +### Terminal Commands (Advanced) + +For users comfortable with Terminal, you can run these commands to remove everything at once: + +```bash +# Quit Pieces processes +pkill -f "Pieces" 2>/dev/null +pkill -f "PiecesOS" 2>/dev/null + +# Remove applications +rm -rf /Applications/Pieces.app +rm -rf /Applications/PiecesOS.app + +# Remove application data +rm -rf ~/Library/com.pieces.os +rm -rf ~/Library/com.pieces.pfd + +# Remove preferences +rm -f ~/Library/Preferences/com.pieces.* + +# Remove caches +rm -rf ~/Library/Caches/com.pieces.* +``` + + + These commands permanently delete files without moving them to Trash. Double-check before running. + + +## Verify Removal + +To confirm Pieces has been completely removed: + +1. Open **Spotlight** (Cmd + Space) and search for "Pieces" — no results should appear +2. Open **Finder**, press `Cmd + Shift + G`, and check that `~/Library/com.pieces.os` no longer exists + +## Reinstalling + +If you want to reinstall Pieces later, see the [macOS installation guide](/products/meet-pieces/macos-installation-guide) for fresh install instructions. diff --git a/public/content/meet-pieces/troubleshooting/linux.md b/public/content/meet-pieces/troubleshooting/linux.md index f024e5b..5ae05d3 100644 --- a/public/content/meet-pieces/troubleshooting/linux.md +++ b/public/content/meet-pieces/troubleshooting/linux.md @@ -99,7 +99,7 @@ To determine your GPU type and find other important information, `lspci | grep - Confirm that your CPU, GPU, and memory resources are sufficient for running PiecesOS and local AI models (if applicable). -Click here for documentation on [what we recommend for minimum device specifications](/products/meet-pieces/troubleshooting/cross-platform#hardware-recommendations) if you plan on utilizing a local LLM. +See our [minimum hardware recommendations](/products/meet-pieces/troubleshooting/cross-platform#hardware-recommendations) if you plan on utilizing a local LLM. ### Checking Ubuntu Version diff --git a/public/content/meet-pieces/troubleshooting/macos.md b/public/content/meet-pieces/troubleshooting/macos.md index ce85227..ed312eb 100644 --- a/public/content/meet-pieces/troubleshooting/macos.md +++ b/public/content/meet-pieces/troubleshooting/macos.md @@ -5,7 +5,7 @@ visibility: PUBLIC status: PUBLISHED description: Learn about what troubleshooting steps to take if PiecesOS or the Pieces Desktop App isn’t working as expected on your macOS device. metaTitle: Issues | macOS -metaDescription: Learn about what troubleshooting steps to take if PiecesOS or the Pieces Desktop App isn’t working as expected on your Windows issues. +metaDescription: Learn what troubleshooting steps to take if PiecesOS or the Pieces Desktop App is not working as expected on your Mac. ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/og_images/meet_pieces/meet_pieces_troubleshooting_macOS.png" --- @@ -26,7 +26,7 @@ You can also find information below on how to determine your Apple device's CPU If you’re experiencing difficulties installing PiecesOS or the Pieces Desktop App, you can manually install both software by downloading the standalone files or using terminal commands. - If you’re unsure which `.dmg` or `.pkg` you need based on your device’s CPU, [click here.](/products/meet-pieces/troubleshooting/macos#checking-cpu-type) + Not sure which installer you need? See [how to check your CPU type](/products/meet-pieces/troubleshooting/macos#checking-cpu-type). ### via DMG Files diff --git a/public/content/meet-pieces/troubleshooting/windows.md b/public/content/meet-pieces/troubleshooting/windows.md index e1ad4ff..a9f8230 100644 --- a/public/content/meet-pieces/troubleshooting/windows.md +++ b/public/content/meet-pieces/troubleshooting/windows.md @@ -159,22 +159,22 @@ Before installing, ensure your Windows system is fully updated: ## Accessing Pieces Logs -On Windows machines, Pieces writes its log files under your local AppData folder. You'll find two separate folders depending on which component you're using: +On Windows, PiecesOS and the Desktop App store logs under separate folders in AppData. See [On-Device Storage](/products/core-dependencies/on-device-storage#finding-your-logs) for backup and database paths. -* **Pieces OS (POS) logs**: +* **PiecesOS logs:** ```plaintext C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support ``` -- **Pieces Desktop (PFD) logs**: +* **Desktop App logs:** ```plaintext -C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.pfd\production\Support +C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs ``` - Replace \ with your Windows account name + Replace \ with your Windows account name. ## Checking Hardware Specifications diff --git a/public/content/meet-pieces/windows-installation-guide.md b/public/content/meet-pieces/windows-installation-guide.md index e9e41db..f5f51c3 100644 --- a/public/content/meet-pieces/windows-installation-guide.md +++ b/public/content/meet-pieces/windows-installation-guide.md @@ -55,4 +55,4 @@ Two applications will appear—**Pieces Desktop** and **PiecesOS**. Click the th ## Additional Resources -Click here for additional [documentation on troubleshooting](/products/meet-pieces/troubleshooting/windows) or reach out to [support](/products/support). +See the [Windows troubleshooting guide](/products/meet-pieces/troubleshooting/windows) or reach out to [support](/products/support) for help. diff --git a/public/content/meet-pieces/windows-installation-guide/appinstaller.md b/public/content/meet-pieces/windows-installation-guide/appinstaller.md index ef53108..0b7745c 100644 --- a/public/content/meet-pieces/windows-installation-guide/appinstaller.md +++ b/public/content/meet-pieces/windows-installation-guide/appinstaller.md @@ -50,7 +50,7 @@ The AppInstaller method is the recommended way to install Pieces on Windows. It | *RAM (Cloud Mode)* | 8 GB total system RAM with 1 GB free | 16 GB total system RAM or more | Applies when PiecesOS is running in cloud mode. | | *Disk Space* | 2 GB minimum (1 GB for PiecesOS + 0.5–1 GB for data), with at least 4 GB free | 8 GB with at least 6 GB free or more | Ensure additional free space for data storage and future growth. | -Click here for a quick guide on [determining your OS version](/products/meet-pieces/troubleshooting/windows#checking-windows-version). +See our guide on [determining your OS version](/products/meet-pieces/troubleshooting/windows#checking-windows-version). **Don't install** Pieces or PiecesOS to **OneDrive** or other **cloud-synced** folders (Dropbox, Google Drive, etc.)—sync can interfere with installs and updates. Use the **default path** on a local drive. diff --git a/public/content/privacy-security-your-data.md b/public/content/privacy-security-your-data.md index 0860b40..91e005e 100644 --- a/public/content/privacy-security-your-data.md +++ b/public/content/privacy-security-your-data.md @@ -25,19 +25,31 @@ That means full offline functionality by default, opt-in cloud integrations, cle ## Where Your Data Lives All Pieces data is stored in a single folder on your device—easy to back up, copy, move between machines, or delete entirely. -The `com.pieces.os` folder holds your long-term memory context, saved materials, and logs. You can copy it to OneDrive, a USB drive, or another machine without touching any cloud service. +Pieces stores data in `com.pieces.os` (PiecesOS: LTM, engine data, logs) and, on macOS and Windows, `com.pieces.pfd` (Desktop App settings and logs). You can copy these folders to OneDrive, a USB drive, or another machine without using cloud backup. + **PiecesOS:** ```plaintext /Users//Library/com.pieces.os/ ``` + + **Desktop App:** + ```plaintext + /Users//Library/com.pieces.pfd/ + ``` + **PiecesOS:** ```plaintext C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\ ``` + + **Desktop App:** + ```plaintext + C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\ + ``` diff --git a/public/content/support.md b/public/content/support.md index 1ca4ac9..eea26ea 100644 --- a/public/content/support.md +++ b/public/content/support.md @@ -41,9 +41,10 @@ We read every report, reply to GitHub issues directly, and our founders regularl ## Finding Your Logs -Your PiecesOS logs live in a per-platform application folder. Share the whole `Support` folder when filing a bug to help us diagnose it quickly. -Zip the folder before attaching it to a GitHub issue or sending it to support—logs are plain text, but zipping keeps everything in order. +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](/products/core-dependencies/on-device-storage). @@ -51,7 +52,7 @@ Zip the folder before attaching it to a GitHub issue or sending it to support— Open Finder, press `⌘+shift+g`, and paste the path below: ```plaintext - ~/Library/com.pieces.os/production/support/ + ~/Library/com.pieces.os/production/Support/logs/ ``` @@ -67,10 +68,16 @@ Zip the folder before attaching it to a GitHub issue or sending it to support— ### Windows Press `Win+R` to open the Run dialog, then paste: + **PiecesOS:** ```powershell C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support ``` + **Desktop App:** + ```powershell + C:\Users\\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs + ``` + Replace `` with your system username. If `AppData` is hidden, enable `View → Show → Hidden items` in File Explorer.