Sphinx stopper git push til du har svart på hva agentens kode gjør
søndag 18. oktober · KI-generert · Kilde: GitHub
Installer Sphinx hvis du vil tvinge deg selv til å forstå koden agenten pusher før den lander på main.
«Outsource your thinking, not your understanding.» Slagordet står øverst i README-en til Sphinx, en Git-hook med MIT-lisens som nå er ute i versjon 0.1. Når du eller kodeagenten pusher til en beskyttet gren, holder Sphinx igjen pushen og ber deg forutsi hva endringen gjør når noe går galt. Svarer du feil, får du en forklaring og et nytt scenario om samme konsept. Består du, fortsetter den samme pushen.
Spørsmålene kommer fra en egen reviewer-modell som leser committen gjennom read-only Git-verktøy og aldri ser samtalen som laget koden. De handler om oppførsel, feilmoduser og invarianter, ikke filnavn. Små endringer gir ett spørsmål, store opptil tre på standarddybde. En typisk sjekk bruker 5 til 8 modellkall pluss omtrent ett per svar, og en bestått sjekk gjelder i 24 timer så lenge koden, målet og policyen er uendret.
Sphinx virker med Codex, Claude Code, Cursor, OpenCode og Pi, eller ren Git. Oppsettet foreslår Haiku via Claude Code eller GPT-6 Luna via Codex som reviewer, og da går forbruket av abonnementet ditt. Velger du OpenRouter, trenger du en API-nøkkel selv for gratismodeller. Svarene dine når aldri kodeagenten, som bare ser status og forbruk.
«This is practice, not a security gate.» — README-en til Sphinx på GitHub
Begrensningene er tydelig dokumentert. sphinx install setter global core.hooksPath, så pushes til main og master i alle repoer på maskinen sjekkes fra første stund. Pushen venter i opptil 25 minutter, og agentens shell kan time out før det. Den endrede koden sendes til reviewer-leverandøren, uten noen standardgrense for antall modellkall. På Linux og over SSH må du selv åpne den lokale URL-en Git skriver ut. Versjon 0.1 dekker bare lokale commits og pushes, ikke merges i nettleseren eller CI, og krever Node 22.19 eller nyere på macOS, Linux eller WSL.
Hva bør du gjøre?
- Legg sensitive stier inn i .sphinxignore før første sjekk, siden reglene bare matcher filstier og ikke fanger en hemmelighet limt inn i vanlig kildekode.
- Sett et tak med sphinx config --max-model-calls 30 hvis du bruker en betalt leverandør.
- Kjør sphinx init i repoet der du vil styre grener og dybde, og sphinx yolo i repoer der du vil slå sjekken av.