Briglia CLI
GitHub
Start here

Briglia for Ubuntu Touch

A small app that does everything from the phone's screen: installs Briglia CLI, guides you through setup (scanning your keys from QR codes if you like), keeps Briglia always on, and lets you chat — text, voice notes and attachments — without Telegram.

Requirements

A phone running Ubuntu Touch 24.04 (aarch64 or x86_64) — for example a Pixel 3a or a Fairphone. The app is unconfined, which is what lets it install Briglia and manage the background service for you; it is distributed here and on GitHub, not through the OpenStore catalogue.

  1. Download the app on the phone

    Open this page in the phone's browser (Morph) and tap the button:

    Download Briglia 0.8.1 (.click)

    A .click package of a few hundred KB — version 0.8.1, published 1 September 2026, 270 KB. It lands in the phone's Downloads folder. This link is shown only after the release's signed manifest has been verified with the app's pinned key; the app verifies again on the phone.

  2. Install the downloaded file

    • Open the finished download (from Morph's download bar, or the File Manager → Downloads).
    • When asked what to open it with, choose OpenStore.
    • OpenStore warns the package is from an “untrusted source” — expected, it just means it isn't from the store catalogue. Confirm and tap Install.

    Or, from the phone's Terminal:

    pkcon install-local --allow-untrusted ~/Downloads/briglia.permaevidence_0.8.1_all.click

    Afterwards Briglia appears among your apps (restart the phone if the icon doesn't show up).

  3. Open Briglia and follow the guided setup

    On first launch the app checks the phone, installs Briglia CLI (downloaded from GitHub Releases and verified on the phone), then walks you through five steps: Main agent (provider and model), Service keys (OpenAI, Serper, Jina), About you (name, optional email & calendar), Telegram (optional) and Always on — the background service with keep-awake, which asks for the phone's passcode once. Every key is verified live before it is saved (“Verify, save & continue”).

    Tip for the keys: instead of typing them on the phone, open the QR key generator on a computer, paste your keys there (they never leave that browser), and scan the codes with the app's “Scan keys from computer” button. Every field fills itself.

  4. Use it

    The app opens straight into Chat once setup is complete. Dashboard shows health rows (CLI, setup, model, Telegram, service, keep-awake, toolchain, process), Start / Stop / Restart, the recent log and “Update Briglia CLI”; Settings lets you change any value later, scan a key bundle, pick the web-search backend, manage the media toolchain and check for app updates.

Updates

The app updates itself (Settings → check for updates; automatic updates are off by default) and updates Briglia CLI from the Dashboard. Both come from signed GitHub Releases, verified on the phone with pinned keys and protected against rollback. See Updates.

Good to know

  • Keep-awake: with the screen off, an Ubuntu Touch phone sleeps completely. The app installs a small kernel wakelock so Briglia keeps answering. After an Ubuntu Touch OTA update it can disappear — the Dashboard's Keep-awake row shows it, and Settings → Background service re-enables it (briglia doctor detects it too). The passcode is asked in a dialog, passed only on sudo's stdin, and never stored.
  • Media toolchain: on Ubuntu Touch the system partition is read-only, so PDF/image tools (poppler, ImageMagick, ffmpeg, optional LibreOffice and pandoc) are installed into your user data area. Settings → Media toolchain has “Check for tool updates”; nothing updates unless you tap it. See Media toolchain.
  • Google Workspace email still needs one gws auth login in the Terminal (browser OAuth round-trip). AgentMail and “no email” are fully terminal-free.
  • Coming from the Ada app: Briglia is a new package (briglia.permaevidence), so the old app cannot update into it. Install Briglia; on first launch it detects the previous installation, installs Briglia CLI and offers the migration step (your configuration, memory, Telegram pairing and the keep-awake unit move over — nothing migrates without your tap). Then remove the old Ada app from the launcher.
  • Chat talks to the local Briglia daemon over a same-user Unix socket; attachments never cross the socket (paths only), voice notes are transcribed by your configured provider and deleted afterwards.

Something went wrong?

  • OpenStore isn't offered to open the file → install OpenStore (preinstalled on most phones) or use the Terminal command above.
  • The app opens with a red error → the message says why (an update that failed verification is refused, never installed); the details help if you report it.
  • The app is open source-available too: permaevidence/briglia-ut.