What stays on your computer
The project does not receive your recordings, transcripts, summaries, screenshots, prompts, files, email, calendar events, or usage history. LokalBot can store these in its Application Support directory:
- meeting microphone and system-audio tracks;
- transcripts, summaries, notes, search indexes, and meeting metadata, including attendee names and emails for calendar-matched meetings;
- downloaded speech, embedding, and language models;
- permission-gated app/window activity, screenshots, and locally extracted text;
- records of local Claude Code and Codex sessions for the day digest (requests, commits, pull requests, and changed file names; never tool output or file contents), on by default and removable in Settings → Screen & Activity;
- opt-in Agent Mode sessions and runtime files;
- an encrypted Personal Context list of facts, preferences, goals, and principles about you;
- an index of the folders you choose to search under Files: file paths, their text, and vectors of what they say or show (see Files you choose);
- conversations downloaded from email accounts you connect, encrypted (see Email from Gmail);
- while you share with phones and tablets, the records your paired devices receive and those devices' public keys (see Phones and tablets); and
- preferences, diagnostic logs, and encryption keys.
Fresh installs select activity-only day tracking: the app name and window title. Visible text and encrypted screenshots are opt-in and require macOS Accessibility and Screen Recording permission. Screenshots are encrypted at rest and deleted after 14 days by default. Their extracted text follows the same retention unless you explicitly keep it. Overnight reviews, the one-line week and month summaries made from them for agents, and the remembered projects and goals are kept after screen text expires; Settings → Daily Review → Overnight review → Clear work memory deletes them. Dictation scratch audio is deleted after transcription by default. Dictated text is kept only as the last 10 results for 7 days, encrypted, so you can copy one again, and briefly for Learn from my dictation (below) while it is on.
Personal Context
Personal Context holds what you tell LokalBot about yourself: messages that start with “Remember …” in Ask, and items you add in Settings → Personal Context. With Learn about me from my meetings and work, which is on by default, LokalBot also learns from your own words after each overnight review. It reads your microphone lines from that day's meetings, the requests you typed to Claude Code or Codex, and your Ask questions. Only lines with first-person words such as “I” or “my” go to your Think model, and other people's words never do. Up to three items a night come from this, and a day is read again only when your lines from it change. Facts and goals you said in meetings are saved; preferences and anything from your typing wait for your review; principles and values are never learned. Each learned item shows the line it came from.
Learn from my dictation is off by default. While it is on, LokalBot keeps the words you dictate into other apps, encrypted, until that night's learning reads them, and never more than two days. It keeps only the words you spoke, only when they were pasted into a field it could identify, and skips excluded apps and websites, private windows, and password fields. Items from dictation always wait for your review. Turning it off deletes what is kept.
Items are encrypted with the key that protects your Ask history. Ask adds the relevant ones to each question, so an approved remote Think server receives them with the question. An item is removed when the meeting, conversation, or agent session it came from is deleted, or when the line it quotes is corrected or attributed to someone else, unless you chose to keep it. You can edit or forget any item, or turn learning off, in Settings → Personal Context.
When LokalBot uses the network
- Models: model metadata and files from Hugging Face or a publisher's download host. Selected first-use models can download automatically. If you choose HF-Mirror (hf-mirror.com) or ModelScope (modelscope.cn) in Settings, model files come from there instead, and every file is checked against the size and SHA-256 LokalBot pins.
- Updates: the public GitHub Releases appcast and a signed update when you check or enable automatic checks.
- Optional email: after you connect a Gmail account, LokalBot checks
gmail.googleapis.comfor new mail at launch, every three hours, each morning, and before meetings with attendees, using Google's read-only permission. Signing in uses Google's own page in a macOS sign-in sheet. To find conversations with people on your calendar, it searches your mailbox for their addresses; those searches go only to Google. See Email from Gmail. - Optional remote inference: an Ollama or OpenAI-compatible URL you configure. Loopback stays on your computer. A non-loopback origin must be explicitly approved before it receives meeting, workday, Personal Context, or agent context.
- Optional Agent Mode: setup downloads its pinned runtime. Commands you approve can access files or the network with your user account's permissions.
Those services receive ordinary connection metadata such as IP address and request headers. LokalBot adds no advertising identifier and does not use those requests for tracking. A remote server's operator controls its own privacy terms.
Phones and tablets
Settings → Phones & tablets lets you read your Work Memory on your own iPhone, iPad, or Android device. It is off by default and independent of every other grant; while it is off, nothing listens and no shared copy is built.
- What is shared: only the data classes you leave on: meetings (title, time, people's display names, summary, your notes, action items, decisions, open questions), transcripts, Day Digests (without the raw activity log), the Timeline (work sessions, apps, time per project, and window titles unless you turn them off), people, and tracked projects. You can limit the copy to the last 30, 90, or 365 days.
- What is never shared: calendar attendee email addresses, speaker evidence and voice profiles, screenshots and their paths, captured screen text, the files you chose under Files, email, Personal Context, overnight memory, Ask conversations held on the Mac, settings, and API keys.
- Where it travels: directly between your Mac and your devices, over your local network or your Tailscale network. LokalBot operates no server or relay and receives nothing. The Mac listens on one port and refuses every connection that doesn't come from a private network or Tailscale address. On the local network it announces itself with Bonjour under a neutral name unless you turn that off.
- Encryption and pairing: every connection is end-to-end encrypted and mutually authenticated with the Noise Protocol Framework. A device pairs only by scanning a code on the Mac that expires after five minutes and works once, and only after you allow it there. Afterwards the Mac accepts only the keys of devices you paired.
- Questions and changes from your devices: with Answer questions from my devices on, the Mac answers with your Think model and its existing approvals and never searches screen memory or your files for a device; with an approved remote Think server, the question and its context go there as they do for Ask on the Mac, and the device shows it. If the device disconnects before the answer is finished, the Mac finishes it and holds it in memory, never on disk, for up to 24 hours or until LokalBot quits, so the device can collect it. A device can mark an action open, done, or deferred.
- Removing a device: remove it under Settings → Phones & tablets; it is refused from its next connection. Remove this device on the device erases its copy.
Email from Gmail
This is LokalBot's disclosure for data it receives from Google APIs. LokalBot's use and transfer to any other app of information received from Google APIs will adhere to the Google API Services User Data Policy and the Google Workspace API User Data and Developer Policy, including the Limited Use requirements.
- What LokalBot reads: with the read-only Gmail permission (
gmail.readonly), your Gmail address and its verified "Send mail as" addresses, Gmail's record of what changed since the last check, the headers and labels of threads that match its searches, and the text of conversations that qualify: ones you wrote in, and ones where someone on your calendar in the last 90 or next 14 days takes part and the mail isn't bulk mail (Gmail's Promotions, Social, Updates, and Forums tabs, mailing lists, and automated senders). It never reads Spam, Trash, Drafts, or attachment contents, and it loads no images, tracking pixels, or links. Google refuses any change to your mail under this permission, so LokalBot can't send, delete, label, or mark mail as read. - How it is used: only for features you see in LokalBot on your Mac: the account list in Settings, and meeting briefs on Today. Before a meeting, LokalBot picks up to five conversations that include the meeting's attendees, matched by email address, and shows each one's latest new text, with quoted history removed and likely passwords and card numbers redacted. The brief's model receives the same excerpts, marked as quoted mail it must not take instructions from, and briefs are generated only by a model on your Mac. Nothing else reads the downloaded mail. Before another feature uses it, this policy will describe it and LokalBot will ask you.
- Where it is kept: only on your Mac, encrypted with AES-GCM using a key in your macOS Keychain, with the sign-in tokens in the Keychain too. LokalBot has no server, so nothing is uploaded.
- Who receives it: no one. LokalBot doesn't transfer or sell Gmail data to the project, advertisers, data brokers, AI providers, or anyone else, doesn't use it for advertising or credit decisions, and doesn't let any person read it. It is never used to develop, improve, or train AI or machine-learning models, and text from your mail is not sent to remote AI models.
- Retention and deletion: messages older than 90 days are deleted automatically, and mail you trash or delete is removed at the next check. Disconnect in Settings → Email deletes that account's mail and tokens at once and asks Google to revoke access; you can also remove it at myaccount.google.com/permissions.
Files you choose
Files (Settings → Files) searches folders on your Mac by what is in them. It is off until you turn it on after a notice, and it reads nothing until you choose a folder. It never picks folders by itself: Settings offers Documents, Desktop and Downloads as one-click choices, and macOS asks you for access only when you pick one. Its engine is DigUp's, running inside LokalBot.
- What LokalBot reads: only the folders you list: pictures and screenshots, PDFs page by page, and documents such as txt, md, rtf, doc, docx, odt, and html. It skips hidden folders, app bundles, caches, the insides of code projects except their screenshots, folders that look like datasets, and iCloud files that are not downloaded. Unless you turn it off, it also reads recordings 30 seconds of sound at a time and videos a frame per shot plus their sound. LokalBot never changes, moves, or uploads your files.
- How it is used: an on-device model, EmbeddingGemma 2 with its image and audio projector (a one-time 555 MB download), turns each picture, page, and passage into a vector, and Ask and Quick Recall search them when the Files source is selected. Reading runs when something in the folders changes and pauses while a meeting records, in Low Power Mode, and while the Mac is warm. A folder's first read goes slower while you use the Mac, judged by how long ago the last key press or mouse move was (never which key or where), and on battery it waits for a charger unless you allow it. Before you add a folder, LokalBot counts what it holds from file metadata alone to show how long the first read will take; the count is not kept. For a matched moment in a recording or video, the Ask assistant transcribes just those 30 seconds with your transcription model, only if it is already on your Mac and no meeting is recording, and keeps the words only for that answer.
- Where it is kept: in
files-index.noindexin the library: file paths, sizes and dates, the extracted text, short excerpts, photo capture dates, and the vectors. - Who receives it: no one by default. If you ask Ask a question with Files selected and your Think model is a remote server you approved, the passages it looked up go to that server, as meeting and screen text do. External agents using the CLI or MCP can search it only while you tick Files for them under External-agent access, and only in the folders you chose.
- Retention and deletion: the index follows the folders, so a file you delete or move out of them leaves it at the next pass. Turning Files off deletes the whole index.
Permissions and consent
Microphone and system-audio permissions enable recording. Calendar access helps detect and title meetings and provides local speaker-name suggestions. Attendee emails remain in meeting metadata, are deleted with the meeting, and are never added to transcripts, exports, or model prompts; once you connect email, they also choose which mail conversations LokalBot downloads. Accessibility enables browser-meeting detection, Cotyping, dictation insertion, and approved agent interaction. Screen Recording enables visual screen context when selected. Local Network is requested when you approve an inference server on your network or turn on Phones & tablets.
On a fresh install, LokalBot asks through a notification before it records a detected meeting. You can switch to automatic recording or turn auto-record off. You are responsible for informing participants and obtaining any consent required before recording other people.
External-agent access
The bundled CLI and MCP interface are read-only and refuse library access until you turn on Allow external agents to read your LokalBot data in Settings → External Agents. Under that switch is a box for each kind: Meetings, Screen memory (with the history it may read: today, the last seven days, or all retained history), What I shared about myself, and Files. Agents read only the kinds you tick, and ticking one never grants another; the first time, only Meetings is ticked. Turning the switch off removes every read grant and remembers your boxes for next time. Grants from earlier versions stay as they were, and nothing is added on upgrade. With What I shared about myself ticked, agents can read only the Personal Context items you mark Share with agents, at most 12 at a time, never the rest. With Files ticked, agents can search the folders you chose under Files by their words: they get each matching file's path, kind, dates, size, a short excerpt, and the passage that matched, from the text LokalBot extracted. Searching never changes your files, and LokalBot keeps the list of chosen folders in its control folder so the CLI can search while the app is closed. The start-of-session briefing (get_briefing, lokalbot-cli brief) follows the same grants: with all of them off it only lists which are off, and each part, such as your open action items, current projects and goals, recent coding-agent sessions, or the overnight-review timeline, appears only under the permissions that cover its sources. An enabled external tool runs as your user account, and a connected AI client may send what it reads under its own privacy terms, so connect only tools you trust.
Windows and Linux (alpha)
The Windows and Linux app follows this policy, with these differences:
- Storage: the library is in
%LOCALAPPDATA%\LokalBoton Windows and~/.local/share/LokalBoton Linux. API keys, the ChatGPT sign-in, calendar links, and the screen-image key are kept in the system credential store (Windows Credential Manager, or the Secret Service on Linux). - Not collected there yet: Personal Context, email, Files, coding-agent session records, spoken summaries, daily memory notes, meeting note export, and sharing with phones and tablets are Mac only for now.
- System audio comes from the whole output (WASAPI loopback, or a PulseAudio or PipeWire monitor), so anything else playing during a recording is recorded too. Meeting detection looks at which apps use the microphone and asks with a notification.
- Screen context reads visible text through accessibility (UI Automation or AT-SPI) and otherwise uses on-device OCR, downloaded only when you ask for it. The same exclusions, redaction, encryption, and 14-day default retention apply.
- Dictation audio stays in memory and is never written to disk. The text is pasted through the clipboard, and your previous clipboard comes back afterwards. The last 10 results are kept for 7 days, encrypted, so you can copy one again.
- Calendar reads private iCal or CalDAV links you add, fetched from their own servers every five minutes while calendar use is on, and on Linux the calendars of Evolution Data Server. Events stay in memory.
- Permissions: there are no macOS-style prompts. Windows uses its own microphone privacy setting, and Wayland desktops may ask through portals for screenshots and shortcuts.
- Network: models from Hugging Face and GitHub, the llama.cpp runtime from GitHub, the OCR model from the ocrs project, Agent Mode's Bun (GitHub) and pi (npm), update checks against GitHub Releases, the servers and plans you approve, and your calendar links. Updates install only when you choose.
- External agents: the meeting-library and screen-memory switches in Settings → Privacy & Data work as on a Mac. Agents can't change settings there, and personal context stays off.
The full details are in PRIVACY.md.
Deletion, security, and changes
You can delete meetings in the app or remove LokalBot's library folder (its Application Support directory on a Mac). No software can promise absolute security. Report vulnerabilities through the private process in the security policy. Material policy changes will update this date and appear in release notes.
Contact
Use the support page for privacy questions. Never include recordings, transcripts, secrets, or other sensitive data in a public issue.