Briglia CLI
GitHub
Reference

Commands

Two surfaces: briglia subcommands in your shell, and /commands inside a conversation. The chat commands are one shared set — everything that works on Telegram works in the terminal, and vice versa.

Shell: briglia …

CommandWhat it does
briglia · briglia chatInteractive chat with Briglia (the default command).
briglia setupSetup wizard: providers, keys, permissions, channels. Re-run any single section later.
briglia daemonHeadless mode: no local chat, messaging channels (Telegram) only. One conversation-owning instance at a time — briglia and briglia daemon share state, the second refuses to start.
briglia doctor [--online]Check configuration, permissions and toolchain; --online also probes the configured services. Exit code 1 if problems were found.
briglia upgrade [-y] · briglia updateUpdate to the latest signed release; -y skips the confirmation.
briglia service install [--no-keepawake] | status | uninstallLinux: run Briglia as an always-on systemd user service (auto-start at boot via linger; keep-awake support on Ubuntu Touch). Bare briglia service = status.
briglia toolchain status | install [--pandoc] [--libreoffice] | upgrade | removeLinux: media/document tools — on Ubuntu Touch in an OTA-safe userdata prefix, no root.
briglia trigger <watcher-id> [payload…]Post an event to an external-trigger watcher created by Briglia. Works even when Briglia isn't running.
briglia media-selftestVerify the PDF/image pipeline (poppler/ImageMagick on Linux).
briglia --version · briglia --helpVersion and help.

Hidden but present: briglia setup-api (JSON setup surface used by the Ubuntu Touch app) and briglia bundle-check (used by the updater). Internal __… commands are self-tests.

Chat: /commands

menu marks the five commands shown in Telegram's “/” menu; /commands prints the full standard set below.

Control

/stop menuStop the current work immediately
/status menuShow what Briglia is doing right now
/prune menuFree up Briglia's working memory
/continueShow the rest of a long reply

Models

/model [id]Show or switch the main model
/provider [name]List or hop between configured LLM providers
/effort [level]Set the reasoning effort
/websearch [name]Show or switch the web research backend
/subagentmodelsShow or set the cheap subagent model lanes
/subagents [on|off]Turn the Agent delegation tools on or off

System

/upgrade menuUpdate Briglia to the latest release
/restartRestart Briglia (reloads mcp.json and skills)
/commands menuList standard Briglia commands

Account

/setname [name]Set or change your name (asks for confirmation)
/deleteuserdataErase all memory and user data (asks for confirmation)
/exportmind [lite]Save a memory backup (.mind) to this computer (add 'lite' to skip files)
/importmind [path]Restore a memory backup (asks for confirmation)
/resumewatcher [id]Review and re-arm watchers quarantined by a memory import
/switchbot [token]Move Briglia to a different Telegram bot (guided, asks for confirmation)

Terminal only

/helpShow the command list
/attach <path> [message]Send a file, with optional text
/quit · /exitLeave the chat (also Ctrl-C)

Power commands

Working but kept out of the table: /spend (shows today's and this month's spend with each limit; /spend turn|daily|monthly <usd|off> sets or removes a per-turn tool cap or a daily/monthly limit — all off by default; /more1, /more5, /more10 raise a reached daily/monthly limit for today/this month only), /hide and /show (privacy mode for local surfaces), /transcribe_openai. Aliases: /pulisci = /prune, /riavvia = /restart, /comandi = /commands, /continua = /continue.

Two-step commands

/setname <name> then /setname confirm; /importmind <path> then /importmind confirm; /deleteuserdata and /switchbot ask for a confirmation too. /upgrade and /restart refuse while a turn is running — /stop first.