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.
• An AI to power it. We recommend OpenRouter: one key covers everything, and new setups start on DeepSeek V4.1 Flash hosted on Together. A ChatGPT Plus or Pro subscription also works: you just sign in. OpenCode Go or your own server, local or online, work too (they also need an OpenAI API key). See Providers & models.
• Telegram on your phone, and two free keys (Serper and Jina) for web research. briglia menu shows you where to get each one.

1. Open the Terminal app

   The Terminal is an app already on your computer where you type commands. You only need it for two commands; everything else happens in your browser.

   Mac: press ⌘ + Space, type Terminal, press Enter. (Or open Finder → Applications → Utilities → Terminal.)
   Linux: press Ctrl + Alt + T, or look for “Terminal” in your apps.

   To paste a command: click the copy button below it, click inside the Terminal window, press ⌘ + V (Mac) or Ctrl + Shift + V (Linux), then press Enter.

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”.

   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. Set everything up with briglia menu

   briglia menu

   Copy

   First close the Terminal window and open a new one (Mac: ⌘ + N; Linux: Ctrl + Alt + T), so it finds the newly installed briglia. Then type the command and press Enter. This is the main way to set up and manage Briglia. A clean page opens in your browser and walks you through everything: how Briglia thinks (ChatGPT subscription is the easiest; OpenCode Go, OpenRouter or a local model also work), Telegram (it finds your chat by itself), a few free keys, and preparing the computer. Reopen it any time to change settings or start and stop Briglia. Details in briglia menu.

   Alternatives: briglia quicksetup (the older one-page form, see Quick setup) or briglia setup (the step-by-step terminal wizard, see First setup).

4. Talk to Briglia

   When the page says Briglia is running, write to your bot on Telegram. Need to change something later? Open the Terminal and type briglia menu again.

   You can also chat in the Terminal itself:

   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. briglia menu sets it up when you press Start; you can also 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.