How Perfstaq works

One command turns your real work into a profile a client can check. It takes about 10 seconds and needs Node 20 or newer.

  1. 1

    Run the scan

    In the folder that holds your repos. It reads your own git commits and counts your Claude Code, Cursor and Codex sessions, all on your machine. Add --all to include sibling repos.

  2. 2

    See your scorecard

    Your score, experience per language and achievement cards print in the terminal. Nothing has left your laptop yet.

  3. 3

    Sign in with GitHub

    Say yes to upload. A browser tab opens; sign in with GitHub and click Authorize. That links the scan to your GitHub account.

  4. 4

    Get verified

    Say yes to sharing commit IDs from your public repos. The server checks a random sample on GitHub: they must exist, be yours and match the size you claim.

  5. 5

    Share it

    Your profile and cards go live. Post a card to LinkedIn or X, download it for Instagram, or attach the passport PDF to an Upwork or Fiverr profile.

$perfstaq help --faq

Does any of my code leave my machine?
No. No source code, file paths, commit messages or prompt text is uploaded. Only scores, ratios, language shares and, if you agree, the IDs and line counts of commits in your public GitHub repos.
All my work is in private or company repos.
You can still scan and get cards, but your profile will be marked self-reported and won’t be ranked, because nobody outside can check private commits. Public commits, even a side project, are what earn the verified seal.
Why is my profile self-reported?
Your profile page lists the exact reason and what to do about it. The usual ones: no public commits, commits not pushed yet, or a git email that isn’t on your GitHub account (fix with --email you@example.com).
How do I get the Signed seal?
Sign your commits with an SSH or GPG key that is added to GitHub. Commits GitHub shows as Verified count as signed on your next scan.
I work on several laptops.
Scan on the machine with the most of your work. Each scan replaces the last, it doesn’t add to it.
How often can I re-scan?
One accepted scan every 20 hours. A very large jump in score within a week is flagged on your profile.
What does a client see?
Your public profile, and on /verify a plain-English verdict: what was checked on GitHub, what is only self-reported, and any flags.
Can I delete everything?
Yes. Sign in, open your profile and use Delete my data. It removes your profile, scans and ratings immediately.

More detail on data: privacy.

How it works · Perfstaq