What is the LTM-2.7 Engine?

The Long-Term Memory (LTM-2.7) Engine is PiecesOS's core memory system. It runs entirely on your device and continuously captures workflow context—code you copy, screens you view, audio you hear—so Pieces can power Timeline, Conversational Search, and MCP integrations with real context from your day.

All captured data is processed and stored locally. Nothing leaves your machine unless you explicitly choose to share it. See Privacy & On-Device Storage.

The primary control point for LTM is the PiecesOS Quick Menu—the Pieces icon in your menu bar (macOS, Linux) or system tray (Windows).

Enabling, Pausing & Disabling LTM

Enabling LTM

Click the `Pieces` icon in your taskbar (Windows) or menu bar (macOS, Linux). Click `Enable Long-Term Memory Engine`. Toggling the LTM engine on or off in the PiecesOS Quick Menu

LTM toggle in the PiecesOS Quick Menu

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:

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
Turn Off Fully disables LTM until you re-enable it manually
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.

You can also toggle LTM from within the Pieces Desktop App:

Click your `User Profile` in the top left. Hover over `Settings` and select `Long-Term Memory`.

For a full breakdown of every toggle and option in that settings panel, see LTM Settings.

LTM Audio

LTM Audio extends capture to system audio and microphone input—meeting recordings, video calls, podcasts, or your own voice during a call.

Click the `Pieces` icon in your taskbar or menu bar. Scroll to *LTM Audio* and toggle it on. On macOS, LTM Audio requires **System Audio Capture** and **Microphone Access** permissions before it can be enabled. First-time users may see a yellow warning indicator on their User Profile inside the Desktop App—click it to grant the required permissions. See [LTM Audio setup](/products/desktop/configuration/long-term-memory#ltm-audio) for full per-platform instructions.

Long-Term Memory Access Control

Access Control lets you decide exactly which applications LTM captures data from.

Click the `Pieces` icon in your taskbar or menu bar. Navigate to *Long-Term Memory Access Control*.

You'll see two views:

Enabled Sources

A live list of all apps currently feeding data into LTM (for example, Google Chrome, VS Code, Slack).

LTM enabled sources showing application icons in the PiecesOS Quick Menu

Enabled sources view showing apps currently monitored by LTM

Click any listed source to open a window where you can disable it for that app individually. Disabled sources stop contributing new events to LTM but previously captured context is retained.

Disable sources like password managers, banking apps, or private browser profiles to keep sensitive activity out of LTM entirely.

Next Steps

Configure app access control, system permissions, LTM Audio, performance options, and clear stored data from the full settings panel. Understand exactly what LTM stores on your device and how to manage or delete it. Everything else you can do from the Quick Menu—updates, MCP settings, ML processing, and more.