Skip to content
DocsPrivacy

Reference

Privacy

What stays on your machine, exactly what a share link and a published profile contain, the website's analytics, and how to remove an entry.

On this page

Local only

  • No network calls. The package reads files and writes files. It has no telemetry, no account and no model API client.
  • Files only you can read. Everything it writes goes to ~/.ai-insights/, with folders and files readable by you only.
  • A report that cannot phone home. The report is one HTML file whose Content-Security-Policy, default-src 'none', stops it loading or sending anything.
  • Links you click. The report links to Matrix OS, to the docs for tools it suggests, and to X and LinkedIn when you press a share button. Nothing else in it points off your machine.
  • Your agent does the judging. The optional agent review runs in the agent you already use, under your existing account and settings. See What your agent sees.

Nothing leaves your machine unless you create a share link and open or send it, or publish from the website. Both are described below.

Installing into your agents

ai-insights install, and the offer at the end of a run, set up the plugin by running Claude Code's and Codex's own plugin commands. Those commands download the plugin from GitHub, the same as if you typed them. AI Insights itself still sends nothing: it starts the agent's command, and only after showing it to you and getting a yes (or --yes). It never edits an agent's config file itself. Once installed, your agent starts the MCP server with npx, which asks the npm registry for the current version.

The monthly reminder runs offline inside the plugin and reads only the date of your last report and its own nudge.json. See The monthly reminder.

Redaction

Before a prompt, a command or an excerpt is stored or shown, AI Insights replaces:

  • API keys and tokens in common formats (for example OpenAI and Anthropic style keys, GitHub and Slack tokens, AWS access key ids, JWTs);
  • private key blocks;
  • Bearer and Basic credentials;
  • assignments to names containing TOKEN, SECRET, PASSWORD, API_KEY, PRIVATE_KEY or ACCESS_KEY, such as PASSWORD=…;
  • email addresses.

It also shortens home-folder paths to ~ where it shows them to your agent, so your username does not travel into its context.

A share link exists only when you make one in the report, and the report shows every line it carries before you copy it. It travels in the URL fragment (after #), which browsers do not send to the website. It holds no project names, paths, prompts or commands.

Share link contents
FieldWhat it is
NameAn optional display name you type, up to 40 characters. Without one the card says “Someone”.
PeriodThe first and last day of your history.
TotalsSessions, tokens, estimated spend, active days and longest streak. Imported chats count as sessions but add no tokens or spend: from chats alone, the site shows tokens and spend as not measured and the entry does not rank in the token, spend or agent arenas.
AgentsEach coding agent's share of your sessions, as a percentage. Imported chats are left out, because the site estimates each agent's tokens from this share.
Fun factOne line built from counts, such as how many agents you ran at once.
TitlesUp to three earned title keys, each with the number of the ratio that earned it. The site rebuilds the wording from a fixed table.
RatiosThe five work ratios as numbers, each with the count it is out of (sessions, tool calls or clock hours), so computers can be combined.
DeviceThis installation's random device id and an optional name you type for the computer. See The device id below.
Active daysUnless you untick it: which dates had activity, as a compact bitmap. Dates only, no counts or times. It lets the site combine active days and streaks across computers.
CardsUp to 16 recap cards, each as a fixed card key, a short headline and a caption. See below.

Each card's two lines are built from counts, dates, agent names, checked public model-family names and fixed wording. Cards whose report version shows your words, slash command names, program names or tips publish a count instead, or are left out. If the link would be too long, cards are dropped from the end of this list.

Card lines in a share link
CardWhat its lines hold
PersonaYour persona title from the fixed set, and your sessions and days.
Most agents at onceThe most sessions at once, and the number of subagents.
Tokens processedTotal tokens, and the estimated cost or the number of model requests.
Longest streakDays in a row, with the start and end dates.
Longest sessionActive hours of your longest session, and its agent's name.
When they promptNight owl, early bird or a daytime label, and your busiest hour.
Manners checkCounts of please, thank-you and sorry, and your prompt count.
Danger zoneCounts of rm -rf, force pushes and sleep commands.
Time with agentsClock hours and agent-hours.
Top modelYour top model's public family name and its share of requests. Left out unless the name matches a known public family.
Favourite dayA weekday name and its prompt count.
Test runsTest runs and the share that passed.
Bash hall of fameA count of shell commands. Program names are not published.
Where things brokeFailed tool calls and the failure rate.
Words typedWords typed and the share of prompts that were questions. Your words themselves are not published.
Slash commandsA count of slash commands. Their names are not published.
Deep thoughtsThinking blocks and the longest one.
Rubber stampActions approved automatically and by hand.
History keptDays of history kept, and sessions saved from deletion.

What publishing makes public

Publishing stores the same validated payload as the share link, nothing more, under a public handle you choose. The publish panel shows every line before you press Publish. Your profile at ai-insights.app/u/<handle> and the leaderboard then show:

  • your display name and handle, and the date you first published;
  • your combined numbers, and each computer's own numbers and cards, labelled “Device 1”, “Device 2” unless you chose to show a computer's name. Device ids and the active-days bitmap are stored but never shown or sent to visitors;
  • everything in the table above: period, totals, agents, fun fact, titles, ratios and cards;
  • your ranks and badges, computed from those numbers;
  • how many people you referred (the list of who is shown only to you);
  • your Matrix account photo, only if you ticked that box when you published or turned on Show my photo later. It is off by default. The site reads it from your Matrix account on its server, never from your browser, and accepts only photos you uploaded, hosted by the sign-in provider.

Leaderboard numbers are self-reported and not verified. More about the flow is in Publish to the leaderboard.

The device id

From 0.5, AI Insights makes a random id the first time it runs (16 random bytes) and keeps it in ~/.ai-insights/device.json. It is not made from your computer's name, your username, a network address or any hardware detail. It sits in the report's share link so that publishing again from the same computer replaces that computer's numbers instead of adding a new one.

  • It is not a secret and grants nothing: every change happens only in the signed-in account, and an id from another account is ignored.
  • It does link the share links one installation makes to each other. Delete device.json to get a new one.
  • Visitors never see it; your profile shows “Device 1” or the name you chose to show.

Imported chat exports

A chat export you import with ai-insights import claude is read on your machine, and what is kept from it goes to ~/.ai-insights/imports/ like the rest of the cache. AI Insights keeps the same things it keeps from a coding agent: counts, times, Claude's own tool names and your own prompts, redacted. It never reads Claude's answers, its thinking text, tool inputs or results, attachments, file names, chat titles or summaries, and it never opens the export's account, project or memory files. The zip is read in memory and nothing in it is unpacked to disk. ai-insights import --remove claude deletes all of it. Details are in What is read and kept.

The website's analytics

ai-insights.app, and only the website (not the package and not the report), uses first-party PostHog analytics. Events go through ai-insights.app itself to PostHog's EU hosts.

  • It records page views, page leaves and a few named clicks: viewing a share card, copying the install command, pressing Publish, completing a publish, and which leaderboard arena was viewed.
  • It never sends a share link's #fragment, and reduces ?ref=<handle> to a bare ref, so analytics learn that a link had a referrer, never whose.
  • It records no sessions, captures no typed text, has autocapture off, and honours Do Not Track.

The sign-in scripts always load on the sign-in page. On every other page they load only in a browser that has signed in here before, to show your account menu, your standing and the Publish form; anyone else loads nothing from the sign-in provider.

To recognise someone already signed in to Matrix OS, the share, leaderboard and profile pages check with the Matrix OS sign-in on a browser's first visit. After that check a signed-out browser keeps a first-party, HttpOnly cookie, aii_auth_checked, for one day, so the next visits skip it. It holds only the value 1: no identifier. The sign-in provider sets its own cookies on ai-insights.app, and the referral cookie is described under Referrals.

Removing what you published

  • Remove my entry in the publish panel on any share page, while signed in, deletes your leaderboard entry and with it your profile, including every computer's numbers. Remove everything in Your devices on your profile does the same.
  • Remove device in Your devices on your profile removes one computer's numbers and cards; your totals are recomputed without it.
  • Turning off Show my photo (on the leaderboard or your profile) removes your photo at once; so does publishing again with the photo box unticked.
  • A share link is not stored anywhere by the site. To stop it working as a profile you published, remove your entry; the link itself keeps the numbers it was made with.
  • On your machine, delete ~/.ai-insights/ to remove everything AI Insights wrote.

Something wrong or missing? Edit this page on GitHub or open an issue.