GITGEEK(1)GITGEEK(1)

$ man gitgeek

The Manual

What GitGeek $GGdoes, how it works, and what's shipped versus what's coming. Still v0.1.0 (draft), so expect this to change.

name

gitgeek- an AI that reviews your code, pays whoever's carrying the repo, and scores everyone else.

synopsis

gg review   [repo]            # audit a pull request
gg reward   [repo] --fund N   # stream $GG to contributors
gg rep      [user]            # query an onchain GeekScore
gg watch    --live            # tail the global review feed

description

Three things are broken. The people maintaining the libraries everything else depends on mostly make nothing. Reviewing PRs is the job nobody volunteers for. And dev reputation, the thing that quietly decides who gets hired, lives in a pile of profiles you can't verify.

GitGeek is one agent that handles all three. It reviews every PR, it rewards whoever's actually doing the work, and it ranks the rest with a score that lives onchain. $GG is what moves between them.

commands

gg review

Add it to a repo as a GitHub App. Every PR gets an LLM reviewer running on top of static analysis, looking for reentrancy, race conditions, the secret you committed, the test you skipped. You get inline comments, a severity count, and a verdict. The free tier is blunt and a little mean. Holding $GG turns on whole-repo audits and private repos.

gg reward

A maintainer funds a pool. GitGeek scores each merged PR on what it actually did (diff complexity, blast radius, test coverage, how nasty it was to review) and streams $GG out proportionally every epoch. Proof of contribution, settled onchain where anyone can check it.

gg rep

Takes a dev's public history and turns it into a GeekScore (0 to 100), minted as a soulbound profile once you stake $GG. Recruiters and DAOs pay per lookup. The score can't be bought, so the lookup is worth paying for.

the $GG token

Supply is 1,000,000,000, on Base. Free reviews cost no tokens, so $GGisn't a paywall on the front door. It pays for the deep audits, gets staked to mint a GeekScore, covers reputation lookups, and votes on how the impact model scores work.

liquidity40%locked · LP burned
contributor rewards25%streamed via gg reward
treasury & ops15%multisig
team12%24mo vest · 6mo cliff
community / airdrop8%to verified geeks

There's a 1/1 tax: 1% on buys and 1% on sells, and it all goes to development. It lives in a Uniswap V4 hook at the pool, not in the token, so moving $GG between your own wallets is free.

geekscore

A 0 to 100 score pulled from your public git history: code quality, how often your reviews land, how consistently you ship, how much ground you actually cover across languages and projects. Stake $GGand it mints as a soulbound token. It's read-only, so you earn it or you don't. No buying your way up.

GeekScore = w1·quality + w2·acceptance + w3·consistency + w4·breadth
           ── weights are governed by $GG holders ──

architecture

Two layers. Off-chain, the agent does the reading and the thinking. Onchain on Base, three contracts do the settling: a reward distributor, a reputation registry, and the $GG token with its V4 tax hook.

        ┌──────────────────────── GITHUB ────────────────────────┐
        │   pull request · commit · repo metadata                 │
        └───────────────────────────┬─────────────────────────────┘
                                     │ webhook
                          ┌──────────▼───────────┐
                          │   GITGEEK AGENT       │   neural reviewer
                          │   review · score      │   (LLM + static analysis)
                          └──────────┬───────────┘
                                     │ verdict + impact score
        ┌────────────────────────────▼────────────────────────────┐
        │                  BASE  (onchain layer)                   │
        │   ┌────────────┐  ┌──────────────┐  ┌────────────────┐   │
        │   │  reward    │  │  reputation  │  │  $GG / V4 hook │   │
        │   │ distributor│  │   registry   │  │  (1/1 tax)     │   │
        │   └────────────┘  └──────────────┘  └────────────────┘   │
        └──────────────────────────────────────────────────────────┘

install

# 1 · add the GitHub App to a repo
$ open https://github.com/apps/gitgeek

# 2 · (optional) hold $GG to unlock deep audits
$ open git-geek.com  → buy $GG

# 3 · open a PR. the geek does the rest.
$ git push origin feature/ship-it

faq

> Yeah. On any public repo it reads your PRs, flags the bugs, and roasts you for nothing. The paid stuff is the heavy lifting: full-repo security passes, private repos, jumping the queue. That needs a small $GG balance. No $GG, no deep audit. That's the only gate there is.