SigRank

🏆 SigRank is live: signalaf.com — the leaderboard for how efficiently you use AI, not how much. Run npx sigrank to see your cascade now. Token counts only. Never your prompts.

A privacy-preserving leaderboard for AI operator efficiency.

Most platforms reward volume. SigRank rewards structure.

Table of Contents

• What is SigRank?
• The SigRank ecosystem
• Get ranked (you don't need this repo)
• How it works
• For developers
• Stack
• Quick Start
• Scripts
• Project Map
• Data Model
• Environment
• Supabase
• Scoring Invariants
• Development Notes
• Related
• Community
• License

The leaderboard	Your operator profile
Every operator ranked by Υ Yield — the architecture of the cascade, not raw spend	Cascade layer, class, and fingerprint — all from four token counts

What is SigRank?

SigRank scores AI operators by token cascade efficiency: how much reusable signal they create from each unit of input — not how many tokens they burn. The rank metric:

Υ = (cache_read × output) / input²

The board is anonymous by default, claimable by operators, and built around one question: is this session compounding signal, or just burning tokens? Volume is noise; yield is signal.

This repo is the Next.js app behind signalaf.com — the public board, operator profiles, the wiki, account + billing, and the scoring/ingest engine. You don't clone this to use SigRank (see below) — you clone it to work on it.

The SigRank ecosystem

Also in the MO§ES™ suite

Get ranked (you don't need this repo)

SigRank runs from your terminal — or wire it as an MCP server for your AI agent:

npx sigrank                 # see your cascade now (no install, no sign-in)

The client reads your local AI session logs on-device, derives your cascade, and publishes to the board — token-only, no transcript content.

npm install -g sigrank     # bundles ccusage + tokscale + tokendash — no separate installs
sigrank enroll             # sign in: paste a connect code from signalaf.com → Settings
sigrank submit             # publish your verified runs to the board

Or explore first, no sign-in:

sigrank                    # full tabbed TUI: dashboard · compare · board · watch
npx sigrank board --once   # print the live leaderboard once

Cautious? sigrank submit --dry-run prints the exact signed payload — four token counts and a signature — and sends nothing.

$ sigrank submit --dry-run
📦 Payload (not sent):
  input:          1,251,211
  output:        11,296,121
  cache_create:     128,196
  cache_read:    2,555,179,769
  Υ Yield:          18,436.98
  class:            TRANSMITTER
  signature:        ed25519:9f3a...

Full CLI + MCP docs: sigrank-mcp · package: sigrank on npm.

How it works

• Four raw token pillars — input, output, cache_creation, cache_read — are the only inputs. No message content, ever.
• The cascade engine derives Υ Yield, Leverage, Velocity, 10xDEV, SNR, and efficiency from those four numbers. The server re-scores every submission authoritatively.
• Operators are placed in signal classes (Transmitter, Architect, …) by their cascade shape, and ranked globally by Υ.
• SIGNA RATE is the class credential; Υ Yield is the rank metric.

Deep dive: the in-app wiki.

For developers

The rest of this README is for working on the app itself.

Stack

• Framework: Next.js 15 App Router, React 19, TypeScript strict
• UI: Tailwind CSS, themeable SigRank design tokens (carbon default)
• Data: Supabase with cold-store snapshot and mock fallback
• Billing: Stripe Checkout, Billing Portal, webhook handlers
• Validation: zod, Node test runner, TypeScript

Quick Start

npm install
cp .env.example .env.local      # all values optional — see Environment below
npm run dev                     # http://localhost:3000

The app is designed to run without Supabase or Stripe credentials. When env vars are missing, reads fall back to the cold-store snapshot and then deterministic mock data, while billing routes return configuration errors instead of crashing — so it stays buildable, previewable, and testable out of the box.

Requires Node 22.x (see engines in package.json). On a newer Node, next dev may fail to start — use the version manager of your choice to pin 22.

If vendor chunks act strange, run the dev server directly: node_modules/.bin/next dev --port 3000

Scripts

Before committing, run the gates CI enforces:

npx tsc --noEmit            # 0 errors (typescript is a devDependency)
npm run build               # production build green
npm run test:canonical      # canonical ingest parity — MO§ES Υ 18436.98

Project Map

Data Model

All app code reads operator data through @/lib/data. The facade chooses the safest available source, in order:

1. Supabase live reads when credentials are configured.
2. Cold-store snapshot (lib/data/snapshot.json) if live reads are unavailable or fail.
3. Mock fixtures (lib/data/mock.ts) as the last resort.

Environment

Copy .env.example to .env.local and fill values as needed. All are optional locally (the app degrades gracefully); production values live in Vercel environment variables.

Never commit real secrets or proprietary ruleset values.

Supabase

Schema, migrations, RLS policies, and seed data live in supabase/. See supabase/README.md to run your own instance. RS.xx scoring weights are server-only and are not included here.

Scoring Invariants

Product contracts, not implementation details:

• Υ = (cache_read × output) / input²
• T × C × R = Cr / I = Leverage
• 10xDEV = log₁₀(Leverage)
• SIGNA RATE is the class credential; Υ Yield is the rank metric.
• RS.xx weights are server-only and must not be exposed to client components.

Development Notes

• Keep changes small and aligned with existing file ownership.
• Pages are React Server Components by default; add 'use client' only when a component needs hooks, event handlers, or browser APIs.
• Keep components/sigrank/tokens.ts and Tailwind theme values in sync.
• Use <Placeholder /> for placeholder metrics and <CanonId /> for canonical real values.
• Do not import server-only scoring configuration into client code.
• Avoid random values and wall-clock reads at module scope.

Related

• signalaf.com — the live board
• signalaf.com/score — paste four token counts, get projected yield + ghost rank
• sigrank-mcp — the CLI / TUI / MCP server (npx sigrank)
• Smithery — one-click MCP install for Claude Desktop, Cursor, and more
• Glama — MCP server directory listing

Community

• Contributing
• Code of Conduct
• Security policy
• Changelog

Reporting issues

Found a bug or have a feature request? Please open an issue on GitHub. Search existing issues first to avoid duplicates, and include repro steps, expected vs. actual behavior, and your environment (OS, Node version).

Pull request process

1. Fork the repo and create a branch from main.
2. Make your change, keeping it small and aligned with existing file ownership.
3. Ensure npx tsc --noEmit passes with 0 errors before pushing.
4. Open a pull request against main with a clear description of what and why.

License

MIT — see LICENSE.