# vibestreak

> vibestreak is a public heatmap and leaderboard for AI-assisted software development that lets developers prove they build with AI and helps employers and clients find them. It ranks developers on consistency (days they coded with AI agents, read from the agents' local session history, committed or not), streaks, and commits shipped with an AI co-author (an optional second signal), not on token spend. Data comes from a free open-source CLI that reads local Claude Code, Codex, Cursor, Gemini CLI, Antigravity, Copilot, OpenCode history and git logs and uploads daily totals only.

- Run by Kingsbridge Consultancy LLC. Free. Sign in with GitHub; one profile can link several GitHub accounts and machines.
- Profiles show a GitHub-style heatmap, current and longest streak, streak levels (Warm-up 3 days, Week 7, Month 30, Quarter 90, Century 100, Year 365), and a "verified" badge when GitHub's public contribution calendars back up at least 60% of a person's shipped days.
- Never collected: prompts, AI responses, code, file paths, repository names, commit messages, email addresses.

## Docs

- [How it works](https://vibestreak.dev/how): what counts, where the numbers come from, scores, and what the CLI sends
- [CLI commands](https://vibestreak.dev/cli): setup (`npx vibestreak`), syncing, terminal views, the streak nudge, MCP setup
- [Privacy](https://vibestreak.dev/privacy): what is collected and shown, and how to delete it
- [Terms](https://vibestreak.dev/terms)

## Data

- [Leaderboard JSON](https://vibestreak.dev/api/v1/board): `?metric=consistency|shipped|streak|tokens&period=today|7d|30d|90d|all&tool=claude|codex|cursor|copilot|gemini|antigravity|opencode&verified=1&limit=10&you=<handle>`, or `from`/`to` dates
- [Today JSON](https://vibestreak.dev/api/v1/today): who has coded with AI today and whose streak is at risk
- Profile JSON: `https://vibestreak.dev/api/v1/users/<handle>.json` (summary and every day)
- Streak card images: `https://vibestreak.dev/card/<handle>.svg` (live, for READMEs) and `.png` (1200×630)

## MCP

- [MCP server](https://vibestreak.dev/mcp): streamable HTTP, no auth for public data; tools `get_leaderboard`, `get_profile`, `get_today`, `get_my_profile` (CLI token as Bearer)

## Optional

- [Full text for AI assistants](https://vibestreak.dev/llms-full.txt)
- [npm package](https://www.npmjs.com/package/vibestreak)
- [CLI source on GitHub](https://github.com/hattray/vibestreak-cli) (MIT)