Sphinx: Git hook tool quizzes developers on AI-generated code before push

·2026.10.25 09:30

Key point

Sphinx intercepts git push to protected branches and requires users to answer LLM-generated questions about code changes to verify understanding.

1 / 2

Details

  • Sphinx is a Git hook tool that blocks pushes to protected branches until users pass a quiz on the committed changes, designed to ensure developers understand AI-generated code.
  • A separate reviewer model reads the diff using read-only Git tools to generate questions about behavior, failure modes, and invariants, without accessing the original code generation conversation history.
  • Supports Claude Code, Codex, Cursor, OpenCode, and Pi agents, with reviewer options including Claude Code/Codex plans, OpenRouter, and OpenAI-compatible endpoints.
  • Version 0.1 supports local commits and pushes only, with a 24-hour pass validity period and a maximum wait time of 25 minutes per check.
  • Security limitations include the inability to block secrets pasted directly into source code, as ignore rules match file paths only, and the tool is not a security gate but an understanding test.
  • Configuration is managed via .sphinxconfig, .sphinxignore, and .sphinxcontext.md files, with options to adjust question depth (high, low, mixed) and model call limits.

This summary was generated automatically by AI. Check the original for the author's claims and context. Copyright belongs to the original author.

Our guide explains how the AI works. Report summary errors, attribution issues, or removal requests via Contact.