Sphinx is een tool die is ontworpen voor agent-ondersteunde softwareontwikkeling. Het functioneert als een Git-hook die voorkomt dat ontwikkelaars blindelings code accepteren die door AI-agents is geschreven.
Werking Bij het pushen van code naar beschermde branches analyseert Sphinx de diff en stelt een specifieke vraag over hoe de code reageert in bepaalde scenario's (zoals foutafhandeling of retries). De push wordt pas voltooid wanneer de ontwikkelaar correct antwoordt, wat garandeert dat er menselijk begrip is van de wijzigingen.
Kenmerken en Installatie
- Compatibiliteit: Werkt met diverse agents zoals Claude Code, Cursor en OpenCode via OpenAI-compatibele eindpunten.
- Veiligheid: Gevoelige bestanden zoals
.env worden niet geopend en antwoorden worden niet gedeeld met de coding agent.
- Systeemvereisten: Vereist Node 22.19+ op macOS, Linux of WSL.
- YOLO-modus: Gebruikers kunnen controles overslaan met
sphinx yolo, hoewel dit wordt gelogd.
Sphinx — besteed je denken uit, niet je begrip
Sphinx is een Git-hook voor agent-ondersteunde ontwikkeling. Voordat de code van je agent wordt verzonden, stelt het je een vraag over wat die code daadwerkelijk doet.
Installatie
npm install -g sphinx-understand
Sphinx is gebouwd om te werken met minimale tokens, via je bestaande coding agent, OpenRouter of elk OpenAI-compatibel eindpunt.
Voorbeeld van een interactie
Hieronder volgt een illustratieve uitwisseling. In de praktijk worden vragen gegenereerd op basis van jouw specifieke diff.
Scenario: $ git push origin main sphinx · understanding check for main 11 files changed · +5,012 −3,147
Sphinx: Je webhook-handler slaat nu het event-ID op voordat charge() wordt aangeroepen. Stripe time-out en verzendt hetzelfde event opnieuw. Wat gebeurt er bij de retry?
Jij: Het wordt twee keer uitgevoerd, dus de klant wordt twee keer belast.
Sphinx: Niet helemaal. De retry vindt het opgeslagen ID en geeft 200 terug zonder te belasten. Maar dat ID wordt opgeslagen voordat de betaling slaagt. Als charge() mislukt, wat doet de volgende retry dan?
Jij: Deze slaat de betaling over, dus de klant wordt nooit gefactureerd.
Resultaat: ✓ Begrepen. Pushen naar origin/main.
Hoe het werkt
- Je pusht.
Of je agent doet dat. Git pauzeert op de branches die je beschermt.
- Sphinx vraagt.
Een reviewer die je chat nooit heeft gezien, leest de diff en vraagt wat de wijziging doet wanneer dingen misgaan.
- Je antwoordt.
Maak een fout en leer waarom, om vervolgens een nieuw scenario te proberen. Geef het juiste antwoord en de push gaat verder.
Compatibiliteit en veiligheid
Sphinx werkt met Codex, Claude Code, Cursor, OpenCode en Pi, of met regulier Git. Jouw antwoorden bereiken de coding agent nooit, en .env-bestanden en sleutels worden nooit geopend.
Voor situaties waarin je haast hebt, laat sphinx yolo pushes door; elke skip wordt gelogd.
Snel aan de slag
Systeemvereisten:
- Node 22.19+
- macOS, Linux of WSL
Stappen:
- Installeer de package:
``bash npm install -g sphinx-understand ``
- Voer de installatie uit:
``bash sphinx install ``
- Push zoals gebruikelijk:
``bash git push ``
sphinx install verbindt Git met je coding agents en vraagt welk model de review moet uitvoeren. Raadpleeg de documentatie voor alle overige details.
Licentie: MIT
Sphinx — besteed je denken uit, niet je begrip
Sphinx is een Git-hook voor agent-ondersteunde ontwikkeling. Voordat de code van je agent wordt verzonden, stelt het je een vraag over wat die code daadwerkelijk doet.
Installatie
npm install -g sphinx-understand
Sphinx is gebouwd om te werken met minimale tokens, via je bestaande coding agent, OpenRouter of elk OpenAI-compatibel eindpunt.
Voorbeeld van een interactie
Hieronder volgt een illustratieve uitwisseling. In de praktijk worden vragen gegenereerd op basis van jouw specifieke diff.
Scenario: $ git push origin main sphinx · understanding check for main 11 files changed · +5,012 −3,147
Sphinx: Je webhook-handler slaat nu het event-ID op voordat charge() wordt aangeroepen. Stripe time-out en verzendt hetzelfde event opnieuw. Wat gebeurt er bij de retry?
Jij: Het wordt twee keer uitgevoerd, dus de klant wordt twee keer belast.
Sphinx: Niet helemaal. De retry vindt het opgeslagen ID en geeft 200 terug zonder te belasten. Maar dat ID wordt opgeslagen voordat de betaling slaagt. Als charge() mislukt, wat doet de volgende retry dan?
Jij: Deze slaat de betaling over, dus de klant wordt nooit gefactureerd.
Resultaat: ✓ Begrepen. Pushen naar origin/main.
Hoe het werkt
- Je pusht.
Of je agent doet dat. Git pauzeert op de branches die je beschermt.
- Sphinx vraagt.
Een reviewer die je chat nooit heeft gezien, leest de diff en vraagt wat de wijziging doet wanneer dingen misgaan.
- Je antwoordt.
Maak een fout en leer waarom, om vervolgens een nieuw scenario te proberen. Geef het juiste antwoord en de push gaat verder.
Compatibiliteit en veiligheid
Sphinx werkt met Codex, Claude Code, Cursor, OpenCode en Pi, of met regulier Git. Jouw antwoorden bereiken de coding agent nooit, en .env-bestanden en sleutels worden nooit geopend.
Voor situaties waarin je haast hebt, laat sphinx yolo pushes door; elke skip wordt gelogd.
Snel aan de slag
Systeemvereisten:
- Node 22.19+
- macOS, Linux of WSL
Stappen:
- Installeer de package:
``bash npm install -g sphinx-understand ``
- Voer de installatie uit:
``bash sphinx install ``
- Push zoals gebruikelijk:
``bash git push ``
sphinx install verbindt Git met je coding agents en vraagt welk model de review moet uitvoeren. Raadpleeg de documentatie voor alle overige details.
Licentie: MIT
Groetjes,