Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tinfoil.sh/llms.txt

Use this file to discover all available pages before exploring further.

TL;DR
  1. Download Tinfoil Proxy for macOS, Linux, or Windows from the latest release (see Install below).
  2. Launch the app — the proxy starts automatically and lives in your menu bar.
  3. Point any OpenAI-compatible tool at http://127.0.0.1:3301/v1. The session is attested before the first byte of upstream traffic leaves your machine, and re-verified whenever the enclave rotates its TLS certificate.
Tinfoil Proxy is the same verified proxy as the CLI binary wrapped in a menu-bar app. At session start it verifies a Tinfoil router enclave against the public attestation transparency log; for the rest of the session every upstream connection is TLS-pinned to the attested public-key fingerprint, and the underlying Go client re-runs attestation if the enclave presents a new certificate.

Install

Download the matching .pkg for your Mac from the latest releaseTinfoil-Proxy-arm64.pkg for Apple Silicon, Tinfoil-Proxy-x64.pkg for Intel — and double-click to install, or run:
# Apple Silicon (swap arm64 for x64 on Intel)
curl -fsSL -o /tmp/Tinfoil-Proxy.pkg \
  https://github.com/tinfoilsh/tinfoil-proxy/releases/latest/download/Tinfoil-Proxy-arm64.pkg
sudo installer -pkg /tmp/Tinfoil-Proxy.pkg -target /
open -a "Tinfoil Proxy"
After installing, open the app once to launch it into the menu bar. If you want Tinfoil Proxy to start automatically next time you log in, toggle Open at Login from the popup or the tray menu.

Use it from any tool

Point your OpenAI-compatible tool at the local endpoint Tinfoil Proxy exposes:
Base URL: http://127.0.0.1:3301/v1
On startup the proxy auto-discovers a Tinfoil router enclave, verifies its attestation, and forwards subsequent requests to it. The enclave’s attested public-key fingerprint is pinned for the rest of the session, and the underlying Go client re-runs attestation if the enclave rotates its TLS certificate. You can copy the URL from the menu-bar popup.

Compare to the CLI

Tinfoil Proxy is the menu-bar wrapper around the same tinfoil-proxy binary; both serve http://127.0.0.1:3301/v1 and do the same attestation. Pick whichever fits your workflow:
CLI (tinfoil-proxy)Menu-bar app (Tinfoil Proxy)
Best forScripts, CI, headless serversDay-to-day use on your laptop
Installgo install … or pre-built binary.pkg / .deb / .exe
Stays runningForeground processMenu-bar (opt in to Open at Login)
Auto-updateManualBuilt in (macOS & Windows)
Verification UILogsLive status

Resources

Verification Center

Inspect each step of the live attestation flow.

CLI proxy

The same proxy as a foreground process — handy for scripts and headless servers.