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, those devices' public keys, and recordings on their way from them (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 autocomplete server: Autocomplete runs on your Mac unless you choose Think's server or another OpenAI-compatible server in Settings → Models → Autocomplete. A loopback server keeps your typing on your Mac. Any other server receives it only after you approve its exact origin for autocomplete; an approval for Think does not cover autocomplete. While you type where autocomplete can suggest, each request sends the text before the caret, your writing profile (name, style, languages, and notes), and whichever of these you have turned on: the app and window title, the clipboard, visible text above the field, focused-window text, meeting and work memory, screen-derived memory, and learned examples. Secure fields and excluded apps and sites are never read. A server on the internet must use HTTPS.
- Optional transcription server: Transcribe can use a speech-to-text server you choose in Settings → Models → Transcribe instead of a model on your Mac. It is off unless you select it. LokalBot then sends that server audio: each meeting track, imported recordings included, in clips of at most 30 seconds, dictation recordings, and the live preview while recording when you turn it on. Each clip carries the model id, the language hint, and the transcription vocabulary, including names added from your calendar, related meetings, and projects. Speaker separation, speech detection, and voice profiles still run on your Mac. A loopback server stays on your Mac; any other origin needs its own approval to receive audio, separate from the Think server approval, and internet servers require HTTPS. You can revoke the approval in Settings → Models; meetings then wait for transcription.
- Optional subscription plans: Think can run on your own ChatGPT or Claude plan instead of an API key. Each plan is approved where you choose the Think model, separately from any API-server approval for the same company, and signing in alone sends no content. Once approved, the plan receives the same Think context as an approved server, and the provider's terms for your account apply. The ChatGPT plan signs in at
auth.openai.comin your browser and sends requests toapi.openai.comwith storage turned off; LokalBot receives your name, email, and an OpenAI account id, never your password, and keeps the session tokens in the Keychain. The Claude plan runs the Claude Code you installed and signed in to yourself, with its tools, MCP servers, and settings files turned off; LokalBot never reads your Claude credentials, and Claude Code sends the request to Anthropic. - Optional Agent Mode: setup downloads its pinned runtime: Bun from GitHub and the pi agent packages from the npm registry. 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, and record meetings there for your Mac to process. 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.
- Recordings from your devices: a paired device records only after you tap Record, and shows the system's recording indicator meanwhile. It's up to you to let people know they're being recorded and to follow the law where you are. The audio stays in the app's private storage, left out of device backups, until the device reaches your Mac. It then travels directly over the same encrypted connection, and the device deletes its copy once your Mac confirms it has stored the meeting. Your Mac accepts recordings only from devices you paired, and only while Accept recordings from my devices is on. The recording becomes a meeting with that audio as its microphone track and no screen context, and is then processed, stored, and deleted like any other meeting, with your transcription and Think models, including any remote server you approved.
- Removing a device: remove it under Settings → Phones & tablets; it is refused from its next connection, and it erases its copy. Recordings that haven't reached your Mac stay on the device until you pair it again, which sends them, or delete them there. Remove this device on the device erases its copy and those recordings.
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. The use of raw or derived user data received from Google Workspace APIs will adhere to the Google User Data Policy, including the Limited Use requirements. That includes the AI models LokalBot runs on your Mac.
- 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, or Drafts or the contents of attachments, whose names, types, and sizes it keeps, 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. A generated brief stays in the app's memory and is never saved to disk. Conversations you wrote in stay on your Mac so a brief is ready when someone in them joins a later meeting. Nothing else reads the downloaded mail: not search, Ask, Dream reviews, Personal Context learning, exports, or the CLI and MCP. Before another feature uses it, this policy will describe it and LokalBot will ask you.
- Where it is kept and how it is protected: only on your Mac, encrypted with AES-GCM using a key in your macOS Keychain, with the sign-in tokens in the Keychain too. Mail and tokens travel between Google and your Mac only over HTTPS. 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.
- Aggregated or anonymized data: the only aggregate figures LokalBot makes from Gmail are conversation and message counts, which Settings shows and its log on your Mac records. It makes no anonymized data from your mail, and sends nothing aggregated or anonymized anywhere.
- Retention and deletion: messages older than 90 days are deleted automatically, and mail you trash, delete, or that stops qualifying 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. Deleting LokalBot's library folder removes all downloaded mail.
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 only read your library, never change it, 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.
A separate switch, Allow external agents to change LokalBot settings, lets lokalbot-cli config, status, and open read and change your settings in the running app, over a local socket that exists only while the switch is on and accepts only your user account. API keys are never returned. An agent can change preferences and narrow what LokalBot captures or sends right away, for example turn capture off or add an exclusion. Anything that would widen it, such as turning on capture, a data source, autocomplete, or dictation, approving a server, removing an exclusion, or changing retention, and every API key saved with lokalbot-cli secret set, waits for you: LokalBot shows a card naming the program that asked and every change, and nothing changes unless you click Approve. Requests expire after five minutes. Each change is listed under the switch with Undo, and turning the switch off declines anything still waiting. An agent setting LokalBot up for you asks for access with lokalbot-cli setup start; only clicking Allow in LokalBot turns it on.
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). Ask conversations, Personal Context, and the dictation learning log are encrypted under a per-install key kept there too. - Not collected there yet: email. Gmail in meeting briefs is Mac only for now, so none of its data is collected there.
- System audio comes from the detected meeting app alone where it can be separated (WASAPI process loopback on Windows build 20348 or later, or the app's own PulseAudio or PipeWire streams on Linux). Otherwise it comes from the whole output, 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 in your app and system languages: the recognizer built into Windows, or the Tesseract program on Linux if it's installed, with ocrs as the fallback for Latin letters. The ocrs models and Tesseract's language data download only when you ask. Tesseract gets a window's pixels over a pipe from memory, never from a file, and only the text it returns is used. The same exclusions, redaction, encryption, and 14-day default retention apply.
- Dictation audio stays in memory unless you turn on Keep dictation audio files, which saves WAV files in the library. 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.
- Autocomplete (Cotyping) is off until you turn it on, and never reads password fields, terminals, excluded apps, or LokalBot's own windows. On Wayland it works as the desktop's input method: on Sway and Hyprland when you turn it on, on GNOME when you also choose LokalBot as an input source, and on KDE Plasma when you also choose it under Virtual Keyboard, where Plasma then runs a small LokalBot helper for the session. While a text field has focus, the desktop gives LokalBot the field's kind and up to 4,000 bytes of the text around the caret, without LokalBot asking the app. In a password field, a terminal, an excluded app, LokalBot's own windows, or an app it can't name, that text is dropped unused as soon as the field is identified, and nothing is suggested. On Sway, Hyprland, and KDE Plasma, LokalBot sees your keys only while a suggestion shows, and passes on every one but the accept keys and Esc. On GNOME, while LokalBot is the chosen input source, the desktop asks it about every key press in a text field except in password fields. Neither keys nor the text around the caret are kept or logged, and choosing another input source or turning autocomplete off ends all of this.
- Selection actions work as on a Mac, with Ctrl+C for ⌘C, and terminals are never sent Ctrl+C. Apps without accessibility can't be checked for a focused password field, so LokalBot relies on toolkits refusing to copy from one, and results there are copy-only.
- Coding-agent sessions are read only after you choose that in setup or Settings → Day Memory, even if an earlier version or a Mac saved the setting as on. Until then nothing under
~/.claudeor~/.codexis opened. - Review the day overnight is under Settings → Day Memory, and is on by default as on a Mac.
- Remembered voices: the key is in the system credential store; without one, names stay on the transcript and no voice is kept. A voice match is only offered, and Apply Names names the speaker. Voice files are sealed per install, so on another computer they stay untouched and voices aren't remembered there.
- Files you choose: words in screenshots come from screen text recognition only if it's already available, and matched files open in their default app. A scanned page is read only when its picture is stored as a JPEG or plain raster; JBIG2, CCITT, and JPEG 2000 scans stay unread.
- Phones and tablets work as described above, with this computer in place of the Mac. The long-term key is kept in the system credential store; if that can't be reached, sharing stays off and says why. A firewall can block the port on either system, and Settings says what to allow.
- Remote servers: Think and Agent Mode refuse plain HTTP to any non-loopback server, even once approved. A transcription server you approve receives audio and vocabulary, in clips of at most 15 seconds.
- 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 (or HF-Mirror or ModelScope if you choose them) and GitHub, the llama.cpp runtime from GitHub, the OCR model from the ocrs project, Tesseract's language data from GitHub, 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, files, and screen-memory switches are in Settings → Privacy & Data, and What I shared about myself is in Settings → Personal Context. They work as on a Mac, each on its own. A separate switch lets agents change settings; turning on capture, a data source, or sharing still needs you in the app.
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.