tokfriends
v0.2.5
Published
Friend-group usage leaderboards, all in your terminal.
Downloads
1,306
Readme
Tokfriends
A terminal leaderboard for comparing AI coding usage with friends.
Create A Group
npx tokfriends@latest init --name "Your Name"
npx tokfriends@latest group create "My Group"Copy the invite code that gets printed.
Join A Group
npx tokfriends@latest join <invite-code> --name "Your Name"That joins the group, syncs your local usage, and opens the leaderboard.
Open The Leaderboard
npx tokfriends@latest leaderboardThe leaderboard autosyncs if your usage has not synced in the last 10 minutes.
TUI Keys
j/k move
enter details
p period
s sort
r refresh
q quitUseful Commands
npx tokfriends@latest groups
npx tokfriends@latest group members
npx tokfriends@latest sync
npx tokfriends@latest sync --dry-run
npx tokfriends@latest leaderboard --period week
npx tokfriends@latest leaderboard --sort costGroup owners can manage groups:
npx tokfriends@latest group rotate-code
npx tokfriends@latest group remove <friend-email-or-user-id>
npx tokfriends@latest group deletePrivacy
Tokfriends uploads:
- token totals
- estimated cost
- active days
- client breakdown
- daily token/cost totals for the last year
Tokfriends does not upload prompts, responses, transcripts, project names, file paths, or raw local records.
Delete your synced usage:
npx tokfriends@latest resetUpdate
npx tokfriends@latest leaderboardIf installed globally:
npm install -g tokfriends@latest