Privacy policy
Effective 2026-10-30. It covers three things that are easy to confuse: the mindfork application, the website mindfork.io, and the project's presence on GitHub. They have very different answers, so they are kept apart below.
The short version. mindfork is a local program. It has no telemetry, no analytics, no crash reporting, no update check and no account. Nothing it does reports back to the author, and there is no server of this project's for it to report to. Everything it stores stays in its data folder on your computer (§2), apart from the short-lived working files listed in §8. It talks to the network for the model you configured, for the tools and the companion features that are switched on — a messenger, notifications — and for the setup commands you run — and where it does, your data goes to that provider, under their policy, never through anything of ours.
The rest of this document is the detailed version, written from the code rather than from a template, including the parts that are on by default. Its companions: SECURITY.md (what the app promises, and how to report a break), DISCLAIMER.md §5 (what it means, legally, that a request leaves your machine), and docs/install.md (where the data directory is on each platform).
1. Who is responsible for what
The software is published by Vladimir Shylov, its author and copyright holder, as free open-source software under the MIT License.
For the data the application handles on your computer, you are the only party with access to it. The author operates no service that receives it and cannot obtain it. When you point the app at a provider, that provider becomes responsible for what you send them, on the terms you accepted with them; the author is not a party to that relationship and has no visibility into it.
For the website and the GitHub repository the author does make the choices — see §9 and §10, where both are deliberately kept as thin as they can be.
2. What stays on your machine
The app is portable by design: its data lives in a data/ directory next to
the executable, not in a hidden per-user location, unless a defaults.json next
to the binary selects a system location or another path
(docs/install.md). In a development build that is
target/debug/data/. So everything the app knows is in one place you can open,
copy, back up and delete. On Linux that directory is made readable to your user
alone (0700) every time the app starts, and the files it writes are 0600:
before, the system's default left both open to anyone else with an account on the
machine. On Windows the profile's own permissions do that.
| What | Where | Holds your conversations? |
|---|---|---|
| Settings, and the encrypted secrets map — each stored key labelled with the name of the computer it was entered on | settings.json | no |
| Profiles, system prompts, per-profile tool lists | profiles.json | your prompts |
| Chats | chats/<uuid>.json — messages, model thoughts, tool calls and their results, sub-agent transcripts, attached images inline, attachment text; for a reply that came through the OpenRouter gateway, also the name of the provider that served it and what the request cost; a voice message from the messenger as the words the recogniser heard — never the recording | yes |
| Notes, the RAG knowledge base and their embedding vectors, the self-model and every earlier version of it, the follow-ups a companion planned, the record of which model ran when | data.db (SQLite) | yes |
| The full-text search index | cache.db (SQLite) | yes — derived; delete it and it rebuilds |
Pre-images of every project file the assistant edited, for the F4 diff and revert | workspace/<chat-id>/ | your source code |
Files kept with a chat — what the Python sandbox saved (charts, tables, workbooks), and files you attached with /file attach whose original is kept: binaries, and the PDF, DOCX or HTML beside its extracted text | files/<chat-id>/ | yes — your files, and what the code made of them |
| Backups | backups/, or the location you choose | yes — see §7 |
| Diagnostics | logs/ | no — see §6 |
| The Python sandbox runtime | sandbox/ | no |
llama.cpp builds downloaded by mindfork llama setup | llama/ | no |
GPU kernels the NVIDIA driver compiled for the local llama.cpp server — unless your own CUDA_CACHE_PATH names another place | cuda-cache/ | no |
| Spellcheck dictionaries, locales, colour themes, the words you added yourself | dictionaries/, locales/, themes/, personal_dictionary.txt | the personal dictionary holds words you added |
None of this is uploaded anywhere by the app. Copying the folder to another machine carries your chats with it — and deliberately does not carry usable secrets (§7).
3. What leaves your machine
Every outbound connection is to an endpoint you configured, to a tool endpoint that is part of a feature that is switched on, or to the download host of a setup command you ran. There is no destination the app contacts on its own initiative, and no request is ever made about you, your machine or your usage. What follows is the complete list.
3.1 The model
Where your conversation goes depends on the engine mode you chose:
- Managed — the app starts
llama-serveron your own machine and talks to127.0.0.1only. Nothing leaves the computer, whatever the server was told to bind to. - External — the OpenAI-compatible URL you entered, and nowhere else.
- Cloud — the provider you selected:
api.openai.com,generativelanguage.googleapis.com(Google Gemini),api.anthropic.com,api.x.ai(Grok),api.deepseek.com(DeepSeek), or a different base URL if you set one. Each processes your data under its own policy — OpenAI, Google, Anthropic, xAI, DeepSeek — and their retention and training-on-your-data rules are theirs, not ours. Read them. - The OpenRouter gateway —
openrouter.ai, or a different base URL if you set one. A request sent through a gateway is processed by two parties: by the gateway itself, under OpenRouter's policy, and by the provider the gateway routes the request to, under that provider's. Which provider that is depends on the model you chose and on the gateway's routing, and it can differ from one request to the next; which providers your requests may reach, and on what terms for your data, is set in your OpenRouter account, not in this app, which sends no routing preference of its own. The gateway names the provider that served each reply and states what the request cost; the app stores both with the message (§2) and shows them nowhere yet.
Impersonation — the model drafting your next message — has an engine setting of its own. By default it shares the chat engine; pointed elsewhere, it sends the conversation to that external server, cloud provider or gateway instead.
What the app says about itself. To OpenRouter, and to no other provider,
every request the app makes in the openrouter mode — chat, embeddings, speech
(§3.4), the two questions listed under "Probes" below and the requests for the
lists of models — and every request the video tool makes while its provider is
openrouter (§3.3) — carries two headers:
HTTP-Referer: https://mindfork.ioX-OpenRouter-Title: mindfork
That is their whole content: the address of this project's website and the name
of the program, identical in every copy of the app. They hold nothing about you —
no name, no identifier, no machine, no text. By OpenRouter's own description,
it counts by them which application its traffic comes from and shows those
counts in its public application rankings. They are on by default. To stop sending them: Settings →
Model/server → any tab whose mode is openrouter → "Name the app to OpenRouter".
The same switch is shown in Settings → Tools → Video (YouTube) while the video
provider there is openrouter.
It is one switch for every slot that uses the gateway, and with it off neither
header is sent by any of them. An external engine pointed at the same address
never sends them.
The MINDFORK_ENGINE_URL, MINDFORK_LLAMA_BIN, MINDFORK_MODEL,
MINDFORK_EMBED_URL, MINDFORK_EMBED_BIN and MINDFORK_EMBED_MODEL
environment variables, when set, replace the chat or embedding engine in the
settings for that launch
(docs/install.md).
What a request contains: the conversation so far (a chat model is stateless,
so the history is re-sent every turn), the system prompt — including the
self-model text if those tools are enabled, and the text of chat attachments,
which are re-injected each turn — images encoded inline, the schemas of the
tools that are on, and the results of tool calls. Anything a tool retrieved
therefore becomes part of the history: a note recalled by note_recall or a
passage found by rag_search travels with every subsequent turn of that
conversation.
Requests you did not type. Some features ask the model on your behalf, and
they are worth knowing about because they are ordinary requests to the same
provider: naming a new chat (on by default, after the first substantive reply),
compacting a long history into a rolling summary, summarizing a page that
fetch_url retrieved, sub-agents and run_dialogue, and — only when you turn
them on — reflection and the notes/self-model consolidation passes.
Probes. In managed and external mode the app asks the server /health and
/props, and GET /models for what it is running — the model's name, context
window, image support and accepted parameters. The Grok cloud is asked the same
/props and /models, with your key, when the engine is set up and when you
attach an image. The DeepSeek cloud is asked GET /models alone, with your key,
at the same two moments — for the model's context window and whether it takes
images. The OpenAI, Gemini and Anthropic clouds are not probed.
The OpenRouter gateway is asked two things, both with your key:
GET /key— whether the key is accepted. Asked once each time the chat engine, the impersonation engine or the embedding engine is set up in theopenroutermode: when the app starts, and after you change that engine's settings, the key or the switch above. Only if nothing answers at all — no network — is it asked again, every 5 seconds, until something does; after the first answer it is not repeated. The answer also describes the key (its limit and its usage); the app reads whether the key was accepted and nothing else, and keeps none of it.GET /model/<the model you chose>— that one model's entry in the gateway's catalogue: its context window, the parameters it accepts, whether it takes images, how it reasons. Asked when the chat engine is set up, and by the impersonation engine when it is first used; the answer is kept until that engine is set up again, and a question the gateway did not answer is asked again the next time the answer is needed.
In this mode /health, /props and the full model list are never requested by
the engine. The speech setting in the openrouter mode (§3.4) asks neither of
the two questions: whether its key is accepted is learned from the first request
that speaks.
The video tool, while its provider is openrouter (§3.3), never asks the first
question — whether its key is accepted is learned from the first video — and
asks the second about its own model: GET /model/<the model you chose>, before
it watches a video, with your key. Of the answer it keeps which reasoning effort
to ask for, and nothing else. As a rule that is one request: the answer is kept
until the app sets its tools up again — when it starts, and whenever something
they are built from changes: the settings, a key, a plugin's tools, or what the
chat engine reports that it accepts — and a question the gateway did not answer
is asked again with the next video.
The model list. Enter on a model row of the settings screen asks that
tab's provider or server for the list of models it serves — when you press it,
and again on Ctrl+R; the answer is kept while the screen is open. The request
carries your key where one is configured, and nothing else of yours. For
OpenRouter it is your account's own list (/models/user) when a key is
configured and the public list (/models) when none is — the one case in which
the app contacts a cloud before you have given it a key — and
/embeddings/models on the Embeddings tab; like every request to OpenRouter it
carries the two headers described above, unless you switched them off.
On the Speech tab, in the openrouter mode only, three rows ask: Enter on the
Model row, on the Voice row or on the User voice row requests the gateway's list
of speech models — the same two lists, /models/user with a key and /models
without one, narrowed by ?output_modalities=speech — and the voices offered
are read out of that same answer. The request carries no text of yours; it
carries your key when there is one, so that the list is your account's, and the
two headers unless you switched them off. In the other speech modes these rows
are text fields and ask nothing.
In the video settings (Settings → Tools → Video), and only while the provider
there is openrouter, Enter on the Model row requests the gateway's list of
models. Without a key it is the public list, narrowed by the gateway to the
models that take video (/models?input_modalities=video); with a key it is
your account's own list (/models/user) — the whole of it, which the app then
narrows itself, by what each entry says the model takes. The request carries no
text of yours; it carries your key when there is one, and the two headers
unless you switched them off. It is made when you press the key, whether or not
the web tools (§3.3) are switched on. With gemini as the provider that row is
a text field and asks nothing.
3.2 Embeddings (notes, RAG, search reranking)
The embedding endpoint is a separate setting from the chat one: it can be a local server, an external URL, a cloud provider or the OpenRouter gateway — which may well be a different vendor from the one running your chat. Through the gateway, what is embedded reaches the gateway and the provider it routes to, as a chat request does (§3.1).
What gets embedded, and therefore sent there: note text, self-model traits,
chunks of documents you added to the knowledge base (including text extracted
from PDF and DOCX), chunks of chat attachments, the queries of rag_search,
note_recall and attachment_search — and, less obviously, web_search
queries together with up to 800 characters of each result page, which the tool
embeds to rank results. If your embedder is a cloud provider, that is search
content reaching a second vendor.
A request carries at most 64 texts, so a longer list — a long document added to the knowledge base at once — is sent as several requests, one after another, to the same endpoint. And a request that a cloud provider or the gateway failed for a passing reason — a rate limit, an overload, a lost connection — is sent again, up to three attempts in all: the same text can reach that provider more than once. A local or external embedding server is not asked again.
To notice that the embedding model has changed, the app also embeds one fixed
sentence (mindfork embedding canary v1) when it first uses the embedder after
the embedding engine was set up — when the app starts, after you change that
engine's settings, and after a local embedding server the app runs was
restarted — and a fixed set of calibration sentences once for each new model.
Neither contains anything of yours.
3.3 The web tools — off until you turn them on
tools.web_enabled is off in a fresh installation, and with it
web_search, fetch_url and youtube_watch. Everything in this section
happens only after you switch it on in Settings → Tools. (It shipped on before
0.9.9; an installation that already has a settings.json keeps whatever that
file says, so if you had it on, it stays on.)
web_searchqueries, in order,lite.duckduckgo.com,html.duckduckgo.com,www.mojeek.comandwww.ecosia.org. What is sent is the search string the model composed — which is derived from your conversation — plus a desktop browser User-Agent and anAccept-Languageheader. These engines are chosen by the app, not by you.- A keyed provider is preferred over that chain when a key is available:
today that is Tavily (
api.tavily.com). A key is only ever found where you put it — entered in settings, or in an environment variable you named in settings. No variable name is assumed, here or anywhere else in the app: before 0.9.9 the app looked forTAVILY_API_KEYby default, which meant a key exported for some unrelated tool could route your searches, and spend its credits, without a decision made anywhere in this app. - Result pages are fetched by default (
tools.web_fetch_content) to extract readable text, so the search engines' hits are visited too. fetch_urlretrieves the address the model chose. A page that fits the attachment budget reaches your chat model as a summary — up to 12 000 characters of it are sent to be summarized — or as its text, when the model asks for no summary or summarizing fails. A larger page (up to 1 000 000 characters) is attached to the chat and kept with it, and its passages travel like any attachment's (§3.1).youtube_watchfetches the video's watch page — or, failing that, its oEmbed record — fromwww.youtube.comfor the title and length, and, if a Gemini key is available — the one saved for the Gemini provider, or the variable you named in the video settings — hands the URL to Gemini, which watches the video on its own servers. No video bytes leave your machine; the URL and the prompt do. Gemini, by Google's own API, is the video provider unless you choose the other one, the OpenRouter gateway — described below this list.- Where they may not go: model-chosen addresses are resolved and checked
against the routable public internet — your LAN, loopback and other
non-routable addresses are refused, on the original request and on every
redirect, unless you set
tools.web_allow_private.
youtube_watch through the OpenRouter gateway. The video settings
(Settings → Tools → Video) name who watches: gemini, the default, or
openrouter. With openrouter — once a model is chosen there and the
gateway's key is available: the one saved for OpenRouter, or the variable you
named for it in the video settings — the tool's request goes to
openrouter.ai, or to the base URL you set, and no longer to Google's address.
A request carries:
- the video's address, which the app builds from the video's id — nothing else of the link that was pasted;
- the request text — what to find out about the video: the app's own instruction to describe it; the question the model asked of it, where it asked one, which it composed from your conversation; and, when a part of the video was asked for, a sentence naming that part;
- the name of the model, the ceiling on the reply and the reasoning effort asked for.
It is sent with your key, and with the two headers that name the application (§3.1) unless you switched them off. The app neither downloads nor uploads the video: the provider fetches it from YouTube. OpenRouter passes the request on to the provider behind the model you chose — Google, through AI Studio or Vertex — which processes it under its own terms, as with a chat request (§3.1). Of the gateway's answer the app reads the text — the description of the video, and its transcript when one was asked for — why the reply ended and the token counts, or the refusal. The text reaches your chat as the tool's result, a large transcript as a chat attachment, as it does from Gemini; what the answer says of the provider that served it and of the cost is not kept.
Before the first video the app asks the gateway about the model — once, as a
rule (GET /model/<the model you chose>; §3.1, "Probes", says when it is asked
again): that request carries the model's name and your key, and no text of
yours. What the app itself asks YouTube for — the watch page or the oEmbed
record, for the title and the length — is the same whoever watches.
With this provider nothing is sent to the gateway until the tool is used —
which, like every web tool, it cannot be until you switch the web tools on. The
one exception is the list of models: Enter on the Model row of the video
settings asks the gateway for it when you press the key, with the web tools on
or off, and carries no text of yours (§3.1, "The model list").
3.4 Speech
Text is sent for speech when you invoke /tts; when a profile has Speak
replies on (off by default), each reply that arrives in the open conversation;
and, while a profile answers you in a messenger and speaks its replies (§3.11),
a reply to a voice message, which goes back to you as one. The default provider
is OpenAI's cloud (api.openai.com), with Gemini, the OpenRouter gateway and
any OpenAI-compatible server as alternatives. What is sent is the message text,
flattened out of markdown — code blocks left out — and split into chunks. The
audio that comes back is played, or sent to the messenger as a voice message,
and is not stored.
Through the OpenRouter gateway — the speech setting's openrouter mode —
what is read aloud is sent to openrouter.ai, or to the base URL you set. A
request carries the text of the messages being spoken, as speakable text in
fragments of at most 2000 characters; the name of the model; the name of the
voice, when one is set; the audio format asked for; and the speech rate, when
it is not 1.0. It is sent with your key, and with the two headers that name the
application (§3.1) unless you switched them off. OpenRouter passes the text on
to the provider behind the model you chose — Google, xAI, MiniMax and others —
which processes it under its own terms, as with a chat request (§3.1).
The gateway's speech models do not all take the same audio format. When a model refuses the format asked for first, the same fragment is sent a second time, asking for the other format. Which format the model answered in is remembered until the app is closed, so this happens once for a model in a session — and once more if the model later stops taking the format it answered in.
In this mode nothing is sent until you type /tts or a profile speaks a reply
(above) — or until you press Enter
on the Model, Voice or User voice row of the Speech tab, which asks the gateway
for its list of speech models and carries no text of yours (§3.1, "The model
list").
Speech going the other way — a voice message you send the companion from a messenger — is §3.12.
3.5 Images you attach by URL
/image attach <url> downloads the image with its own client and re-encodes it
locally; the address is never handed to a model provider to fetch. Only http
and https addresses are accepted. Because you typed the address yourself, it is
not subject to the public-address guard in §3.3 — an intranet or loopback address
is your decision, not a model's.
3.6 MCP servers
MCP servers run as local subprocesses — the app speaks to them over the process's own pipes, not over the network. What leaves the app is whatever the model puts in a tool call's arguments; what the server then does with it, and where it sends it, is that third party's business and is covered by their terms, not this policy. Tokens you store for a server are passed to it as environment variables — and the server process also inherits the rest of the environment mindfork was started with, including any API keys exported in that shell. MCP is a double opt-in: a master switch plus per-profile approval, both off by default, and a server that changes its tool set after you approved it has to be approved again.
3.7 The Python sandbox's one-time setup
mindfork sandbox setup is an explicit command, run once. It downloads the
wasmer runtime from its GitHub release page and 34 Python wheels from
files.pythonhosted.org and pythonindex.wasix.org; each of those is
verified against a sha256 lock list before use. It then runs the downloaded
wasmer binary to fetch the Python distribution (python.webc, the largest
piece) from the Wasmer registry. That one is fetched by wasmer rather than by
this app, so there is no URL for the lock list to pin — instead the finished
file is checked against a pinned digest, and one that does not match is
replaced rather than used. What that third-party binary contacts beyond this is
outside our control. Nothing about your data is sent in any of it; it is a
package download.
If a wasmer runtime is present but the setup never finished, a Python run can
make wasmer fetch the plain Python package from the Wasmer registry itself.
Once Python execution is enabled, the sandbox's own network access is on by
default (tools.python_net_enabled), which means code the model runs can reach
the internet from inside the sandbox — public addresses only: this machine's
own services, your local network, the link-local range where cloud metadata lives
and the other non-routable ranges are refused, the same list the web tools use,
unless you set tools.web_allow_private. In the local Python mode the code
runs with your own interpreter and has whatever network access your computer has;
that switch does not apply to it.
The code the model writes also runs without the credentials in the app's
environment: variables whose names look like keys (*_KEY, *TOKEN*,
*SECRET*, *PASSWORD*, …) and whatever your settings name as a key source are
removed before the local interpreter — or a command of the code workspace — is
started. It is a narrowing, not a boundary: a secret under an unrecognisable name
still travels, and any code running as you can read your credential files.
3.8 The llama.cpp download
mindfork llama backends and mindfork llama setup are explicit commands. They
ask api.github.com for the release list of the ggml-org/llama.cpp repository,
and setup downloads the build you picked — and, for a CUDA build, its runtime
archive — from that release on GitHub, checking each file against the sha256
GitHub publishes for it. The requests carry the User-Agent mindfork-llama-setup
and no credentials: a GITHUB_TOKEN in your environment is not read.
3.9 The clipboard over SSH
When copying uses OSC 52 — automatically over a remote session or when the local clipboard cannot be reached, or always if you set it — the copied text is handed to the terminal, and over a remote session it travels the SSH connection to the machine you are sitting at. That is the purpose of the feature, and it is worth knowing that the text passes through whatever is between you and the host.
3.10 Notifications
When a profile has Notify me on (off by default) and the companion writes to you
while you are not looking, the app tells you. The terminal's notification escape
and its bell stay on this machine — the terminal shows them. If you also give a
ntfy topic (Settings → Interface → Notifications, empty by default), the app
sends a POST to that topic's URL — ntfy.sh or a server of your own: the title
is the profile's name and the app's, the body says which conversation it wrote in,
and what was said is not sent unless you turn on Message's words, which adds
the start of the message. A token for the topic, if you set one, goes with it. A
public ntfy topic is readable by anyone who knows its name, and the settings say so.
3.11 The messenger bridge (Telegram)
A profile with Messenger bridge on (off by default) and a bot's token you made
with Telegram's @BotFather is reachable from Telegram while the app runs. The app
then asks Telegram's Bot API (api.telegram.org, or the self-hosted server
named in bridge.telegram_api) for the bot's new messages — a request that waits
on Telegram's side for up to 50 seconds and is made again as soon as it returns,
for as long as the app runs — and sends the bot's replies there. Every request
carries the bot's token, as the Bot API requires. Nothing listens on your machine.
- What Telegram sees. A chat with a bot is encrypted between each side and Telegram's servers, not end to end: Telegram can read every message, picture and voice message of it, both ways, under its own policy. The settings say so before the switch is on.
- Who is answered. One account, paired by a code the app shows you. Telegram delivers whatever anyone sends the bot; a message from any other account is dropped — not answered, not kept, its pictures and voice messages never downloaded — and the log gets one line about it, without its content.
- What is fetched. A picture or a voice message from the paired account is
downloaded from Telegram's file server (
api.telegram.org/file/…), for the model and for the recogniser (§3.12). A picture is kept with the message, as an attached one is; a voice message's recording is not kept. - What is sent. The companion's replies — the text, a voice message when §3.4 says so, and each picture a reply from the phone drew (§3.13), as a photo under its file's name or, when Telegram would not take the original, a smaller copy — and typing… while it writes. Its thoughts, its tool calls and everything else of the conversation stay on this machine, in the conversation's file (§2).
3.12 Speech recognition
A voice message that reaches the companion through the messenger (§3.11) is sent
to be transcribed — to the speech-recognition provider you set in Settings →
Model/server → Recognition: OpenAI's cloud by default (api.openai.com), the
OpenRouter gateway (openrouter.ai, with the headers of §3.1), or a server of
your own. The request carries the recording as Telegram sent it (OGG/Opus), the
name of the model, and the language when you set one, with that provider's key. A
server that refuses the recording is sent the same recording once more, as WAV.
The provider processes it under its own terms; what comes back is the text, which
is your message in the conversation (§2). Nothing is recorded from a microphone on
this machine.
3.13 Image generation — off until you turn it on
image_gen.enabled is off in a fresh installation, and with it the
image_generate tool and the /image generate command. Once you switch it on
(Settings → Tools → Image generation), each time the assistant draws, or you draw
with /image generate, a request goes to the provider the settings name —
api.openai.com, generativelanguage.googleapis.com, openrouter.ai or
api.x.ai, or the base URL you set — with that provider's key: the one saved for
the provider, or the variable you named in the group. A request carries:
- the prompt — the picture described in words: composed by the model from your
conversation, or the description you typed after
/image generate; - the pictures to change, when the model named any: a file of the chat or an image of the conversation, as its bytes — a picture you attached included, if the model names it;
- the model's name, the shape, and the quality or size the settings hold.
Through the gateway the request also carries the two headers that name the
application (§3.1) unless you switched them off, and the gateway passes it on to
the vendor behind the model you chose, which processes it under its own terms.
Before the first picture through the gateway, and when you open the list behind
its Model row, the app asks it for its list of picture models
(GET /images/models) — with your key, when one is set, and no text of yours.
What comes back is the picture, kept in the chat's folder as the provider sent it
(§2), and what the provider counted or charged, which the tool's result and the log
say. With Show the picture to the model on, a copy of the picture is sent to your
chat model with the result, as a picture a tool returned is (§3.1). A picture
/image generate drew goes to your chat model only with the message you send
next, as a picture you attached does.
4. What is off until you turn it on
Off until you say otherwise:
- the web tools — search, page fetching, YouTube (§3.3);
- image generation (
image_gen.enabled, §3.13); - Python execution (
tools.python_enabled); - the file tools (
tools.fs_enabled) — and they work only inside the folder you set as their root (fs_root): until you set one they refuse, and the app's own data and program folders stay out of their reach either way; - MCP plugins — the master switch and the per-profile one, both;
- cross-chat search for the assistant (
chat_search,chat_read); - the self-model tools — and with them the injection of the self-model into the system prompt;
- reflection and the consolidation passes;
- reaching private or loopback addresses from the web tools;
- the confirmation prompt before a dangerous tool call
(
tools.confirm_dangerous) — it is opt-in, so tools you have enabled run without asking; - a profile's companion features, each its own switch: the time of messages, notes and earlier conversations in the prompt, follow-ups, notifications (and a ntfy topic, empty until you give one — §3.10), speaking replies as they arrive (§3.4) and the messenger bridge (§3.11).
On unless you turn them off:
- fetching the content of search results, once the web tools are on;
- preferring a keyed search provider, once you have said where its key lives;
- naming a new chat automatically, which is one extra model request;
- compacting a long history into a rolling summary once it nears the model's context window, which is one extra model request each time;
- showing the model the images a tool produced — charts from Python, images from MCP tools — once those tools are on;
- network access inside the Python sandbox, once Python is enabled;
- the two headers that name the application to OpenRouter, once an engine
or the speech setting is in the
openroutermode, or the video tool's provider isopenrouter(§3.1); - the cloud as the default speech provider — though nothing is spoken until
you invoke
/ttsor turn on a profile's Speak replies; - the cloud as the default speech recogniser — though nothing is sent until a voice message arrives through the messenger bridge (§3.12);
- the ordinary local tools: notes, the knowledge base, the time, and so on.
5. What the author receives
Nothing. There is no telemetry, no analytics, no usage statistics, no crash or error reporting, no update check, no version ping, no license check, no account and no server operated by this project. The addresses of the website, the repository and the crates.io page that appear in the "About" dialog are text on a screen; nothing fetches them.
One thing is worth stating beside that, because it is the only place where the
program is counted at all. If you use the openrouter mode — or have videos
watched through the gateway — and leave its attribution on (§3.1), your
requests name this application to OpenRouter, which
by its own description counts such requests and shows totals per application in
its public rankings. Those totals are OpenRouter's, they are public, and the
author can read them where anyone can; they say nothing about who made the
requests. Nothing is sent to the author by OpenRouter or by the app, and with the
switch in §3.1 off your requests do not name the application at all.
6. Logs
The app writes diagnostics to logs/, one file a day
(mindfork.log.YYYY-MM-DD), on your machine only.
No message text, no prompt text and no API key is written to them. What is
recorded is identifiers, counts, statuses, timings, model names, endpoint URLs,
error strings, and the paths and names of files you added to the knowledge base
or attached to a chat. Two things can carry third-party text into a log: the
error body a provider returned when a request failed, and lines an MCP server you
connected printed outside its protocol (its error output as well, if you raise
the level). At the default level, the URLs the web tools fetched are not logged;
they appear if you raise the level with MINDFORK_LOG.
Log files are not pruned: they accumulate until you delete them. They are excluded from backups.
7. Secrets, and backups
Secrets. Keys you enter in settings — cloud provider keys, external-server
keys, MCP tokens, a search API key, the backup password, a ntfy token, a
messenger bot's token — are stored inside
settings.json encrypted and bound to the machine: DPAPI on Windows, and on
Linux a key derived from the host's machine id and your user name, with
ChaCha20-Poly1305. A settings file copied to another computer therefore carries
no usable secret. The design and, importantly, its limits are in
ADR 0008: it defends against a
settings file carried off to another machine, not against code running as you on
your own. As an alternative you can store the
name of an environment variable instead of a key, in which case the app never
holds the value at all. Keys are sent only to the service they belong to.
Backups contain settings, profiles, your personal dictionary, a copy of
data.db, the whole chats/ directory — that is, your conversations — the
files kept with chats (files/), the copies of project files the assistant
edited (workspace/), your dictionaries and locale overrides, the .bak copies
of all of these, and the file tools' folder when it lies inside the data folder.
They exclude logs and previous backups. A backup can be encrypted with a password
(AES-256); note that even then the archive's manifest, entry names and sizes
remain readable without it. Where you put a backup, and who can read it, is your
decision — an unencrypted backup is a copy of everything.
8. Files the app can write outside its own folder
For completeness, since "everything lives in data/" is true of the app's own
storage but not of everything it can do at your request:
- a Python run, in either mode, gets a working folder under the system temporary
directory (
mindfork-sbx-<id>) holding the model's code and copies of the chat files the call named; it is removed after the run, and one left behind by a crash is removed 24 hours later. The interpreter is given the script's path, not the code; /exportwrites a conversation to the path you give, or to a generated file name in the current directory;- the file tools and the code-workspace tools write where the model asks, inside
fs_rootor the attached project directory — never into the app's own folders or a project's.git/; mindfork demoprovisions a throwaway data directory under the system temporary folder and removes it on exit;mindfork companion exportwrites one companion — its profile, notes, knowledge base and self-model with its history, without its chats — to an archive at the path you give, encrypted only if you give a password;- copying puts text on the operating system clipboard, which other applications can read.
9. The website, mindfork.io
The site is static — pages generated ahead of time, served from Amazon S3 through CloudFront. It has no analytics of any kind, no cookies set by us and therefore no cookie banner, no forms, no sign-up, no comments, and no third-party embeds: fonts, styles and images come from the site's own origin.
The infrastructure that serves it (infra/website.cfn.yaml) configures no access logging — neither the bucket nor the distribution is set up to deliver or retain request logs. Amazon Web Services is the hosting provider and processes requests in order to serve them, under its own terms. While the site is restricted to an IP allowlist during maintenance, a small function compares the requesting address against that list at request time; it stores nothing.
10. GitHub
The source code, the issue tracker and the release downloads are hosted by GitHub, so reading a page, opening an issue or downloading a release is subject to GitHub's privacy statement, not this one. The author sees what any repository owner sees: public activity on the repository and the contents of what you post there. Please do not put personal data into an issue — a bug report needs a version, an operating system and a reproduction, never your chat history. Security reports have their own private channel (SECURITY.md).
11. Donations
If and when the project accepts donations, the donation platform handles the payment and your payment details; the author never sees a card number. What reaches the author is what such platforms show a recipient — a name or handle, the amount, the date, and any message you attached. It is used only to acknowledge the donation and to keep the project's accounts, is not combined with anything else, is never sold or shared, and is not used to contact you about anything you did not ask for.
Donating is never required to use, obtain or update the software, and no feature is withheld from anyone who does not.
12. Deleting everything
Because the app is portable, deletion is a file operation and not a request to
anybody: remove the data/ directory next to the executable, and any backup or
export you made elsewhere, and nothing of yours remains. Removing cache.db
alone just drops the derived search index. There is no account to close and
nothing of yours on any server of this project's.
Data you sent to a model or search provider is held by them, and only they can delete it, under their own retention rules. The same is true of anything you posted on GitHub.
13. Changes to this policy
The policy is versioned with the source: it lives in the repository, changes through pull requests, and its history is public — so you can diff it. The date at the top marks the current version. A change that widens what the software sends anywhere is a user-visible change and would also appear in CHANGELOG.md.
14. Contact
Questions about this policy, or about what the software does with anything:
open an issue on the
repository, or write to the
project's maintainer address, vladimir.shylov@outlook.com — the same address
that identifies the maintainer of the Linux packages. For anything that is
actually a security problem, use the private channel described in
SECURITY.md rather than a public issue.