Skip to content
DocsSharing and the leaderboard

Using it

Sharing and the leaderboard

Share links, publishing to the leaderboard, arenas, profiles, referrals and signing in with a Matrix OS account.

On this page

Everything on this page is optional and starts with something you do. The package never publishes anything: sharing happens on the website, and only after you open a link you made and press a button.

In the Publish section of your report, right after your cards and the short summary (the Publish to the leaderboard button next to your cards takes you there), the “Share your stats and cards, join the leaderboard” box builds a link to a card page on ai-insights.app. You can type a display name (optional, up to 40 characters) and a name for this computer, such as “Work laptop” (optional, up to 32 characters). The box lists every line the link contains before you copy it.

  • The data lives in the link. It travels in the URL fragment, the part after # in https://ai-insights.app/share/#…. Browsers do not send the fragment to the site, so opening the link uploads nothing.
  • It holds only aggregate numbers and fixed wording: your totals, earned titles and ratios as numbers, and your recap cards as short lines. The exact list is in What a share link contains.
  • Buttons: Publish to the leaderboard (opens the link), Copy link, and X or LinkedIn posts with the link.

Anyone you send the link to sees your card page. Links made by earlier versions, without cards or without a device, still open and still publish.

Publish to the leaderboard

  1. Open your share link and press Sign in to publish. Sign-in uses a Matrix OS account (see Your account).
  2. Pick a public handle: 3 to 30 characters, lowercase letters, digits and single hyphens, starting and ending with a letter or digit. Some handles are reserved, such as admin, docs or leaderboard.
  3. Choose whether to show your Matrix account photo. It is off by default; without it your profile shows your initials. You can turn it on or off later without publishing again: use Show my photo on the leaderboard or in Your devices on your profile.
  4. Check the preview. It lists exactly what becomes public: name, photo choice, profile address, period, sessions, tokens, estimated spend, active days, longest streak, agents, fun fact, each title with its rule, your ratios and each card.
  5. Press Publish.

Publishing again from the same computer replaces that computer's numbers and cards; publishing from another computer adds it (see Several computers). To publish newer numbers, run npx ai-insights@latest, make a new share link from the new report, open it and publish.

Arenas and ranks

The leaderboard at ai-insights.app/leaderboard is one table: rank, person, tokens, estimated spend, Claude Code and Codex tokens, longest streak, active days, sessions, devices and period. Click a column header to sort by it; the sort is part of the address (for example /leaderboard?sort=codex), so a sorted view can be shared. The five arenas below are quick presets above the table. Rank is computed for the column you sort by, and you rank there only with a value above zero; people without one are listed after everyone ranked, with no rank. On a phone each row shows the sorted number with its bar, and the other numbers on a second line.

Arenas
ArenaRanked by
Most tokensTotal tokens.
Most spentEstimated spend at API list prices.
Top Claude Code userYour tokens times Claude Code's share of your sessions.
Top Codex userYour tokens times Codex's share of your sessions.
Longest streakLongest run of active days in a row.

Older links that use ?arena= still open the same arena. The per-agent arenas are estimates: the payload has no per-agent token split, so each agent's tokens are approximated from its share of sessions. Ties share a rank. On boards with fewer than 20 entries a rank reads “#3 of 12”; on larger boards it reads as a top percentage, such as “Top 4%”.

Profiles

Publishing gives you a profile at ai-insights.app/u/<handle> with your numbers, your recap cards, your earned titles and ratios, and a badge for each arena you rank in: “#3 Most tokens” inside the top ten, “Top 4% in Codex” below it. Profiles have their own link preview image.

Your profile shows visitors how many people you brought to AI Insights. Only you, signed in, see the list of who they are.

Several computers

If you use coding agents on more than one machine, run AI Insights on each and publish from each report while signed in to the same account. Your handle, display name, photo choice and referral credit belong to the account; the numbers belong to each computer.

  • How computers are told apart. Each installation makes a random id once and keeps it in ~/.ai-insights/device.json. The share link carries it. It is never made from the computer's name, your username or any hardware detail, and it grants nothing by itself (see The device id).
  • Republishing from a computer replaces only that computer's numbers. A new computer is added. An account holds at most 10 computers.
  • Names. A computer's name is public only if you tick “Show this computer's name” when you publish, or later on your profile. Otherwise visitors see “Device 1”, “Device 2” in the order you first published.
  • Your first publish from 0.5. An entry published by an older report has no device. When you publish from 0.5 on a computer you used before, the panel asks whether this is the same computer, so the earlier entry is replaced instead of counted twice.

Your profile leads with the combined numbers, and the leaderboard ranks them, with a small “n devices” marker:

How computers are combined
NumberCombined as
Sessions, tokens, estimated spendAdded up. Spend adds the computers that had a price.
PeriodEarliest first day to latest last day.
Active days, longest streakRecomputed from the days each computer was active, so a day used on two computers counts once. If a computer did not send its active days, these are lower bounds and the profile says “at least”.
AgentsEach agent's share, weighted by each computer's sessions. Agent arenas add each computer's own estimate.
Ratios and earned titlesRecombined from the counts behind each ratio, then titles are earned again with the same rules. A ratio from an older report without its count is shown only on that computer. Sessions at once is a lower bound, since two computers can run at the same time.
Recap cards“All devices” shows each card once, from the busiest computer that has it, labelled with that computer; tokens and the streak are rebuilt from the totals. Pick a computer to see its own cards and ratios.

On your profile, signed in, Your devices lists each computer with its last publish and its own numbers. You can rename a computer, choose whether its name is public, remove it (its numbers leave the total), or remove everything.

Referrals

  • Links the site makes to a published person's profile carry ?ref=<handle>. Arriving at a profile from outside the site counts too; a click inside the site, such as down the leaderboard, does not.
  • The site remembers that handle in a first-party, HttpOnly cookie on ai-insights.app for 30 days. The first referrer wins; a later link does not replace it.
  • If you later publish for the first time, that person is credited once. Never yourself, and never a handle that has not published. The handle is also recorded in your Matrix account's metadata.
  • The site's analytics only ever learn that a link had a referrer, never whose.

Your account

Sign-in on ai-insights.app uses your Matrix OS account: the site runs as a satellite of the Matrix OS sign-in, so you sign in on the Matrix OS sign-in page and are sent back. If you are already signed in to Matrix OS in the same browser, the site recognises you on your first visit, or as soon as you press Sign in. Sign-in always loads on the sign-in page. Everywhere else, including the share, leaderboard and profile pages, it loads only in a browser that has signed in here before, to show your account menu, your standing and the Publish form; a visitor who has not signed in loads nothing from the sign-in provider.

Once you are signed in, the account menu in the header has:

  • My profile, or how to publish if you have not yet;
  • Leaderboard;
  • People I referred;
  • Open Matrix OS;
  • managing your account, and signing out.

When you are signed in on a share page, the site notes once in your Matrix account's metadata when you first used AI Insights.

Remove your entry

Press Remove everything in Your devices on your profile (visible only to you, signed in). It deletes your leaderboard entry and every computer's numbers and cards, so your profile and ranks go with it. Remove my entry in the publish panel on any share link does the same. To remove one computer only, press Remove device next to it there; the last one cannot be removed that way. To hide your photo, turn off Show my photo; publishing with the photo box unticked also removes it.

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