Frequently asked questions

Is Briglia free?

The software is free for individuals (see License). You pay your own model provider for what Briglia uses — Briglia itself has no subscription and no telemetry.

Wasn't this called Ada CLI?

Yes. The project was renamed Briglia (Italian for bridle: you steer something powerful) to avoid a clash with an unrelated commercial tool. Same code, same signing keys, same license; the Ubuntu Touch companion became the Briglia app and the assistant introduces itself as Bree by default (a custom name you had given it is kept). Existing installations move over with one explicit command, briglia migrate, which the installer runs as its last step — see Install.

Which AI model does it use?

Whichever you configure: OpenCode Go (default catalogue), OpenRouter, any OpenAI-compatible endpoint, or a local inference server on your network. You can keep several providers configured and switch with /provider. See Providers & models.

Where does my data live?

On your machine: ~/.config/briglia (settings, secrets in a 0600 file) and ~/.local/share/briglia (conversation, memory, attachments, logs). Messages go to the provider you chose and nowhere else. /deleteuserdata wipes everything, including connected email credentials. See Storage & privacy.

Do I need Telegram?

No. The terminal chat and the Ubuntu Touch app work without it. Telegram is the easiest way to reach an always-on Briglia from anywhere. See Telegram.

Can it run on a Raspberry Pi?

Yes — Linux arm64 is a first-class build, and the always-on service is designed for exactly that. A Pi 5 is comfortable; the model runs in the cloud, so the Pi only orchestrates.

Can it run on a phone?

On Ubuntu Touch 24.04, yes — with the companion app or the terminal. Android and iOS are not targets (they don't allow a resident daemon like this).

Intel Mac?

Not supported; Briglia CLI ships for Apple Silicon only.

How do updates work? Are they safe?

briglia upgrade (or /upgrade from chat) fetches the latest release from GitHub Releases and installs it only if its Ed25519 signature verifies against a key pinned in the binary and its sequence number is not older than what you already run. See Security & signed releases.

Can Briglia run commands on my machine? Is that dangerous?

Yes, it has a real shell and full access to your user's files — that is what makes it useful. There are no approval prompts by design (it must work while you are away), so run it under an account whose files you are comfortable entrusting to it, keep secrets out of world-readable places, and prefer a dedicated user or machine for an always-on setup.

Can I move Briglia to another machine?

/exportmind writes a .mind archive (add lite to skip large attachments); /importmind <path> restores it elsewhere after validation. See Backup & move.

Is the Italian legal edition (Ada.app for macOS) the same thing?

They share a core, but Briglia CLI is a separate, English-only, terminal/daemon program without the legal databases or licensing checks. This site covers Briglia CLI and its Ubuntu Touch app only.

Where do I report a bug or a security issue?

Bugs: GitHub issues on the relevant repository. Security: privately, see the reporting instructions.