Sync & profile

Usage sync sends your daily token counts and supported activity metadata from this Mac to your Codz account. They stay there after the providers’ own logs are rotated or deleted, and they feed your dashboard on codz.com and, if you publish one, your public profile.

Turn on usage sync

1. Open Settings ▸ Account and click Sign in. Your browser handles the sign-in and hands you back to Codz. See Codz account.
2. Turn on Sync usage under Usage sync.

The first time a Mac on Pro signs in, Sync usage turns on by itself unless you have set it before. Logging out turns it off, so turn it back on after you sign in again.

The first sync sends every day this Mac still has in its logs. After that, Codz keeps your account a few minutes behind while it is running. The Upload all history row says where things stand, such as “All available history is synced.” with the time of the last sync, and Sync now sends all of it again at once.

What is uploaded

One row per day, provider and model, with its token counts: input, output, cache reads, cache writes, reasoning and the billable total. With each upload go this Mac’s name and a device ID, which Settings ▸ Account ▸ Advanced shows under Device ID.

Supported sources also contribute stable request or turn identities, timestamps, token breakdowns, reported charges or list-price estimates (API value), and available status and timing. Costs retain their basis and pricing version. Sources without reliable identities remain daily aggregates, with collection coverage shown in Usage.

Sync never sends prompts, answers, code, chat titles, credentials or local file paths. Reported charges and API value (list-price estimates) are kept as separate figures and never added together; missing prices show as ≥ with the reason.

History that outlasts your logs

Claude Code, Codex and the other tools keep their logs on your Mac, and old logs get rotated or deleted. A day that has reached your account stays there after its log is gone, so your history can reach further back than the logs on your Mac.

The first sync can only send what is still on the Mac. Compacting transcripts on the Storage page keeps the records usage is read from, so it doesn’t shorten what can be synced.

The My usage view on the Mac preserves its local analytics. Team scopes on the Mac and web read the same authorized analytics service.

Your dashboard on codz.com

Sign in at codz.com and open your dashboard to see what has synced. Overview shows a year of activity with your streaks, and Usage shows any window by day, provider and model, with Export CSV. Dashboard walks through both.

An active paid team seat requires a reporting team. Codz keeps an eligible existing destination, selects a sole eligible team automatically, or asks you to select among multiple paid teams. Personal cannot be selected while reporting is required. Enrollment imports all available personal and unassigned history. Previously shared team activity stays with its original team after a switch or departure. The Usage scope picker changes what you view independently of this destination. See Teams.

Your public profile

A public profile is a page at codz.com/<username> showing your synced activity to anyone with the link. It is off until you turn it on.

1. Open your dashboard’s Settings. Edit profile in Settings ▸ Account opens it too.
2. Under Profile, choose a Username: lowercase letters, numbers and underscores, 3 to 32 characters. Add a Display name if you like.
3. Turn on Public profile.
4. Click Save. The row then links to your profile.

The profile shows your photo, display name and username, when you joined, and your lifetime tokens, peak day and longest and current streaks. Your top models sit under your name. The year is a calendar of days, by day, by week or as a running total, with your biggest day ringed; earlier years are a click away. Under it are each model’s share of the year and Activity: each month’s tokens and leading models, and the moments worth keeping, such as your first synced day, each agent you added and model you started using, every power of ten your synced total passed, your biggest day and your longest streak.

To add a Bio and up to four Links, open Profile in the web app and click Edit profile. Under Photo, Upload photo… takes a PNG or JPEG: drag it to position it in the circle and zoom to crop it, then Save. Clicking your picture on your own profile opens the same editor. The photo shows wherever your account appears, on codz.com and on your Macs, and Remove photo goes back to your sign-in’s photo. Edit profile on the Mac's Profile page uploads one too, using the middle of the picture. Its What visitors see switches choose the sections a visitor gets. Two start off: Work (chats, agent time, your longest task, the most agents at once on one Mac, merged pull requests and commits) and Working hours (when your agents run through the week; visitors aren’t told your time zone). On your own Profile page you see every section, marked Only you where visitors don’t, and Preview as visitor shows the page as they see it. A profile never shows costs, projects, repositories, prompts or chats.

codz.com/u/<username> redirects to the same page. On the Mac, the Profile page (⌘8) shows whether your profile is public and its address.

Click Share stats on your profile to preview and copy your link. Choose Last 7 days, Last 30 days or Last 90 days, and filter platforms before sharing: the link opens with those choices, and its social preview shows that period’s token total, active days, peak day and daily chart. The default link stays short: codz.com/username.

These are live profiles. The same link shows the latest synced totals, and an open profile refreshes every minute while visible. Prompts, project paths, files and provider account identifiers stay private. Platform filters choose the opening view; visitors can explore the rest of your public usage too.

Share my stats in the dashboard’s Usage page and Share stats in Settings ▸ Profile open the same sharing flow. A private profile offers Set up sharing first.

To take it down, turn off Public profile and click Save. If your Pro plan ends, the profile is unpublished for you.

Questions

“Last sync failed” appears under Usage sync. The message says why:

• “Sign in to Codz first.” or “Your Codz session was rejected. Sign in again.”: sign in again from Settings ▸ Account.
• “Cursor account usage is temporarily unavailable. Keep Cursor signed in, then sync again.”: keep the Cursor app signed in, then click Sync now.
• A message that a Pro subscription is required: the account this Mac is signed in to isn’t on Pro. Check your plan on Billing & Invoices.

I use Codz on more than one Mac. Identified activity is deduplicated across devices and managed cloud receipts. Covered daily buckets are rebuilt from that activity, replacing the legacy snapshot rather than adding to it. Until coverage is complete, the legacy daily snapshot remains authoritative. Older clients contribute daily totals and need an upgrade for request detail and historical coverage.

My dashboard is empty. Check that Sync usage is on for a Mac signed in to the same account, and give it a few minutes, or click Sync now.

My profile page isn’t found. It is public only with a username set and Publish a public profile checked, on an account with Pro.

Saving my profile fails. “Username already taken” and “That username is reserved” mean choosing another name. “Codz Pro is required to publish a profile or share global stats.” means the account isn’t on Pro.