Privacy
What It Reads
Samskara reads the apps on your Mac where they keep their data. Messages, Notes, Mail, Calendar, call history, Maps, Screen Time, Voice Memos and Safari history need Full Disk Access, and so do the other Apple apps it reads: Journal, FaceTime’s messages, your notification history with each notification’s title and text, Find My, Clock, Stocks, Weather, News, Books, Podcasts and TV. Contacts and Photos each ask for their own macOS permission. History from Chrome, Brave, Edge, Arc and Firefox needs no permission. It also reads Safari’s bookmarks, the files in iCloud Drive, and WhatsApp when the WhatsApp app is on this Mac.
Each app Samskara finds on this Mac is its own choice in Read This Mac and in Settings, This Mac, and every one is on until you turn it off. An app that is off is not read.
It reads the session histories Claude Code, Cursor and Codex keep on your Mac, which can hold code, file contents and keys pasted into a chat, and the commits you wrote in the git repositories in your code folders. When the GitHub command line tool is signed in on your Mac, it also reads your GitHub account.
It reads the exports in the folder or drive you choose, such as a Google Takeout, an Instagram download or Apple’s Health export, where they are, and changes nothing in that folder. For exports in Downloads, Keep a Copy copies them into the archive folder. Places to Look, in Settings, This Mac, names the folders Samskara looks through for exports at every read, and it looks in no folder you did not add.
Samskara only reads. Nothing in Messages, Notes, Photos or your other apps changes, and a connected Gmail mailbox is opened read only.
Where It Keeps It
Everything Samskara builds goes in the archive folder, ~/Samskara unless you chose another during setup. It holds one SQLite database with its search indexes, what was read from each app before the database was built from it, a small copy of each photo and video, a full copy of each photo you opened or an agent was allowed to receive, the files search by meaning needs, the logs, the copies of exports you chose to keep, and a log of what each agent was given. That log names each item by where it is in the archive and holds none of its text. Settings for this Mac are in ~/Library/Application Support/Samskara. While a chat with an agent is open, the panel keeps the words that agent searched for and the text of the items it showed you there too, and removes them when the chat ends.
The archive is not encrypted. Any program that runs as you on this Mac can open the database file, and so can anyone who signs in as you. FileVault, if it is on, encrypts the whole disk while the Mac is off. A backup you make of the folder carries the archive as it is.
Done on Your Mac
Samskara prepares the archive for search on your Mac, including what it holds about other people. Search by meaning runs on this Mac, and what it needs for messages, mail and documents comes in the download. Search by meaning on photos, videos, PDF pages and voice memos needs a download that setup offers. Nothing else downloads for search. When search by meaning cannot run, search finds things by their words.
Drafted replies can use Ollama when it is already on this Mac, and only with a model running on this Mac.
What Leaves Your Mac
This is the whole list. Samskara sends no analytics or crash reports, and its own web server listens only on this Mac.
- An Agent You Connect
- When Claude, Claude Code, Cursor, Codex or another agent that uses MCP, the protocol agents use to call tools, asks, the panel shows the items. Only what you approve, or allow again in the same chat, goes to that agent. A photo goes as the picture the panel drew, with your redactions painted in and no place or camera data in the file. With it go its time, its place and album, the caption you wrote in Photos, its size and the app it came from, and you can leave any of them out. Its coordinates and camera are left out unless you turn them on for that photo. The descriptions written on this Mac to help search find a photo are never sent. A PDF goes as its drawn pages, a file as the bytes you saw, and a sound clip whole. The agent usually sends what it gets to the servers of the company that makes it, under that company’s terms.
- iCloud Photos
- When your Mac keeps only a preview of a photo or video, Photos downloads it from iCloud when Samskara makes its small copy, or when you or an approved tool opens the original. Apple sees the request. Nothing is uploaded.
- Map Tiles From Apple
- When Places shows where you were, Apple’s MapKit downloads map tiles for the area on screen, and Apple sees which area. Your places, routes and photos are drawn on this Mac and are not sent.
- Gmail
- If you connect it, Samskara signs in to Google’s mail server with the app password you give it and fetches mail read only. The password is kept in your Keychain as Samskara Gmail.
- GitHub
- When the GitHub command line tool,
gh, is signed in on your Mac, each refresh asks GitHub for your account as you: your profile, repositories, stars, gists, followers, the accounts you follow, organizations, notifications, issues and events, and for each repository you own its pull requests, comments, releases and workflow runs. GitHub sees the requests. Nothing from your archive goes with them. - Snapchat Memories
- When a Snapchat export lists a memory as a link instead of the file, each refresh fetches it from Snapchat, which sees the request. Samskara fetches only from Snapchat’s own addresses.
- YouTube Thumbnails
- The switch in Settings is off by default. When it is on, Samskara fetches a video’s thumbnail from YouTube’s image server by the video’s id, with no cookies.
- The Search Download
- If you choose search by meaning for photos, videos, PDF pages and voice memos, its 555 MB of files download from Hugging Face, which sees the request. Nothing from your archive goes with it.
- A Check for Updates
- Once a day, and when you choose Check for Updates, Samskara fetches the list of versions from samskara.me, which sees the request and the version you have. A check that finds a newer version changes the menu item to Update to and the version number, and nothing else happens. The new version installs only after you open that item and choose Install Update. Its download goes through samskara.me, which writes the same one line a download button does, then comes from GitHub, which sees the request. A copy with no update list opens the Releases page in your browser instead. Nothing from your archive goes with any of these.
- Ollama
- A model pulled through Ollama comes from ollama.com. Samskara refuses to draft with an Ollama cloud model or an Ollama address on another machine.
- Links in Your Browser
- Help and Releases in the app open samskara.me. The Add Data steps open each service’s export page, such as Google Takeout, Apple’s privacy site or Snapchat’s account page. A web link you click inside the archive, such as a profile in an Instagram export, opens in the browser too. Your browser makes these requests only when you click.
Samskara can also answer an agent on another device. That is off by default and listens only on this Mac, so nothing outside reaches it unless you set up the connection yourself.
Limits of the Panel
The panel holds for an agent that reaches the archive through the MCP tools. While Samskara is locked no agent reads anything, on this Mac or from another device: a request waits until you open Samskara, and is refused if you do not. The panel does not hold for these.
- An agent on another device that you set up yourself is not asked on the panel. It reads what you allowed that device, until the day that allowance ends.
- A program with a shell that runs as you, such as Claude Code, Cursor or Codex, can open the archive file directly and never ask the panel.
- The panel shows the name the agent gives itself, and a rule you set is kept under that name. Samskara does not check the program behind it.
- Hide changes what Samskara shows you. An agent still reads a hidden person, and the panel shows their items like anyone else’s.
- A search that finds nothing returns at once with no panel, so an agent can learn that a word is not in your archive without asking you.
- What you approve goes to the company that makes the agent and stays under its terms. Removing Samskara does not reach it.
What This Website Records
- Every download button and every update goes through
/api/dl, which writes one line: theuser agentyour browser sends, and thetime. It then asks GitHub where the build is, sending nothing about you, and sends your browser there. It sets no cookie and keeps no id that follows you between visits.
The site is run by Samskara and hosted by Vercel. That line goes to Vercel’s function log, which deletes it after one hour.
Vercel also keeps its own request log for every page, with your IP address, under its own terms. The host that holds the build file sees the download request and your IP address.
Remove Everything
Open Settings, then Archive, and choose Delete Archive. Samskara stops its server, turns off Nightly Refresh, and moves the archive folder to the Trash: ~/Samskara or the folder you chose, with the database, photo copies, search files, logs and the log of what agents were given. It stays in the Trash until you empty it. When your archive is on a drive and its Library is kept on this Mac, the database and photo copies stay in This Mac’s Folder, below, until you remove it. Exports Samskara read where they are stay there. A copy you chose to keep is inside the archive folder, so copy it out first if you want it.
Samskara then clears its own preferences and quits. Delete what remains by hand.
To take one app of this Mac out of the archive and keep the rest, turn it off in Settings, This Mac, and choose Remove from Archive. Samskara builds the archive again without it, and its photos leave photo search. What Samskara read from it before stays in the archive folder until you delete the archive, so turning it on again reads it back whole.
- Parts You Moved
- Any part you moved elsewhere, such as a Library or small copies on another drive.
- This Mac’s Folder
~/Library/Application Support/Samskara, with the settings, what you allowed each app, the folder you chose, and the Library of an archive whose drive cannot hold one.- An Older Archive
~/.samskara, if there is one. Finder hides it until you press Command-Shift-Period.- App Preferences
~/Library/Preferences/com.samskara.samskara.plist.- Web Caches
~/Library/Caches/com.samskara.samskaraand~/Library/HTTPStorages/com.samskara.samskara, which macOS keeps for the app’s window.- Archive Exports
- A
samskara-export-<date>folder that Export, in Settings under Archive, writes to your Desktop unless you chose another place. It is a full copy of the archive. - The Login Item
- In System Settings, General, Login Items, if you turned on Launch at Login.
- Agent Connections
- Press Remove beside the agent in Settings, Agents, before you remove Samskara, or delete the samskara entry from the agent’s MCP settings.
- The Keychain Item
- Samskara Gmail, in Keychain Access, if you connected Gmail.
- Background Jobs
- Delete Archive turns off Nightly Refresh. If you skipped it, turn Nightly Refresh off in Settings, General, before you remove Samskara.
- Permissions
- In System Settings, Privacy & Security, turn Samskara off under Full Disk Access, Contacts and Photos.
- The App
- From Applications.
The apps on your Mac keep their own data. Removing Samskara does not reach what an agent already received, or the copies your backups keep.
Updated November 17, 2026.