Email & calendar
Off by default. When enabled, Briglia can read and triage incoming mail, reply, and keep a calendar it consults when planning. Choose in briglia setup → “Briglia's toolchain” (or in the app's About-you step).
None (default)
No mailbox, no calendar context, no polling. Perfect if you only want a chat/files/research assistant.
AgentMail — recommended
A dedicated inbox for Briglia, separate from your personal mail: sign up at agentmail.to, create an inbox and an API key, paste the key. You get:
- Reading, sending, replying, forwarding, attachments — all terminal-free, including on the phone.
- Briglia's own calendar tool (
manage_calendar), stored locally. - Incoming mail delivered to Briglia as it arrives; watermarks advance only after a message is durably stored, so nothing is lost across restarts.
Briglia installs a small agentmail wrapper into ~/.local/bin. It is a key broker: the API key never sits in a shell environment; the wrapper fetches it from Briglia at call time. A bare agentmail from npm or Homebrew earlier on your PATH would shadow it and fail to authenticate — the setup warns if it sees one.
Google Workspace (advanced)
Your Gmail and Google Calendar through Google's gws CLI. Because the embedded OAuth client was removed for privacy, you bring your own: create a Google Cloud project, enable the Gmail and Calendar APIs, configure the OAuth consent screen (External, add yourself as a test user), create a Desktop app credential and paste its client ID and secret. Briglia writes them to ~/.config/gws/client_secret.json, installs gws, and asks you to run gws auth login once in a terminal (a browser round-trip). On Ubuntu Touch this is the one step the companion app cannot do for you.
With Google Workspace, Briglia reads your personal mailbox and sends its contents to your model provider as needed. A dedicated AgentMail inbox keeps that boundary clean — it is the reason it is recommended.
Switching and removing
Re-run the section in briglia setup to switch providers; Briglia stops the old poller, persists the new choice, clears cached context and starts only the selected one. /deleteuserdata revokes and removes AgentMail keys, gws OAuth tokens and all cached email/calendar data (server-side mailboxes are never touched).