Install on Mac & Linux

What you need

• A Mac with Apple Silicon (M1 or later, 2020+), or a Linux computer on x64 or arm64 — recent Ubuntu/Debian work best; ARM boards such as the Raspberry Pi 5 are fine.
• An internet connection.
• API keys: one main-model provider key is required (OpenCode Go is the default; OpenRouter, a custom OpenAI-compatible endpoint or a local server also work). OpenAI, Serper and Jina keys are optional but recommended — they power voice messages, image/PDF understanding and web research. See Providers & models.

1. Open a terminal

   Mac: press ⌘ + Space, type Terminal, press Enter.
   Linux: press Ctrl + Alt + T, or look for “Terminal” in your apps.

2. Paste the install command

   curl -fsSL https://github.com/permaevidence/briglia-cli/releases/latest/download/install.sh | bash

   Copy

   The installer downloads the latest release from GitHub Releases, verifies its Ed25519 signature and SHA-256 with a key pinned in the script, and installs briglia into ~/.local/bin. It ends with “Briglia CLI is installed”. If it asks you to open a new terminal, do that before continuing.

   On Linux it may first ask you to install two system libraries (libcurl4, libxml2) — it prints the exact command; run it, then run the installer again.

3. Run the setup wizard

   briglia setup

   Copy

   About five minutes: it asks for your provider and model, keys, your name, optional Telegram and email, and — on Linux — whether Briglia should run as an always-on service. Every key is checked live before it is saved. Details in First setup.

   Mac only: the wizard will ask you to grant the Terminal Full Disk Access in System Settings. Follow the on-screen steps; the Terminal restarts and the wizard resumes where it left off.

4. Talk to Briglia

   briglia

   Copy

   Type as you would to a person. Attach a file with /attach, stop a long turn with /stop, leave with /quit. If you set up Telegram, Briglia answers there too.

Updating later

briglia upgrade

Or send /upgrade from Telegram or the chat: Briglia downloads the new release, verifies the signature, swaps itself in place and restarts, confirming when it is back. Details in Updates.

Raspberry Pi and other always-on Linux boxes

On Linux, Briglia can run as a background service that answers on Telegram with the terminal closed and comes back by itself after a reboot or a crash. The wizard offers it as the last step; you can add it any time with briglia service install. See Always-on service.

Ubuntu Touch phones (terminal route)

The easiest way on a phone is the Ubuntu Touch app, which installs and configures Briglia for you. If you prefer the phone's Terminal, the command uses wget instead of curl:

wget -qO- https://github.com/permaevidence/briglia-cli/releases/latest/download/install.sh | bash

Then run the setup command the installer prints (usually ~/.local/bin/briglia setup). The wizard recognises the phone: the last step enables the always-on service and offers the keep-awake — without it the phone sleeps fully when the screen goes off, taking Briglia with it. That step asks for the phone's passcode (the only extra question compared to a computer).

Something went wrong?

• “command not found: briglia” right after installing → close and reopen the terminal.
• The installer refuses the download (“signature”, “sequence” or “checksum” in the message) → it is protecting you: the release it fetched did not verify. Try again later; if it persists, report it.
• Setup stops at a key → the key failed a live check with its provider; paste it again or check your account's credit.
• Health check any time: briglia doctor (add --online to also test the providers).

Coming from Ada CLI

Briglia is the renamed Ada CLI. A machine that already runs it (the ada command, ~/.config/ada) is handled by the same one-liner above: the installer detects the previous installation and, as its last and explicit step, runs

briglia migrate

which moves configuration, secrets, memory, reminders and watchers, the Telegram pairing and the always-on service to the new names in one journaled transaction — verified before the old installation is retired, rolled back to a working Ada if anything fails. ada stays as an alias of briglia. briglia migrate --status shows where things stand; briglia migrate --rollback undoes an interrupted migration before its commit point. Nothing migrates on its own: diagnostics such as briglia doctor only tell you it is pending. The assistant keeps a custom name you gave it; the old default “Ada” becomes “Bree”.

Installing from source

git clone https://github.com/permaevidence/briglia-cli.git
cd briglia-cli
./scripts/install.sh      # builds a release binary and installs the briglia command

Requires Swift 6+ (on Linux, swiftly is the easiest path). Update with git pull && ./scripts/install.sh. Source builds don't self-update.