Help

Setup

The archive goes in ~/Samskara unless you choose another folder first.

  1. Read This MacMessages, Mail, Notes, Contacts, Calendar, Photos, call history, Maps, Screen Time, Voice Memos, browser history and the Claude Code, Cursor and Codex histories are read where they are. Each app found on this Mac is its own choice, on until you turn it off, here and in Settings, under This Mac. An app you turn off after a read asks Keep in Archive or Remove from Archive, which builds the archive again without it and takes its photos out of photo search. New messages come in while Samskara is open. Nightly Refresh, on unless you turn it off in Settings, under General, brings in what is new overnight while your Mac is on power, with Samskara closed too, and a night missed while your Mac was off runs at your next login. Stop Reading is in Settings, under This Mac.
  2. Add ExportsChoose the folder or drive that holds your exports. Samskara reads each one where it is and changes nothing in the folder. Exports are optional.
  3. Search by MeaningMessages, mail and documents are searched by meaning with nothing to download. Photos, videos, PDF pages and voice memos need a download, which this step offers. Keep Awake keeps this Mac from sleeping while it is plugged in, so the work goes on overnight.
  4. Connect an AgentPress Add beside Claude, Cursor or Codex. For any other agent that uses MCP, copy the setup and paste it into that agent.
  5. Ask Your First QuestionOnce an agent is connected, setup gives you a question to copy into it. The step is done once that agent has been sent something, or once you close the question.
  6. Lock SamskaraLocking Samskara says when it asks for your Mac password or Touch ID.

An export you request takes from minutes to 30 days to arrive.

Adding Data

Apps already on your Mac, such as Messages, Notes, Photos and Contacts, need no export. Samskara reads them where they are once Full Disk Access is on, and Contacts and Photos each ask for their own permission.

Keep each export as it downloaded, without renaming it or moving files inside it, and choose the folder or drive that holds them. Samskara reads each export where it is and changes nothing in that folder. For exports in Downloads, Keep a Copy copies them into your archive folder, and the originals stay in Downloads. Places to Look, in Settings under This Mac, names folders Samskara looks through again at every read, so a newer export saved there is found.

An export stops on the day you asked for it, so newer data needs a new export. Nightly Refresh brings in what is new on your Mac each night.

Requesting Exports

Google Takeout
Mail, Calendar, My Activity, YouTube, Google Photos, Drive, Voice and Meet. Leave every product ticked. The email can take minutes to a few days, and the link works for about 7 days. Timeline, once called Location History, is exported from Google Maps on your phone: Settings, Location & privacy, Export Timeline data.
Gmail
Gmail can sync instead of a Takeout. Turn on 2-Step Verification, then create an app password named samskara.
Apple
Request a copy of your data, then iCloud Calendars and Reminders, iCloud Notes, iCloud Contacts, Wallet activity or iCloud Drive.
Apple Health
In the iPhone Health app, your profile, Export All Health Data.
ChatGPT
Settings, Data controls, Export, then Confirm export. The email can take up to 7 days, and the link works for 24 hours.
Claude
Settings, Privacy, Export data. The email comes after a small delay, and the link works for 24 hours.
Instagram
In the app, Settings, Accounts Center, Your information and permissions, Export your information, Create export, all time. The email can take up to 30 days, and the link works for 4 days.
Facebook
Accounts Center, Your information and permissions, Export your information, Create export, JSON, all time. Facebook tells you when the file is ready, and you then have 4 days to download it.
Snapchat
My Data, Submit request. Turn on Export your Memories so the photos and videos are in the file. The email comes within 7 days, longer for a big export. Download links inside the file expire about 7 days after the request.
WhatsApp
Open a chat, tap its name, Export Chat, then Attach Media. On Android it is More Options, More, Export Chat, then Include Media. One chat at a time, with its photos, videos and voice messages in the zip.
Telegram
In Telegram Desktop, Settings, Advanced, Export Telegram data, as JSON.
X
Settings and privacy, Your account, Download an archive of your data. X can take a few days to make the archive and tells you when it is ready.
TikTok
Settings and privacy, Account, Download your data. Choose JSON.
LinkedIn
Settings, Data privacy, Get a copy of your data. Choose the larger archive.
Spotify
The account privacy page, Extended streaming history, Request data.
Strava
Settings, My Account, Download or Delete Your Account, Get Started, Request Your Archive. The zip arrives by email.
WHOOP
In the app, More, App Settings, Data Export, then Create Export. WHOOP emails you when the export is ready.
Strong
In the app, Settings, Export Strong Data.
eufy Life
In the app, Me, Data, Export All Data. The file is emailed to an address you name.

Marking Accounts

A source can hold several accounts, such as two Google addresses in one Takeout. When you add an export, the home shows Review Accounts. An unmarked account waits, and an account marked Someone Else’s reaches no agent.

To keep a source of your own from an agent, leave its items out on the panel, or press Reject.

People

A person’s page has Pin, Hide and Add an Account. Pin keeps them at the top of the home. Hide takes them off the home, Recently Opened and each app’s own lists of people, while search and People by Name still find them, and Unhide brings them back. Hide changes only what Samskara shows you: an agent reads a hidden person as before.

Add an Account lists the apps where they could have an account, then the accounts in one app most likely to be theirs, with what points to each and a search for the rest. The one you choose joins them, and Undo takes it back.

Connecting an Agent

Open Settings and press the button beside Claude, Cursor or Codex. Claude adds Samskara to the Claude app and to Claude Code. Quit and reopen Claude or Cursor to see the archive. Claude Code and Codex see it from their next session. Undo, or Remove once the agent has connected, takes the entry out.

For any other agent that uses MCP, the protocol agents use to call tools, copy the setup and paste it into that agent or into its MCP settings.

An agent that shows MCP prompts lists eight of Samskara’s, such as Catch Up on Someone and This Week Last Year. A person, a thread or a day in its own pane has Ask with your agent’s name, such as Ask Claude…, which copies a question about it and opens it. An agent Samskara cannot open shows Copy Question instead.

Answering the Panel

When an agent asks the archive for something, the panel comes forward under the menu bar. Its title names the agent and what it wants to read. Claude, Claude Code, Cursor, Codex, ChatGPT, Gemini CLI, Zed, Warp and Qwen Code appear with their own marks, and any other name appears in quotation marks, because the agent chose it. Below are the items it found, each drawn the way its own app showed it.

Leave Out
Uncheck an item, or one message inside a thread.
Redact
Drag across a run of text or a box on a picture, or use the keyboard. That part is marked redacted.
Review
Pages through every kept item as it will leave. Once Review has run, Approve waits until each kept item has been drawn.
Show
Opens an item beside the panel.
Approve
Sends what is still on the panel.
Reject
Sends nothing.
Allow Again in This Chat
Lets that agent read the same items again in the same chat without asking. Anything new is asked. It is not offered once you leave something out or redact a part.

A photo goes to the agent as the picture, with its time, its place and the caption you wrote in Photos, each of which you can leave out. The descriptions written on this Mac to help search find a photo stay here.

Allow Again in This Chat holds in Claude Code and Codex, which start a new connection for each chat. Cursor and the Claude desktop app serve every chat from one connection, so there the panel comes forward on every call.

Locking Samskara

Once there is an archive, Samskara asks for your Mac password or Touch ID when its window opens, and an Apple Watch that unlocks your Mac can answer too. It asks again after your Mac locks, sleeps or switches to another user, and after your Mac sits untouched for the time you choose, 15 minutes unless you change it. On a Mac account with no password, Samskara opens without asking. While it is locked, the window shows only Open Samskara.

Agents can still ask the archive for something while Samskara is locked. Before the panel shows the items, Samskara asks for your Mac password or Touch ID. If nobody answers, the request runs out and is refused, the same as Reject.

To change the idle time or turn the lock off, open Samskara, choose Settings, then General, and use Lock Samskara and Lock When Idle.

The lock keeps someone at your Mac from opening your archive in Samskara. The archive is still a file on your Mac, so turn on FileVault in System Settings, Privacy & Security, to keep it encrypted when your Mac is off.

Permissions

Full Disk Access lets Samskara read Messages, Notes, Mail, Calendar, call history, Maps, Screen Time, Voice Memos, Safari history and the other Apple apps: Journal, FaceTime’s messages, your notification history with each notification’s title and text, Find My, Clock, Stocks, Weather, News, Books, Podcasts and TV. Turn on Samskara in System Settings, Privacy & Security, Full Disk Access.

History from Chrome, Brave, Edge, Arc and Firefox needs no permission.

Contacts turns phone numbers into names. Photos lets Samskara keep a small copy of each photo, and copy in full the ones you open and the ones an agent is allowed to receive. When your Mac keeps only a preview, Photos downloads the photo from iCloud. Nothing in your library changes.

Copying Your Archive

Your archive is the Samskara folder in your home folder unless you chose another place. To keep a copy, quit Samskara and copy the folder to another drive. The database inside is SQLite, so it opens without Samskara.

To take one app of this Mac out of the archive, turn it off in Settings, under This Mac, and choose Remove from Archive. To remove everything, follow the list on Privacy.

Questions

Where does my data go?

Into a folder on your Mac, ~/Samskara unless you choose another. An agent gets an item only after you approve it or allow it again in the same chat, and then the company that makes that agent has it. Privacy has every path off the Mac.

What does it cost?

Samskara is free and has no account. The agent you connect has its own price.

Is it open source?

No, the source is private. The archive is a SQLite database in a folder you choose, so you can open it without Samskara.

Is my Mac good enough?

It needs a Mac with Apple silicon and macOS 14 or later. Years of messages, photos and exports can reach tens of gigabytes.

Is the app signed?

Yes. Every disk image Releases lists is signed with a Developer ID, notarized by Apple, and ships outside the App Store. Each release there gives its notarization date. Notarization is Apple’s automated check for known malware. Apple does not review what the app does.

Do I need internet?

Search works offline. You need a connection to download the app, to use a cloud agent, to sync Gmail, to fetch a photo iCloud keeps only online, to download Snapchat memories an export holds as links, for the search download if you choose it, and for YouTube thumbnails if you turn them on.

How do I remove it?

Quit Samskara and delete the places Privacy lists, starting with the archive folder.

Updated November 17, 2026.