Skip to content
LLM-4-PeoplePublic

About

Local-first mail triage that explains every decision.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Mailsense

Ask your mail a question. It answers with a count, a list, or a written answer that cites the messages it used.

It reads the classic Outlook profile already open on your PC. Ask answers from the local index; a written answer comes only from a model you configured and the messages it can cite. The store, the classifier and the learned profile stay on your disk.

Mailsense: Ask your mail. Every citation opens the message.

Français · Documentation · Ask · Install · First run · Console · Mailboxes · Providers · Learning · FAQ · Privacy · Security · Troubleshooting · Contributing · Docs site

Ask first

Ask answers a question about your mail in plain language. The screen names which mechanism answered it: a typed query, a search, or a model you configured.

  • How many messages are urgent? returns a count from the local ranking. No model is called.
  • Summarize the thread about the delivery window. returns a written answer with a citation on every claim when a provider is configured. In Local mode the same question returns the matching messages and says that Local never calls a model.

Every citation opens the message it names, and every answer is stored with its question so you can reopen it.

Ask is bounded by qa.max_messages, qa.retrieval_timeout, qa.call_timeout and the two budget settings. A warming index keeps the question and offers Try again.

Read the Ask guide

Three things it does differently

  • The queue is scored by a fixed local policy. A local Go scorer ranks each message from stored signals: a suspicious message adds 100, a decision 45, a reply 30, urgency and deadline levels add fixed weights, and recency adds at most 12. A score of 20 is the floor, and a suspicious, decision, reply, urgent or deadline signal always enters. Bulk automated mail never enters, however urgent its text.
  • Every label names its source. A decision is stored as answers to named questions, with the confidence each answer carries where the question type has one and the evidence behind it. The message detail shows the fields the model read. When an index is partial, the screen names the missing part.
  • It abstains until your own labels certify it. The local classifier trains one head per question on your corrections. A question is certified only when the Wilson lower bound of its answered precision reaches 0.99 on a held-out split, with at least 200 training labels, 50 evaluation labels and 0.5 coverage. Below that threshold it abstains, and the Learning screen names the stage that blocks it.

What leaves the machine

Mailsense makes five kinds of network request. Each one has a reason you can see.

Leaves, only when it runs

  • The pinned local runtime and embedding model, downloaded once and checked against SHA-256 before use.
  • A request to a remote provider you configured, for an Ask answer or automatic triage after a sync. It carries the question and the message fields that call needs.
  • A provider model list when you press Fetch models.
  • One small test request when you press Test. A test is billable and is not covered by a budget.
  • The update check: at most once per update.check.interval (24 hours by default), one request to GitHub asks for the latest published release. It carries no mail, address or installation identifier, and can be turned off in Settings.

Never leaves

  • The mail store, attachments, indexes and learned profile. They are SQLite files in the data directory you chose.
  • The classification, evidence and ranking code. They run as local Go code, not as a cloud call.
  • No telemetry, no analytics and no vendor account.

Mailsense reads the classic Outlook profile already open on Windows. It does not ask for Microsoft credentials. A remote provider's terms govern what it does with a request you send. See privacy.

What it cannot do yet

  • Only classic Outlook on Windows is a live source. It reads the profile through COM. New Outlook, Outlook on the web, IMAP, POP, the Gmail API, Microsoft Graph and file import are not connected in this build.
  • The Linux preview is built from source. It opens, renders every screen and explains the missing source. The inbox stays empty because there is no live connector yet.
  • It reads and ranks. It does not act on the mailbox. No sending, deleting, moving or read-state changes. The connector is read-only.
  • Triage needs a decider. Without one, triage answers 422 provider_not_configured. Search and the local classifier still work.
  • The database is not encrypted by the app. Your operating-system account and disk encryption are the protection. Provider keys on Windows use DPAPI.
  • There is no SQL console and no diagnostics bundle. Logs are local and readable in the Logs screen. They redact secrets.

Install

The release ships a Windows installer; the source also builds on Linux as a preview with an empty inbox, and that build is not a release download.

Windows. Download the installer from Releases. The install is per user and needs no administrator rights. The database and settings live in %LOCALAPPDATA%\Mailsense, and uninstalling keeps them until you delete that directory. Mailsense needs the Microsoft Edge WebView2 runtime, which Windows 11 and current Windows 10 already have. The build is not code-signed, so SmartScreen may ask you to confirm the publisher.

mailsense-<version>-setup.exe

The version comes from the release tag. Download the file from the releases page.

Read the first-run guide

Status

Mailsense is in active development. Interfaces and stored schemas may change between releases; the changelog and the release notes call out anything that requires a migration.

Build from source

Go (the version in go.mod), Node (the version in .nvmrc) for the UI test harnesses, and optionally Playwright for the browser suite.

scripts/build.sh all        # dist/mailsense and dist/mailsense.exe
scripts/test-fast.sh        # gofmt, vet, script checks, unit and contract suites
scripts/test.sh             # exhaustive release gate

The UI is plain modules under internal/ui/js, concatenated into one bundle by go generate ./internal/ui. Architecture and ownership rules are in docs/ARCHITECTURE.md.

License

Mailsense is licensed under the GNU Affero General Public License, version 3 or later (AGPL-3.0-or-later). You can use it, study it, change it and share it. If you run a modified version as a network service, the AGPL requires you to offer the corresponding source to the people who use it. See LICENSE for the full text and NOTICE for the copyright and third-party notices.

Documentation

About

Local-first mail triage that explains every decision.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages