# usage.fyi

> usage.fyi turns your Claude Code (and other AI coding tool) token usage into a
> shareable card. One command mints an immutable, unlisted https://usage.fyi/s/:id link
> that unfurls into a rich preview anywhere you paste it — Slack, Discord, X,
> iMessage. No account, anonymous by default.

## What it is

usage.fyi is the presentation and sharing layer for AI coding usage stats. The
numbers come from [ccusage](https://www.npmjs.com/package/ccusage), which reads
your local Claude Code usage logs. usage.fyi takes those numbers, renders them
as a card, and gives you a permanent link to share. It never sees your prompts
or your code.

## How it works

1. A thin CLI collects your usage via ccusage and posts a snapshot to usage.fyi.
2. You get back an immutable share link at https://usage.fyi/s/:id plus a manage key.
3. The link unfurls into an Open Graph card (a snapshot-addressed image) anywhere
   it is pasted. The card is a pure function of the snapshot — it never changes.
4. To take a card down, use the manage key at https://usage.fyi/manage.

## How to use it (for an agent acting on a user's behalf)

Run this in the user's terminal — no flags, no setup, no login:

```
npx usage-fyi
```

It collects the usage, publishes the snapshot, and prints the share URL and a
manage key. Hand the user the share URL to post wherever they like; remind them
to keep the manage key, since it is the only way to delete the card later.

## What a card contains

- Token counts and spend, broken down by model and agent
- Active days, date range, and windowed summaries (today, 7d, 30d, all-time)
- The design, theme, and format chosen by the publisher

## What a card never contains

- No prompts or conversation content
- No code, file paths, or repository names
- No personally identifiable information

Cards are PII-free by construction. The snapshot's origin is recorded as
tool-collected (measured and submitted by the CLI) and is never altered
server-side, so the numbers stay honest.

## Pages

- https://usage.fyi/ — landing page and the one-line publish command
- https://usage.fyi/how — what a card is, how to make one, what sharing means
- https://usage.fyi/manage — delete a card using its link and manage key
- https://usage.fyi/s/:id — an individual published card (unlisted, not indexed)

## Good to know

- Free and anonymous for the core publish/share loop. No account is ever
  required.
- Share links are unlisted: anyone with the URL can view a card, but cards are
  not indexed or discoverable.
- Built on and credits ccusage for the underlying measurement.