On this page
Security
Mailsense is a local desktop app. It reads a mail profile on the same machine, serves its own interface on loopback, and keeps its data in a directory you control. This page states what that design does and does not protect.
The local server
The API listens on tcp4 127.0.0.1 with an ephemeral port. The listener refuses
to start if the bound address is not IPv4 loopback, so another machine on the
network cannot reach it.
The desktop window receives a launch token in the URL fragment. The script
copies the token to sessionStorage and removes it from the address before the
first API call. The token is not written to the DOM, the console or an error
message. Every API request carries it. A local process that can read your
session storage or the process memory is outside this boundary.
Data at rest
- The mail store, indexes and learned model are a local SQLite database. They are not encrypted by the app. Your operating-system account and disk encryption are the protection.
- Provider keys on Windows are encrypted with DPAPI. On other platforms the
secret store is read only and reads
MAILSENSE_SECRET_<NAME>from the environment. - Logs are local. They redact secrets, and the log owner applies the retention you set.
Runtime integrity
The local runtime is pinned to a fixed release and a fixed model. Downloads resume by range request and are checked for size and SHA-256. Unpacking writes a manifest with the hash of every file and promotes the directory atomically. Before every launch the app verifies the model, the manifest, the executable and every listed file, and it refuses an unlisted file or link.
Release integrity
A release asset is built by the release workflow from the tagged commit on
main. GitHub stores a signed build provenance attestation for every artifact
listed in SHA256SUMS, and
gh attestation verify <file> --repo LLM-4-People/mailsense checks it. The
release also publishes one CycloneDX SBOM.
The binaries are not code-signed. Windows may ask you to confirm the publisher. The attestation proves which workflow built the file; it is not a publisher certificate.
Network requests
The app makes these requests, and no others:
- The pinned runtime and model download.
- A remote provider call you configured, including an automatic triage or index pass after a sync when that role points at a remote record.
- A provider model list, when you ask for it.
- A provider test, when you press Test.
- The update check: one unauthenticated request to the Mailsense releases endpoint on GitHub, with no mail, address, account or installation identifier.
There is no telemetry, no analytics and no vendor account. Privacy lists the fields each request can carry.
Rendering untrusted mail
A message body is untrusted HTML. Mailsense rebuilds it instead of trusting it:
- The local server parses the stored body and keeps an allowlist of text elements, lists, quotes, tables and links. Scripts, frames, objects, forms and media are dropped with their content.
- The rebuilt fragment and the sender’s compiled presentation sheet are rendered
in an iframe whose sandbox grants no script, no popup and no top-level
navigation permission, and the document carries its own CSP:
script-src 'none',form-action 'none',base-uri 'none'. - Remote images become a placeholder, and a 1x1 tracking pixel is dropped entirely. Inline images are fetched by the shell with the bearer token and swapped into the frame as ephemeral blob URLs.
- A link is kept only for http, https and mailto. A click never navigates: it opens a dialog that shows the exact destination and offers Copy.
- Attachment reads are served from content-addressed rows and only as raster
inline images, with
nosniffand an asset CSP, and only when the message passes the owner and picked-store check.
When a model writes an answer
Ask can send retrieved messages to the provider you configured and show the answer it writes. Whoever wrote a message controls its text, so message text can try to steer that answer. This is indirect prompt injection, and no instruction to the model removes it. What the app constrains:
- Citation markers are checked, not trusted. An answer with a marker outside the numbered context is refused as a whole; a valid marker is renumbered to the message it names, and the citation list is built from those messages. That check proves the cited message exists in the context. It does not prove the answer’s words follow from it: a steered answer can carry a real citation.
- Model output changes no app state. A plan is strict JSON, validated against fixed shapes and run as a read-only local query. Counts and rankings are computed by local code, never taken from the model. An answer starts no further retrieval, no network request and no action on your mail.
- The model sees only owner-visible data from that turn: the numbered retrieved messages with their excerpts, computed counts and facts, and, in a thread, the prior turns. The answer footer names the provider and the model, and every citation opens the message it names. Treat a written answer as a suggestion, not as a trusted statement.
Report a vulnerability
Open a private security advisory from the Security tab of the repository. Include the version, the operating system, the affected route or screen, and a minimal reproduction. If a private advisory is unavailable, open a public issue that describes the impact without exploit details, and ask for a private channel.
Supported versions are the latest published release and the current main
branch. Please do not include real mail, provider keys or personal data in a
report.