# Usage analytics MausBot can send anonymous product analytics to PostHog (US cloud, `us.i.posthog.com`), so its maintainers can see which features people set up and use. This page lists every event and every property the app can send. Nothing else is sent. ## What it is - `posthog-js` loads only while the switch is on. With the switch off, the library is never downloaded and nothing is sent. - Autocapture, pageviews, surveys and feature flags are off. Events come only from the calls listed on this page, and switching analytics back on sends no event of its own. - Every event carries `app_version` (for example `0.1.112`), `surface`: `local` for the desktop app's own window, `server` for a page a server serves (MausBot Cloud, a self-hosted server, or the app in a browser), and `platform`: `desktop` for a page the desktop app shows, `browser` for a page a browser shows. - PostHog adds its standard device facts to every event: operating system, browser and its version, device type, screen and window size, language and time zone. Like any server, PostHog sees the IP address a request comes from. - Events are tied to a random id that PostHog keeps in the page's storage. Nothing ties them to you: the app never sends your email or your name with them. ## Turning it off **Settings → General → Usage analytics.** When it is off, nothing loads and nothing is sent: no events, no daily snapshot, none of the snapshot's requests, and none of the desktop app's launch events. The desktop app keeps the switch for this computer's page itself, so it holds whichever port the app serves that page on (it moves to another when its usual one is taken). It is read before anything loads, and before any email is tied to your events. A switch turned off only in the page's storage, before the app kept it, does not hold on another port until the app serves its page on that port again, which moves it to the app; while the app has kept no choice yet, its page on a port other than its first ties no email to your events. Each server page (your MausBot Cloud, a self-hosted server, each browser you use) keeps its own switch in that page's storage. With the switch off in the desktop app, a server page that the app's window shows, My Cloud's included, starts with it off too once that server runs this version; turning it on there lasts until that page reloads. In a browser, switch it off on each server's page. ## Never sent - API keys, tokens or passwords, or anything derived from them: no length, prefix, hash or last characters. - Names of bots, rooms, teams, people, routines, files, devices, models, presets or accounts. - Emails. - URLs, hosts and addresses. PostHog's own `$current_url`, `$host`, `$pathname`, `$referrer`, `$referring_domain`, campaign parameters (`utm_*`, `gclid` and the like) and their `$initial_*` and `$session_entry_*` copies are removed before an event leaves the app. - File paths, and ids of any kind: bot, room, conversation, instance, account or computer. (An `announcement` event names the card, by the id the public announcements file gives it, never anything of yours.) - Instructions, prompts, message content, model output and error messages. ## Allowed values Properties are counts, `true` or `false`, or words from fixed lists in the app's code (`src/lib/analytics-allowlist.ts`). A value that is not on its list is sent as `other`. | List | Values | | --- | --- | | Key provider | `anthropic`, `openai`, `openrouter`, `openai_compat`, `xai`, `mistral`, `cerebras`, `groq`, `greenference`, `modelgo`, `meta`, `boat`, `composio`, `opencode_go`, `custom_endpoint`, `elevenlabs`, `fish_audio`, `jev`, `openrouter_decider`, `openai_image`, `custom_image`, `openai_live`, `onepassword`, `treg`, `postiz` | | Engine | `claude`, `codex`, `gemini`, `cursor`, `opencode`, `qwen`, `hermes`, `cline`, `custom_acp`, `pi`, `openai_compat`, `grok`, `grok_api`, `kimi`, `droid`, `antigravity`, `minimax`, `mistral`, `cerebras`, `groq`, `greenference`, `modelgo`, `meta`, `muse_code`, `deepseek`, `copilot`, `command_code`, `kiro`, `devin`, `omp`, `mistral_vibe` | | App | The 24 apps Connected apps lists by default: `slack`, `github`, `gmail`, `googlecalendar`, `googlesheets`, `googledocs`, `googledrive`, `notion`, `linear`, `sentry`, `posthog`, `discord`, `twitter`, `reddit`, `zapier`, `hubspot`, `salesforce`, `jira`, `asana`, `trello`, `dropbox`, `airtable`, `figma`, `stripe`. Every other app is `other`. | | Starting role | `assistant`, `inbox`, `research`, `coder`, `community`, `ops` | | Cloud plan | `starter`, `personal`, `pro`, `max` | | Test failure | `signed_out`, `timeout`, `empty` (it answered with nothing), `credits`, `usage_limit`, `rate_limit`, `overloaded`, `server`, `tool_schema`, `tool_count`, `model_no_route`, `refused`, `other` | An engine is named by the kind of engine it is, never by the account or endpoint it runs on: two Claude accounts both report `claude`. A page that may not list the engines (a member's, a Cloud guest's or a paired device's) names the engines the app ships with, and any engine account added later as `other`. ## The daily snapshot `app_snapshot` is one count of what is set up, sent at most once a day. It answers questions such as how many people use their own Boat key, and how many bots run on cloud computers, without sending what anything is called. - Only the owner or an admin sends it. A member, a device paired without admin access and a Cloud guest never do. - The app checks once it has loaded, then every hour, and sends at most once per UTC day for each app page. - It counts what the app has already loaded. It also asks, once: this server for its signed-in devices (counted, never listed) and its connected-app inventory; on the desktop app, the app itself for the number of paired phones and the Cloud plan; and, when a Boat account is set, this server for the number of cloud computers. To answer that, the server lists the computers once at boat.dev with your Boat key, or at MausBot Cloud's relay for computers included with a plan. That listing only reads: it never changes a computer. - When a source fails, its properties are left out and the rest is sent. | Property | Type | Meaning | | --- | --- | --- | | `key_providers` | list of key providers | Providers with your own key saved: the model providers and an OpenAI-compatible key when set; `boat` for your own Boat key (not one included with a plan); `composio` for a self-hosted Composio project; `opencode_go`; `elevenlabs` or `fish_audio` for your own voice key; `jev` or `openrouter_decider` for your own decision-model key; `openai_image` or `custom_image` for your own avatar-image key (an xAI key counts once, as `xai`); `openai_live` for a separate Live call key | | `key_count` | count | How many entries `key_providers` has | | `has_boat_key` | true/false | Your own Boat key is saved | | `cloud_computer_source` | `own_key`, `included`, `none` | Where cloud computers come from: your own Boat key (it wins when both exist), a Cloud plan, or nowhere | | `cloud_computers` | count | Cloud computers this install manages for bots and team computers; `0` without a Boat account; left out while the Boat account is changing or when the provider could not be read | | `team_computers` | count | Team computers | | `bots` | count | Bots, not counting archived ones (no bot count below includes them) | | `bots_cloud_boat`, `bots_cloud_vps` | count | Bots set to work on a cloud computer, on Boat or on your VPS | | `bots_local_vm`, `bots_this_computer`, `bots_browser`, `bots_off`, `bots_auto` | count | Bots set to work on a Local VM, on this computer, in the browser only, nowhere, or left on Auto | | `rooms` | count | Rooms | | `bot_channels` | count | Channels bots opened with each other | | `teams` | count | Teams | | `routines`, `routines_enabled` | count | Routines, and how many are on; left out while routines are not loaded | | `routines_cloud`, `routines_room_goal` | count | Routines that run on a cloud computer, and routines that pursue a room goal | | `routines_once`, `routines_daily`, `routines_interval`, `routines_cron` | count | Routines by schedule type | | `webhooks` | count | Webhook triggers; left out where webhooks are not loaded (the desktop app as a remote client) | | `engines` | list of engines | Engines that are ready to use, each named once | | `engine_count` | count | Ready engine accounts and endpoints | | `custom_endpoints` | count | OpenAI-compatible servers you added | | `trial_credit` | `active`, `used_up`, `ended`, `none` | The Cloud trial's Claude credit | | `apps` | list of apps | Connected apps with a working account; left out when the inventory could not be read | | `apps_connected` | count | Connected apps with a working account | | `connectors_mode` | `managed`, `self_hosted`, `unavailable` | How connected apps are provided | | `local_vm_mode` | `shared`, `per_bot`, `pool` | Local VM isolation | | `vps_configured` | true/false | A VPS is set up | | `voice` | `elevenlabs`, `fish`, `system`, `chatterbox`, `xai`, `none` | The voice provider in use | | `voice_included` | true/false | The voice comes with a Cloud plan | | `decider` | `jev`, `openrouter`, `off` | The decision model | | `decider_included` | true/false | The decision model comes with a Cloud plan | | `live_calls` | true/false | Live calls are set up | | `phones_paired` | count | Phones paired with the desktop app (desktop app only) | | `paired_devices` | count | Devices signed in to this server without an email, other than this one | | `phone_paired` | true/false | Either count above is more than zero | | `members` | count | People signed in to this server with an email, other than you | | `cloud_home` | true/false | This server is a MausBot Cloud | | `cloud_plan` | `starter`, `personal`, `pro`, `max`, `other`, `none`, `unknown` | The Cloud plan: `none` when free or signed out. While the desktop app's sign-in cannot be checked (offline, expired, signing in again), the plan it last checked, else `none`. `unknown` when the app cannot tell; the snapshot waits up to half a minute while the desktop app is still reading its saved sign-in. Left out on a page that has no way to ask: a server that is not your MausBot Cloud, or the desktop app connected to another server | | `cloud_trial` | true/false | A Cloud trial is running | | `edition` | `oss`, `enterprise` | The edition | | `org_managed` | true/false | An organisation manages this desktop | | `onboarded` | true/false | The first-run tour was finished | | `first_turn` | true/false | A bot has answered at least once | | `platform` | `desktop`, `browser` | The desktop app or a browser | | `remote_client` | true/false | The desktop app is connected to another server | ## Events | Event | When it is sent | Properties | | --- | --- | --- | | `app_first_open` | The first time this app page starts with analytics on | `platform`: `desktop`, `browser` | | `app_opened` | Each time this app page starts with analytics on | `platform`: `desktop`, `browser` | | `app_active` | Once a day you use the app: when this app page starts, comes into view or is focused, or when a check every ten minutes finds a new day while the page is in view and focused. At most once per day by your computer's date for each app page, and never while the page is hidden | `platform`: `desktop`, `browser`; `mode`: `simple`, `advanced`, the look this app page is in when it counts the day | | `onboarding_step` | A first-run screen is shown | `step`: `meet`, `chief`; `replay`: true/false | | `connect_ai` | Connecting an AI takes a step in a first-run flow: the first screen, its Connect an AI dialog, the one MausBot's chat opens, the one on the clean workspace's line, or a new Cloud's welcome. Never from Settings | `step`: `opened` (the flow asked for an AI, or found one already working), `dialog_opened` (the Connect an AI dialog opened), `chosen` (you picked an AI: its button, its setup or its row), `sign_in_started` (a sign-in to it began), `test_started`, `test_ok`, `test_failed` (the tiny test message through it), `later` (Set up later on the first screen, Skip on a Cloud's welcome); `place`: `meet`, `chat`, `home_line`, `cloud_welcome`; `engine`: engine, when one is named; `ai_ready`: true/false, with `opened`; `reason`: why the test failed, a test failure word, with `test_failed`, and with `opened` when the AI found had failed its last test; `seconds`: how long the test took, with `test_ok` and `test_failed` | | `app_load` | This app page has its server, its data and its settings, or still waits for one of them half a minute after it started, or shows its error screen. Once per page start | `stage`: `ready`, `slow`, `error`; `seconds`: since the page started, with `ready`; `onboarded`: true/false, the first-run tour was finished, with `ready`; `waiting`: `server`, `data`, `settings`, with `slow` | | `sign_in_gate` | The desktop app's own page opens on its sign-in page instead of the app | `reason`: `signed_out`, `session_ended`, `team_left`, `service_trust` | | `onboarding_completed` | The first run ends in the chat | `reason`: `completed`; `at`: the screen it ended on; `replay`: true/false | | `setup_import_applied` | You bring in the skills and MCP servers found from other AI tools on this computer, in Settings → Import & export | `skills`, `tools`: how many were added. Never their names or where they came from | | `onboarding_cloud` | You tap Try Cloud under MausBot's first messages, which opens Add a Cloud | `action`: `start_trial` | | `message_sent` | You send a message | To a bot: `driver`: engine; `queued`: true/false. To a room: `room`: true; `mode`: `chat`, `goal`; `queued`: true/false | | `call_started` | You start a call with a bot | `driver`: engine; `mode`: `turns`, `live` | | `group_call_started` | You start a call with a room | `memberCount`: count | | `room_created` | You create a room | `members`: count; `context`: true/false (it was put in a team) | | `room_members_changed` | You change who is in a room | `members`, `added`, `removed`: counts | | `team_imported` | You import a team | `members`: count; `source`: `library`, `file`, `github`, `organization`, `scout`; `mode`: `add`, `project`; `format`: `team`, `package`, `backup` | | `bot_created` | You create a bot with New bot, or from a ready-made bot in Templates | `source`: `blank` (New bot), `template` (a starting role), `preset`; `template`: starting role, only when `source` is `template` | | `api_key_saved` | You save a key in Settings → API keys, in the Screen panel, in the model picker, on the X card in Apps, from a bot's request in a chat, or by adding an OpenAI-compatible server | `provider`: key provider; `via`: `settings`, `computer_panel`, `model_picker`, `apps`, `chat_request`; `result`: `ok` (the provider accepted it), `rejected` (the provider refused it), `unverified` (saved, not checked), `error` (not saved) | | `api_key_removed` | You clear a key of your own in Settings → API keys, the Screen panel, the model picker or the X card in Apps | `provider`: key provider; `via`: `settings`, `computer_panel`, `model_picker`, `apps` | | `engine_signed_in` | You finish signing in to an engine inside the app | `engine`: `claude`, `codex`, `grok`, `kimi`; `method`: `code`, `device_code`, `browser` | | `connector_connect` | A Connect you started in Connected apps ends | `app`: app; `result`: `connected` (the account it added works), `failed` or `expired` (that account failed or expired), `timed_out` (neither within two minutes) | | `app_snapshot` | Once a day, as described above | The properties in the snapshot table | | `cloud_card_shown` | The MausBot Cloud card is shown | `variant`: `signed_out`, `free` | | `cloud_card_action` | You act on the MausBot Cloud card | `action`: `start`, `howto`, `signin`, `not_now`, `close` | | `whats_new` | The What's new popups (each once per person after an update, and again from Announcements): the earlier one on this computer's page, a slide comes on screen, counted once per slide each time the popup is up, or you act on it; the Teams one on every page, it comes on screen or you act on it | `action`: `seen`, `next`, `back` (the slide changed, by its buttons, its dots or the arrow keys), `get_pro` (Get Pro, which opens Add a Cloud), `see_cloud` (See the new Cloud, which opens the Cloud website), `start_team` (Start a Team, which opens the Team plan's checkout on the Cloud website, or Add a Cloud for someone with a plan of their own), `invite` (Invite your team, which opens the team's People page on MausBot Cloud), `see_team_plans` (See Team plans, which opens the website's Team plans), `got_it`, `not_now`, `close` (the X, Escape or a click outside); `slide`: the slide it happened on: `pro` (the new MausBot Cloud), `team` (Team), `teams` (the Teams popup); `audience`: `no_plan` (both slides), `own_plan` (a Cloud plan of one's own: the Team slide only), and for the Teams popup `team_admin` (a Team Cloud's Owner or Admin), `team_member` (a Team Cloud's member, or a desktop signed in to a team), `no_team` (everyone else); `signed_in`: true/false, signed in to MausBot Cloud in the app (the earlier popup only); `campaign`: the popup's campaign, `whats-new-2026-11` or `teams-2026-11b` | | `cloud_howto` | The "Show me how" tip ends | `result`: `no_button`, `skipped`, `closed` | | `cloud_dialog_shown` | The Add a Cloud dialog opens | `source`: `app_card`, `app_howto`, `app_menu`, `app_settings`, `app_routines`, `app_whats_new_pro` (Get Pro in the What's new popup), `app_whats_new_team` (Start a Team in it or in the Teams popup, for someone with a plan of their own), `app_onboarding` (Try Cloud under MausBot's first messages); `view`: the dialog's first screen | | `cloud_dialog_view` | The Add a Cloud dialog reaches a step | `view`: `received`, `starting`, `ready` | | `cloud_signin` | Signing in to MausBot Cloud inside the Add a Cloud dialog takes a step | `step`: `code_sent` (a sign-in code was emailed), `signed_in`, `browser` (Continue in browser); `source`: as for `cloud_dialog_shown` | | `cloud_checkout_opened` | A Cloud checkout opens in the browser, from the Add a Cloud dialog or, where the app has none (a browser page, or a desktop showing another computer), straight from the button that asks for it | `plan`: Cloud plan (for `via` `web`, the plan its link asks for: `pro`, or `team` for Start a Team); `trial`: true/false, from the dialog only; `source`: as for `cloud_dialog_shown`; `via`: only without the dialog: `web` (the plan's checkout on the Cloud website opened in a new tab), `cloud_page` (on a Cloud, or for Sign in, the Cloud website's own page for the account opened instead) | | `cloud_add_another` | Buying another Cloud, for someone who has one, takes a step | `step`: `plan` (a plan chosen), `checkout_opened`, `ready`; `plan`: Cloud plan, for `plan` and `checkout_opened` | | `rail_place_opened` | You open a place from the rail of Clouds at the window's left edge | `kind`: `computer`, `cloud`, `team`, `server` | | `rail_add` | You use the rail's + | `step`: `opened` (its sheet opened), `cloud` (Buy a Cloud, on this computer's own sheet), `link` (Connect to a server), `address` (Enter its address instead), `organization` (a new organization added on the Team plan) | | `cloud_setup_started` | A new Cloud starts its first job | none | | `cloud_intent_submitted` | You tell a new Cloud what to do first | `idea`: `digest`, `watch`, `research`, `plan`, or none for your own words; `edited`: true/false | | `cloud_intent_skipped` | You skip that question | none | | `cloud_welcome_step` | A step of a new Cloud's welcome is shown | `step`: `bring`, `engine`, `files`, `done` | | `cloud_welcome_ended` | A new Cloud's welcome ends | `reason`: `done`, `skipped`; `at`: the step it ended on | | `product_hunt_card` | You act on the Product Hunt card | `action`: `upvote`, `not_now`, `close` | | `boat_offer` | Boat's credit offer: its one-time card is shown or you act on it, or you act on it on the Boat card in Settings → API keys | `action`: `shown` (the card only), `get_boat`, `claim` (the drafted email to Boat opened), `not_now`, `close`; `place`: `card`, `settings` | | `modelgo_offer` | ModelGo, a sponsor: its one-time popup or its first-run option is shown, or you act on the popup, the first-run option or the ModelGo row in Settings → API keys | `action`: `shown` (the popup and the first-run option), `get_key` (ModelGo's site opened), `add_key` (Settings: a key was saved there; first run: you opened the ModelGo row to add one; never the popup), `not_now`, `close` (the popup only); `place`: `popup`, `onboarding`, `settings` | | `announcement` | A card from the project's public announcements file (sponsor offers, product news, tips; [Announcements](https://github.com/milind-soni/OpenMausBot/blob/main/docs/announcements.md)) is shown, or you act on it | `id`: the card's own id from that file, the same for everyone who sees the card; `kind`: `sponsor`, `product`, `tip`; `action`: `shown`, `primary` (its main button), `secondary` (its second button), `close` (Not now, the X or Escape) | | `simple_mode_prompt` | The Simple mode popup, shown once in each browser after an update when nothing else is on screen, is shown, its Simple mode switch is flipped, or it is closed (Done, the X, Escape or a click outside) | `action`: `shown`, `toggled`, `closed`; `mode`: `simple`, `advanced`, the mode it was shown or closed in, or the one a flip turned on | | `new_look_notice` | The notice that Simple is now the only look, shown once in each browser that was on Advanced mode, when nothing else is on screen, is shown or closed (Done, the X, Escape or a click outside) | `action`: `shown`, `closed` | | `advanced_back_notice` | The notice that Advanced mode is back, shown once in each browser that was on Advanced mode before Simple became the only look and is put back on it, when nothing else is on screen, is shown or closed (Done, the X, Escape or a click outside) | `action`: `shown`, `closed` | | `grok_move_popup` | The one-time Move from Grok Bot popup is shown or you act on it | `action`: `shown`, `start`, `not_now`, `close` | | `two_places_card` | You act on the card that says your bots live in two places (this computer and a server of your own, or My Cloud) | `action`: `bring`, `not_now`; `kind`: `server`, `cloud`, the place it offered | `api_key_saved` reports `ok` for a key the server checks with its provider before saving it (Boat, Composio, ElevenLabs, Fish Audio), and for a model provider key whose test passed right after saving. A key nothing checks before it is used (OpenCode, OpenAI images, an added OpenAI-compatible server, an xAI key from a chat request) reports `unverified`. ## The desktop app's launch The desktop app itself (not its page) sends one `desktop_launch` event for each stage a launch reaches, so launches that never get as far as a page are counted too. Its first stage on a computer that never ran the app is the install count. - It follows the same switch. With the switch off, it sends nothing. While no choice has been made, it sends on the computer's first launch, and on a later launch only when the launch before ran a version whose page keeps a switch turned off in the page's own storage (0.1.113 or later), so that switch holds here too. - Each launch makes a random id that is kept nowhere and used for nothing else: it ties one launch's stages together, never two launches, never a page's events, never you. PostHog keeps no person for it. - Only the packaged app sends, never a development build. | Stage | When | Properties besides `stage` | | --- | --- | --- | | `started` | The app starts | `hidden`: true/false, started at login out of sight | | `server_spawned` | The app's own server process started | | | `server_ready` | That server answers | `reason`: `relay`, the desktop app connected to another server | | `server_failed` | The server did not answer on any port | `reason`: `timeout`, `exited`, `foreign-owner` (another program answers on the port), `stuck-child` | | `window_shown` | The window replaced the loading screen | `reason`: `painted` (the app drew its first screen), `crashed`, `timeout` (ten seconds passed first), `shown`, `hidden` (the loading screen was put away in the tray, so the window stays out of sight) | | `page_load_failed` | The window could not load the app's own page | | | `page_crashed` | The window's page crashed | `reason`: `crashed`, `oom`, `killed`, `abnormal-exit`, `launch-failed`, `integrity-failure` | Every stage also carries `ms` (milliseconds since the app started), `first_launch` (true/false), `updated` (true/false, the first launch of a new version), `app_version`, `platform`: `desktop`, `surface`: `main`, and the operating system.