higgs

higgs is an independent, community-built CLI for Proton Mail that is not affiliated with, endorsed by, or sponsored by Proton AG. It is an unofficial project built by Akeem Jenkins. The software uses Apache-2.0 licensing and is open source.

Users can install higgs via Homebrew, Go install, or release tarballs. The software uses an NDJSON output format for piping between commands and runs entirely on the user's hardware. It supports self-hosted Jev decision models for triage when the PM_CLASSIFY_BACKEND environment variable is set.

The software integrates with Ollama by default or any self-hosted OpenAI-compatible server such as llama.cpp. It also supports the PM_LLM_BACKEND environment variable to switch between different local model backends. No cloud inference or third-party API keys are required for operation.

Bridge credentials are stored in the OS keyring, such as macOS Keychain or Windows Credential Manager. If the keyring is unavailable, an AES-256-GCM encrypted-file fallback is used. Nothing sensitive ever enters a model's context window during processing.

higgs is built so that mail flows through Proton Mail Bridge on 127.0.0.1, and the model runs locally. There is no code path that sends a message anywhere else, ensuring privacy by default. This architecture prevents any third party from seeing subject lines or content.

The tool outputs NDJSON to stdout, which allows piping results directly into other commands. For example, search results can be piped directly into archive commands using the --uid flag. This enables seamless automation and data processing workflows.

Some reviewers note that higgs provides faster triage and better bulk-mail detection on a real inbox. The software uses calibrated probabilities instead of generated JSON for classification tasks. These features help users manage their Proton Mail inbox more efficiently.

The software is designed to work entirely on the user's machine without any cloud inference. It requires no cloud API keys and operates with zero telemetry. All processing happens locally through a self-hosted model.

higgs is an open-source tool that can be installed via Homebrew, Go install, or release tarballs. It is available as a signed release where every byte stays on 127.0.0.1. The software supports multiple installation methods for different user preferences.

The tool provides a schema for classify commands that includes exit codes like 0, 2, 3, 4, 5, 6, and 7. It also supports dry-run modes and limits on the number of results returned. These features allow for safe testing and controlled execution.

higgs is built on the philosophy that nobody should exploit user data, aligning with Proton's end-to-end encryption approach. It keeps mail classification, search, and summaries entirely on the user's own hardware. This ensures that the architecture itself enforces privacy without relying on promises.

higgs is an unofficial project that uses Proton Mail and Proton Mail Bridge trademarks only to describe interoperability. It is not officially affiliated with Proton AG but follows their privacy-first architecture. The software is designed to complement Proton's existing security measures.

higgs is a computer software listed on Trustburn. higgs is an open-source, local-first AI command-line tool designed to work with Proton Mail through Proton Mail Bridge.

The official website of higgs is higgscli.com.

higgs has no reviews on Trustburn yet. Anyone who has used it can write the first review on its Trustburn page.