--- title: Show HN: Sphinx – A hook that quizzes you on your AI's... description: Sphinx is a free, open-source Git hook designed for agent-assisted development. Before code written by an AI coding agent gets pushed, Sphinx asks the... canonical: https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2 twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping | daily.dev og:description: Sphinx is a free, open-source Git hook designed for agent-assisted development. Before code written by an AI coding agent gets pushed, Sphinx asks the... og:url: https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2 og:image: https://api.daily.dev/og/posts/rwaQE5PD2.png og:image:alt: Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping **[Hacker News](https://daily.dev/sources/hn)** · 2 min read · 0 upvotes · 0 comments ## Summary Sphinx is a free, open-source Git hook designed for agent-assisted development. Before code written by an AI coding agent gets pushed, Sphinx asks the developer a question about what the change actually does — for example, probing edge cases like webhook retry behavior. If you answer wrong, you learn why and get a new scenario; answer right and the push continues. It works with Codex, Claude Code, Cursor, OpenCode, and Pi, runs on minimal tokens via OpenRouter or any OpenAI-compatible endpoint, never opens .env files or secrets, and includes a yolo mode to skip checks (with skips logged). Installation is via npm, requiring Node 22.19+. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How can I make sure I actually understand code my AI coding agent wrote before pushing it? A tool called Sphinx installs as a Git hook that intercepts pushes on protected branches and asks a question about what the diff actually does, such as edge-case behavior on retries or failures. Answering incorrectly blocks the push and prompts a follow-up scenario; answering correctly lets it through. It supports Codex, Claude Code, Cursor, OpenCode, and Pi, and installs via npm as sphinx-understand on Node 22.19+. _daily.dev surfaces tools like this for developers trying to stay accountable for AI-generated code._ ### Is there a way to bypass a Git pre-push check when I'm in a hurry but still keep a record of it? Sphinx, a Git hook for agent-assisted development, includes a 'sphinx yolo' command that lets a push through without answering its comprehension question, while logging every skip for later review. This gives developers an escape hatch under time pressure without losing visibility into which pushes bypassed the understanding check. _Developers balancing speed and code review rigor can track tools like this through daily.dev._ ## Community take How the wider developer community reacted, aggregated from 1 discussion and 63 comments across hackernews (as of 2026-10-18). **TL;DR:** Reactions are split between people who see this as a useful forcing function to keep developers understanding AI-generated code, and skeptics who think it's a gimmick that either won't stop careless shippers or is unnecessary for careful ones. **Sentiment:** 25% positive · 30% mixed · 45% skeptical **The case for** - Several people built or use similar 'quiz me on the PR' tools and found the questions genuinely surprising and useful for catching overlooked edge cases. - Seen as potentially valuable for reviewing large AI-generated PRs or for OSS maintainers vetting external contributions. - Framed as a cultural nudge analogous to past warnings against blindly copying StackOverflow code. **The pushback** - Critics argue it's trivially bypassed by copy-pasting the quiz question back into the agent. - Some say it targets the wrong audience: careful developers don't need it and careless ones won't engage honestly. - One commenter built a similar tool themselves and got frustrated with being quizzed, abandoning it. - Concern that this just adds friction/gatekeeping without fixing the underlying problem of not understanding one's own code. - Points out the name collides with the existing well-known Sphinx documentation tool. **By community** - hackernews (mixed): Discussion ranges from enthusiastic support for forcing comprehension of AI code to dismissal of the tool as a gimmick that's easily gamed or solves nothing, with a broader tangent on whether AI makes developers worse architects and thinkers. **Hottest debate:** Whether tools like this meaningfully improve developers' understanding of AI-written code or are just theater/friction that doesn't change underlying habits. **Open questions** - Can the tool detect or prevent users from just pasting its questions back into the AI to get answers? - How would this scale or integrate at the PR/code-review level rather than just the local git push? - Does requiring quiz answers actually change behavior for people who already don't care about understanding their code? **Highlights** > Honestly I love to see people working on this problem ! I actually built a similar project myself (https://github.com/bhurghundii/vibecheck.dev) except it prevents you from merging on the PR level. I’d love to get in touch to talk about it sometimes. Edit: I see there are a lot of people questioning the value of this. The thing is that there are teams where people are just pumping tons of AI code without understanding their work (literally take the ticket and dump it) and shipping it. culture change is the right answer but v hard but this at least slows things down and is quick to implement > — [sailorganymede on hackernews · 2 comments](https://news.ycombinator.com/item?id=50138500) > This is cute and novel, but practically useless. For those who use AI efficiently and effectively, this is useless. For those who don't, this becomes friction they don't want. Who really needs this? > — [compounding-err on hackernews](https://news.ycombinator.com/item?id=50138503) > It’s a neat idea, i think it’ll really take off if you change “before pushing to prod” to “before requesting another human’s time or attention”. If something like this was gatekeeping the “submit PR” and “update PR” buttons it would prevent a lot of waste. > — [fwlr on hackernews · 1 comments](https://news.ycombinator.com/item?id=50140483) > Lol I built this and immediately got frustrated with it and stopped using it. I think I don't like being questioned by someone who I expect to work like magic. > — [chacha-bong on hackernews](https://news.ycombinator.com/item?id=50138688) > I mean I see the idea, but at least I use LLMs for code generation in two distinct ways. The first is when I care about the code. That's when I actually read what it produces and force it to use my mental model of how things should be. The second is when I just need a solution that sorta fits the requirements provided. Then I don't read the code because I really do not care. So this hook would either ask me things I know, or it would ask me things I do not care about. But I guess this is very workflow-dependent. > — [hypfer on hackernews · 1 comments](https://news.ycombinator.com/item?id=50138244) **Source threads** - [hackernews](https://news.ycombinator.com/item?id=50137950) · 194 points · 63 comments ## Similar posts on daily.dev - [Untitled](https://daily.dev/posts/untitled-kckcjr4lw) · SitePoint · 0 upvotes · 0 comments - [AI Hooks for Claude Code, Cursor, and Codex: Block Secrets](https://daily.dev/posts/ai-hooks-for-claude-code-cursor-and-codex-block-secrets-sv0j5ae3m) · GitGuardian · 1 upvotes · 1 comments - [Open Code Review: free, self-hosted AI code review agent](https://daily.dev/posts/open-code-review-free-self-hosted-ai-code-review-agent-5pu5mxvci) · FireUp · 0 upvotes · 0 comments --- Tags: [#ai-agents](https://daily.dev/tags/ai-agents), [#git](https://daily.dev/tags/git), [#code-review](https://daily.dev/tags/code-review), [#vibe-coding](https://daily.dev/tags/vibe-coding) [View this post on daily.dev](https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping","url":"https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2"},"datePublished":"2026-10-18T06:52:19.937Z","dateModified":"2026-10-18T15:08:28.638Z","description":"Sphinx is a free, open-source Git hook designed for agent-assisted development. Before code written by an AI coding agent gets pushed, Sphinx asks the...","image":"https://media.daily.dev/image/upload/s--0_ODbtD2--/f_auto/v1722860399/public/Placeholder%2008","thumbnailUrl":"https://media.daily.dev/image/upload/s--0_ODbtD2--/f_auto/v1722860399/public/Placeholder%2008","isAccessibleForFree":true,"articleSection":"Hacker News","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Hacker News","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/hn","url":"https://daily.dev/sources/hn"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"ai-agents,git,code-review,vibe-coding","timeRequired":"PT2M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Hacker News","item":"https://daily.dev/sources/hn"},{"@type":"ListItem","position":3,"name":"Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/show-hn-sphinx-a-hook-that-quizzes-you-on-your-ai-s-code-before-shipping-rwaqe5pd2#faq","mainEntity":[{"@type":"Question","name":"How can I make sure I actually understand code my AI coding agent wrote before pushing it?","acceptedAnswer":{"@type":"Answer","text":"A tool called Sphinx installs as a Git hook that intercepts pushes on protected branches and asks a question about what the diff actually does, such as edge-case behavior on retries or failures. Answering incorrectly blocks the push and prompts a follow-up scenario; answering correctly lets it through. It supports Codex, Claude Code, Cursor, OpenCode, and Pi, and installs via npm as sphinx-understand on Node 22.19+. daily.dev surfaces tools like this for developers trying to stay accountable for AI-generated code."}},{"@type":"Question","name":"Is there a way to bypass a Git pre-push check when I'm in a hurry but still keep a record of it?","acceptedAnswer":{"@type":"Answer","text":"Sphinx, a Git hook for agent-assisted development, includes a 'sphinx yolo' command that lets a push through without answering its comprehension question, while logging every skip for later review. This gives developers an escape hatch under time pressure without losing visibility into which pushes bypassed the understanding check. Developers balancing speed and code review rigor can track tools like this through daily.dev."}}]} ```