chore(mirror): sync docs from pieces-documentation (31008463408)

public/content/core-dependencies/pieces-os/long-term-memory.md

@@ -66,34 +66,44 @@ The agentic foundation powers features like [Meeting Prep](/products/desktop/sin
 
 ### Pausing or Disabling LTM
 
-When LTM is active, the Quick Menu shows a green `On` button. Click it to open a dropdown with timed pause options or a full disable:
+When LTM is active, the Quick Menu shows a green `On` button. Click it to pause or turn capture off. You can pause *LTM-2.7* and *LTM Audio* for any length of time, from a few minutes to several days, instead of only fixed presets.
+
+Pieces shows a clear **Paused until** label so you always know when capture resumes. Use this for a confidential call, a stretch of personal browsing, or a few days off.
 
 | Option | Effect |
 | --- | --- |
-| *Pause for 15 minutes* | Temporarily stops capture; resumes automatically |
-| *Pause for 1 hour* | Temporarily stops capture; resumes automatically |
-| *Pause for 6 hours* | Temporarily stops capture; resumes automatically |
-| *Pause for 24 hours* | Temporarily stops capture; resumes automatically |
+| *Custom pause* | Pause for a duration you choose (minutes, hours, or days); resumes automatically at the *Paused until* time |
 | *Turn Off* | Fully disables LTM until you re-enable it manually |
 
 <Callout type="tip">
-  Use timed pauses when you want a temporary break—for example, during a private call or a personal browsing session—without losing your LTM context history.
+  Use a timed pause for a temporary break, such as a private call or personal browsing, instead of turning LTM off entirely.
 </Callout>
 
-You can also toggle LTM from within the Pieces Desktop App:
+You can pause from:
+
+* The **PiecesOS Quick Menu**
+* The **user popover** in Pieces Desktop (`User Profile` → hover `LTM-2.7`)
+* **Settings** → `Long-Term Memory` in Pieces Desktop
 
 <Steps>
   <Step title="Open your profile">
-    Click your `User Profile` in the top left.
+    Click your `User Profile` in the top left of the Pieces Desktop App.
   </Step>
 
-  <Step title="Navigate to LTM settings">
-    Hover over `Settings` and select `Long-Term Memory`.
+  <Step title="Pause or open LTM settings">
+    Hover over `LTM-2.7` to choose a pause duration, or hover over `Settings` and select `Long-Term Memory` for full controls.
   </Step>
 </Steps>
 
 For a full breakdown of every toggle and option in that settings panel, see [LTM Settings](/products/desktop/configuration/long-term-memory).
 
+### When Capture Stops Automatically
+
+Capture slows down when you step away:
+
+* When your **screen is locked**, Pieces stops capturing entirely.
+* When you go **idle**, Pieces captures less often instead of sampling at full rate, so an unattended laptop isn't recording a screen nobody is looking at.
+
 ***
 
 ## LTM Audio

public/content/core-dependencies/pieces-os/quick-menu.md

@@ -22,7 +22,7 @@ The **Quick Menu** is a lightweight popover for interacting with PiecesOS, locat
 | --------------------------------- | -------------------------------------------------------------------------- |
 | *Account* | Log in or log out of your Pieces account |
 | *Version* | Check for and install PiecesOS updates |
-| *Long-Term Memory Engine* | Enable, pause, or disable LTM |
+| *Long-Term Memory Engine* | Enable, pause (custom duration with **Paused until**), or disable LTM |
 | *Long-Term Memory Access Control* | Choose which apps LTM captures data from |
 | *MCP Servers* | View the SSE endpoint URL and MCP documentation links |
 | *Settings* | Launch on login, enabled apps, ML processing, telemetry, memory optimization |
@@ -42,11 +42,11 @@ Below your account, the Quick Menu displays your current PiecesOS version. If an
 
 ## Long-Term Memory
 
-Toggle the [LTM-2.7 Engine](/products/core-dependencies/pieces-os/long-term-memory) on or off, manage [Audio ingestion](/products/core-dependencies/pieces-os/long-term-memory#ltm-audio), and control which apps LTM captures data from via [Access Control](/products/core-dependencies/pieces-os/long-term-memory#long-term-memory-access-control).
+Toggle the [LTM-2.7 Engine](/products/core-dependencies/pieces-os/long-term-memory) on or off, pause capture for a custom duration (with a **Paused until** label), manage [Audio ingestion](/products/core-dependencies/pieces-os/long-term-memory#ltm-audio), and control which apps LTM captures data from via [Access Control](/products/core-dependencies/pieces-os/long-term-memory#long-term-memory-access-control).
 
 <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/core-dependencies/quick-menu_turn_off_ltm.png" alt="Toggling LTM engine on or off in the Quick Menu" align="center" fullwidth="true" />
 
-For the full breakdown—pausing, disabling, Audio setup, per-app toggles—see the [LTM-2.7 Engine](/products/core-dependencies/pieces-os/long-term-memory) page.
+For all pause options, the **Paused until** label, Audio setup, and per-app toggles, see the [LTM-2.7 Engine](/products/core-dependencies/pieces-os/long-term-memory) page.
 
 ## MCP Servers
 

public/content/desktop.md

@@ -80,7 +80,7 @@ Use [Conversational Search](/products/desktop/conversational-search) as your mai
 
 ## Configuration
 
-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.
+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 model families and modes.
 
 <FancyCard title="Learn More" href="/products/desktop/configuration" colored={false}>
   Explore all configuration options to customize your Pieces Desktop experience.

public/content/desktop/configuration/long-term-memory.md

@@ -44,6 +44,29 @@ Toggle the Long-Term Memory Engine on or off to control whether Pieces captures
   The Long-Term Memory Engine helps Pieces understand your workflow patterns and provide more contextual suggestions in Conversational Search. When disabled, Pieces won't capture or use workflow context.
 </Callout>
 
+### Pausing Capture
+
+Pause *LTM-2.7* and *LTM Audio* for a custom duration: minutes, hours, or days. Pieces shows a **Paused until** label so you know exactly when capture resumes.
+
+You can pause from:
+
+* This *Long-Term Memory* settings page
+* Your `User Profile` popover (hover `LTM-2.7`)
+* The [PiecesOS Quick Menu](/products/core-dependencies/pieces-os/quick-menu)
+
+<Steps>
+  <Step title="Open pause controls">
+    Click your `User Profile`, hover over `LTM-2.7`, and choose a pause duration. Alternatively, open `Settings` → `Long-Term Memory` and pause from *Memory Formation*.
+  </Step>
+  <Step title="Confirm Paused until">
+    Check the **Paused until** indicator so you know when capture will pick back up automatically.
+  </Step>
+</Steps>
+
+<Callout type="tip">
+  Capture also stops while your screen is locked, and slows when you go idle. For the full pause behavior, see [LTM-2.7 Engine](/products/core-dependencies/pieces-os/long-term-memory#pausing-or-disabling-ltm).
+</Callout>
+
 ### App Access Control
 
 Manage which applications the Long-Term Memory Engine interacts with. This allows you to control what data sources Pieces uses when capturing workflow context.

public/content/desktop/configuration/mcp.md

@@ -95,14 +95,16 @@ For more use cases and detailed setup instructions, refer to the [MCP documentat
 
 ## MCP Connections
 
-Connect Pieces to supported MCP clients with one click. Pieces writes to each client's global or user-level MCP config and, when supported, also creates the matching global rule or skill file automatically.
+Connect Pieces to supported apps with one click. Pieces saves each app's connection settings for you and, when supported, also creates the matching rule or skill file automatically.
+
+Most apps connect with a simple local link. **Claude Desktop** is different: Pieces includes the connector it needs, so you can connect without installing anything extra.
 
 <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/desktop_app_MAIN/new_media/Settings/MCP/mcp_connections_section.png" alt="MCP Connections section showing supported clients with Connect buttons" align="center" fullwidth="true" />
 
 > MCP Connections section showing supported clients with one-click Connect buttons
 
 <Callout type="info">
-  Some MCP clients may need to be restarted or reopened before configuration changes appear.
+  Some apps may need to be restarted or reopened before the new settings appear. For Claude Desktop, Pieces shows a *Restart Claude Desktop* prompt with a `Restart Claude Desktop now` button when a restart is required.
 </Callout>
 
 The MCP Connections section shows your connection status (e.g., "Connected 4 of 6") and a `Refresh Connections` button to update the status.
@@ -111,7 +113,7 @@ The MCP Connections section shows your connection status (e.g., "Connected 4 of
 
 | Client | Description |
 | --- | --- |
-| **Claude Desktop** | Connect Pieces to Claude Desktop for memory-backed conversations |
+| **Claude Desktop** | Connect Pieces to Claude Desktop for access to all of your Personal Memories without any additional installation |
 | **Cursor** | Connect Pieces to Cursor so your IDE has access to long-term memory |
 | **GitHub Copilot** | Connect Pieces to GitHub Copilot for context-aware code suggestions |
 | **Codex** | Connect Pieces to Codex so both the CLI and IDE extension can connect to your memory via MCP |
@@ -129,14 +131,21 @@ The MCP Connections section shows your connection status (e.g., "Connected 4 of
   <Step title="Scroll to MCP Connections">
     Find the *MCP Connections* section below the Available Servers and View Documentation sections.
   </Step>
+  <Step title="Quit Claude Desktop if needed">
+    When connecting **Claude Desktop** on Linux, quit Claude Desktop first if it is already running so Pieces can write the config safely.
+  </Step>
   <Step title="Click Connect">
     Click the `Connect` button next to the client you want to configure. Pieces automatically writes the MCP configuration to that client's config file.
   </Step>
   <Step title="Restart the Client">
-    Restart or reopen the MCP client for the configuration changes to take effect.
+    Restart or reopen the MCP client for the configuration changes to take effect. For Claude Desktop, use `Restart Claude Desktop now` when the prompt appears.
   </Step>
 </Steps>
 
+<Callout type="tip">
+  For the full Claude Desktop flow, including Snap and Flatpak notes, see [Pieces MCP + Claude Desktop](/products/mcp/claude-desktop).
+</Callout>
+
 ### Managing Connected Clients
 
 Once connected, a green checkmark appears next to the client name. To disconnect or reconfigure:

public/content/desktop/connectors/google-calendar.md

@@ -68,7 +68,7 @@ Beyond direct calendar management, Pieces uses your calendar to enrich answers.
 
 Once connected, your calendar events flow into [Single-Click Summaries](/products/desktop/single-click-summaries) that use workflow context, including *Morning Brief*, *Standup Update*, and *Day Recap*. These summaries reflect what was actually on your schedule rather than what happened to be visible on your screen.
 
-The *Google Calendar* connector is also the foundation for [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep), a summary type that looks ahead at your upcoming meetings, cross-references each event with your Long-Term Memory, and generates a structured pre-read.
+The *Google Calendar* connector is also the foundation for [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep), a summary type that looks ahead at your upcoming meetings, cross-references each event with your Long-Term Memory, and generates a structured pre-read. In summary results, hover attendee names for [persona cards](/products/desktop/single-click-summaries#people-tags--anchors).
 
 Example prompts:
 

public/content/desktop/conversational-search/setting-context.md

@@ -26,7 +26,7 @@ Control whether Conversational Search includes Long-Term Memory context in your
     Hover over `LTM-2.7` in the dropdown menu that appears.
   </Step>
   <Step title="Toggle LTM">
-    To keep LTM active, ensure it is not paused or turned off. To disable, select a pause duration (15 minutes, 1 hour, 6 hours, 12 hours, or 24 hours) or choose `Turn Off`. When paused or off, Conversational Search will not include workflow history context.
+    To keep LTM active, ensure it is not paused or turned off. To pause temporarily, choose a custom duration (minutes, hours, or days), and Pieces shows a **Paused until** time. Alternatively, choose `Turn Off`. When paused or off, Conversational Search will not include workflow history context. Full details: [Pausing LTM](/products/core-dependencies/pieces-os/long-term-memory#pausing-or-disabling-ltm).
   </Step>
 </Steps>
 

public/content/desktop/single-click-summaries.md

@@ -26,12 +26,12 @@ Each summary type adapts dynamically to your workflow, meaning the same summary
 Click any summary card on the homepage and after a few minutes, you'll see your summary in the [Pieces Timeline](/products/desktop/timeline).
 
 <Callout type="tip">
-  You can queue multiple unique summaries at once, but wait for the current one to finish before starting another of the same type.
+  You can run several Single-Click Summaries at once. Start a *Day Recap*, *Standup Update*, and *Meeting Prep* together and let them generate side by side. You no longer need to wait for one to finish before starting the next.
 </Callout>
 
 ### Viewing Queued Summaries
 
-When you generate a summary, it appears under the current day in Pieces Timeline with a "Queued" status. Expand the day section to track progress.
+When you generate a summary, it appears under the current day in Pieces Timeline with a "Queued" or generating status. Expand the day section to track progress. The Timeline stays responsive while summaries generate, so you can keep scrolling and reading even with several in flight.
 
 <Steps>
   <Step title="Open Timeline">
@@ -55,12 +55,26 @@ Locate the summary you want to cancel under the current day in Pieces Timeline a
 
 ### Viewing Completed Summaries
 
-When a summary finishes generating, it remains in the day section where it was queued. Click it to view detailed insights, related activities, and links to relevant documents or commits from your workflow.
+When a summary finishes generating, it remains in the day section where it was queued. Click it to view detailed insights, related activities, and artifacts from your workflow.
+
+Summaries are based on **memories from a given time frame**—not a guess from whatever was on screen. Those memories can include vision, audio, clipboard activity, browser URLs you visited, files you opened, and people you collaborated with. A completed summary usually includes a high-level overview of that context plus people, URLs, files, next steps, and tasks. Files and sites cited in a summary are **clickable**, so you can open them directly.
 
 <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/single-click-summaries/completed_summary_view_with_results.png" alt="Completed summary with insights, related activities, and document links" align="center" fullwidth="true" />
 
 > Completed summary view showing full results with insights, related activities, and links to relevant documents
 
+### People, Tags & Files
+
+Pieces detects people mentioned in your workstream and people you have collaborated with, then turns each name in a summary into a rich, hoverable reference. Hover any name to open a **persona card** showing who they are, how to reach them, their role, and how you two have worked together over time.
+
+*Tags* and *files/folders* in summaries work the same way: live references instead of plain text.
+
+This is especially useful when:
+
+* A summary mentions someone you've met once and can't quite place
+* You're walking into a meeting and want context on an attendee without leaving the page
+* You need to recall what you and a teammate last decided together
+
 ***
 
 ## Explore Single-Click Summaries

public/content/desktop/single-click-summaries/default-types.md

@@ -54,7 +54,7 @@ Helps you understand what's been occupying your attention and what matters most
 ## Standup Update
 *Three-part update: what you did, what's next, and blockers.*
 
-Generates a ready-to-share standup format perfect for team meetings. Copy it directly into Slack, Teams, or your standup bot.
+Generates a ready-to-share standup format perfect for team meetings. Copy it directly into Slack, Teams, or your standup bot. You can run Standup Update at the same time as other summaries, such as *Day Recap* or *Meeting Prep*.
 
 **When to use:**
 - **Daily standups** — Walk in prepared with your update written
@@ -71,6 +71,8 @@ Generates a ready-to-share standup format perfect for team meetings. Copy it dir
 
 Analyzes your captured workflow context—recent documents, conversations, and activities related to each meeting's attendees and topics—and creates calendar events that give you time to review before you join.
 
+Hover attendee names for [persona cards](/products/desktop/single-click-summaries#people-tags--anchors): who they are, how to reach them, and how you've worked together.
+
 **When to use:**
 - **Block prep time** — Get calendar events for meeting preparation
 - **Review context** — See relevant docs and notes before important meetings
@@ -84,7 +86,7 @@ Analyzes your captured workflow context—recent documents, conversations, and a
 ## Day Recap
 *Concise summary of your accomplishments, blockers, and feedback from today's activity.*
 
-Compiles an end-of-day summary ready to share or save—so you have a clear record of what you got done.
+Compiles an end-of-day summary ready to share or save, so you have a clear record of what you got done. Day Recap cites the files you had open and sites you visited, with clickable file references when available.
 
 **When to use:**
 - **Log off for the day** — Wrap up with a clear record of what you accomplished
@@ -173,7 +175,7 @@ Surfaces your professional habits, strengths, and work patterns—giving you lan
 ## Collaboration Patterns
 *Identifies who you work with and how, revealing collaboration dynamics.*
 
-Discovers your collaboration habits and team interaction patterns—showing your working relationships at a glance.
+Discovers your collaboration habits and team interaction patterns, showing your working relationships at a glance. People named in the summary support the same [persona hover cards](/products/desktop/single-click-summaries#people-tags--anchors) as other summary types.
 
 **When to use:**
 - **Identify key collaborators** — See who you've been working with on a project

public/content/desktop/timeline/ltm-rollups.md

@@ -20,7 +20,7 @@ Each roll-up contains structured information about your workflow period:
 
 * **Core Tasks & Projects** — What you worked on and problems solved
 * **Key Decisions & Discussions** — Important conversations and choices made
-* **Documents & Code Reviewed** — Files and links you accessed (with deep links)
+* **Documents & Code Reviewed** — Files and links you accessed (with deep links), based on files you had open and sites you visited during the window
 * **Follow-Up Actions** — What still needs attention
 
 Roll-ups created through Model Context Protocol (MCP) integrations display a "Formed with MCP" indicator.

public/content/desktop/troubleshooting/linux.md

@@ -123,6 +123,12 @@ This section will display your Ubuntu version information.
 
 If you encounter persistent installation issues, consult online forums or community guides related to snap and Ubuntu-specific troubleshooting steps.
 
+## Claude Desktop MCP on Linux
+
+Pieces supports Snap and Flatpak installs. For the Claude Desktop MCP connection from Desktop `Settings` → `MCP`, Claude only needs to point at the PiecesOS executable—no additional install is required.
+
+Quit Claude Desktop before `Connect` if it is running, then use `Restart Claude Desktop now` when prompted. Full steps: [Claude Desktop](/products/mcp/claude-desktop).
+
 ## Restart & Retry
 
 If you've updated components, checked the hardware, and adjusted configurations without success, try restarting your machine and then try again.