BrainwriteDocs
Security

Usage analytics

What the desktop app and Brainwrite Cloud send about how Brainwrite is used, and how to turn it off.

Brainwrite sends usage analytics so we can see which features people use and what they rely on. It is on by default. Turn it off in Settings → Usage analytics on this computer: from then on nothing is kept or sent, and anything waiting to be sent is dropped.

Where it goes

The desktop app sends events to Brainwrite's account service (accounts.brainwrite.app) with your signed-in session. The account service adds who you are and passes them to LogZuno, the analytics service we use. While you are signed out, events wait on your computer (at most 1,000) until you sign in.

Every event carries:

  • your Brainwrite account's email, taken from your signed-in session;
  • your IP address, as Cloudflare sees it;
  • your Brainwrite Cloud plan (or none), and your paying account, so plans can be compared;
  • the app version and whether it is the desktop app or a browser.

Never sent

Your conversations, prompts, bots' replies, files, the names of your bots, teams or group chats, the names, sites or values of your secrets and logins, API keys, passwords and web addresses. Where an event names something, it is a word from a fixed list (an engine, a provider, a connected app); anything else is sent as "other".

What is sent

Using the app

  • The app opening: the first time on this computer, each time it opens, and the first time each day you use it, with whether the app is in Simple or Advanced mode that day.
  • The Simple mode window shown once after an update: that it was shown, each flip of its Simple mode switch, and that it was closed, with the mode.
  • Partner offers: an offer shown, moving between offers, copying its code, opening the partner's site, and closing them, with the partner and when the offers were shown (after an update, at Brainwrite Cloud sign-in or when the app opened).
  • The Bring your bots together card, shown when your bots live both on this computer and on a Cloud or a server: whether you brought them together or chose not now, and which kind of place (a Cloud or a server).
  • The rail of places at the window's left edge: opening a place from it (which kind: this computer, a Cloud, a team's Cloud or a server), and its + (opened, and what you chose: buy a Cloud, paste a pairing link, or enter an address).
  • Once a day, a count of what is set up: which providers you have a key for (never the key), which engines are ready, how many bots (by where they run), group chats, teams, routines (by kind), webhooks, secrets, saved logins, connected apps (by name, from Brainwrite's list), paired phones and devices, how many other people use this workspace, and whether voice, the decision model and Live calls are set up.
  • Once a day, for the day before: how many messages you sent, how many turns bots ran, and the tokens they used, in total, by engine and by model. A model you named yourself on your own endpoint is sent as "custom".

Setting up

  • Each step of the welcome and how it ended; whether you entered or skipped an email; importing settings from another app; setting up your phone.
  • Saving or removing a provider key (which provider, where: Settings, the Screen panel, the model picker, Apps or a chat, and whether the provider accepted it); signing in to an engine; connecting an app.
  • Saving or removing a secret or a saved login, and where it was saved from (Settings or a chat card). A bot using one, and a bot asking for a secret.

Bots and group chats

  • Creating a bot (blank, a starting role from Brainwrite's list, or a preset); starting a call or a group call; creating a group chat and changing its members (counts only); importing or scouting a team (counts only).

Brainwrite Cloud

  • The Cloud card and dialog: shown, the choice made, checkout opened (which plan and whether it had the trial), the steps of signing in, the welcome on a new Cloud.
  • Buying another Cloud, for someone who has one: the plan chosen, the checkout opened, and the new Cloud ready.
  • The What's new window shown once after an update: that it was shown, moving between its slides, and what you chose (see Brainwrite Cloud, get a plan, start a Team, not now or close), with the slide, whether you already have a plan and whether you were signed in.

Cloud computers

  • A bot's or team's cloud computer starting and stopping: why (a bot's work, you, being idle, being deleted), whose it is (a bot or a team), whether it comes with your Cloud plan, and how many minutes it was on.
  • For computers that come with a Cloud plan, Brainwrite Cloud also sends, once a day, the computer hours billed the day before and how many computers the account has, and each computer it stops because the month's hours are used or the plan ended. These carry your email but no IP address.

How long

The account service keeps events only until LogZuno has them (at most seven days if LogZuno cannot be reached), and the daily totals behind its counts for 90 days.

On this page