cd /news/ai-agents/show-hn-sphinx-a-hook-that-quizzes-y… · home › topics › ai-agents › article
[ARTICLE · art-152205] src=sphinx-six-theta.vercel.app ↗ pub= topic=ai-agents verified=true sentiment=↑ positive

Show HN: Sphinx – a hook that quizzes you on your AI's code before shipping

A free, open-source Git hook called Sphinx, published on GitHub by developer parthh01 and installable via `npm install -g sphinx-understand`, pauses pushes on protected branches to quiz developers on what their AI agent's code actually does before it ships. Sphinx has a reviewer model that never saw the developer's chat read the diff and ask what the change does when things go wrong; a wrong answer explains why and prompts a new scenario, while a correct answer lets the push continue. The tool works with Codex, Claude Code, Cursor, OpenCode and Pi or plain Git, runs on minimal tokens from an existing coding agent, OpenRouter or any OpenAI-compatible endpoint, requires Node 22.19+ on macOS, Linux or WSL, and offers a `sphinx yolo` bypass that logs every skip.

read1 min views5 publishedOct 18, 2026

“Outsource your thinking,

not your understanding.”

— Sun Tzu

Sphinx is a Git hook for agent-assisted development. Before your agent’s code ships, it asks you a question about what that code actually does.

npm install -g sphinx-understand Built to run on minimal tokens, from your existing coding agent, OpenRouter, or any OpenAI-compatible endpoint.

Sphinx

Your webhook handler now saves the event ID before calling charge(). Stripe times out and sends the same event again. What happens on the retry?

You

It runs twice, so the customer is charged twice.

Sphinx

Not quite. The retry finds the saved ID and returns 200 without charging. But that ID is stored before the charge succeeds. If charge() fails, what does the next retry do?

You

It skips the charge, so the customer is never billed.

  1. 01### You push.Or your agent does. Git s on the branches you protect.
  2. 02### Sphinx asks.A reviewer that never saw your chat reads the diff and asks what the change does when things go wrong.
  3. 03### You answer.Get it wrong and you learn why, then try a new scenario. Get it right and the push continues.

Works with Codex, Claude Code, Cursor, OpenCode, and Pi, or plain Git. Your answers never reach the coding agent, and .env files and keys are never opened. In a hurry? sphinx yolo lets pushes through, and every skip is logged.

Start in a minute. #

npm install -g sphinx-understand
sphinx install

git push

sphinx install connects Git and your coding agents and asks which model should review. Read the docs for everything else.

── more in #ai-agents 4 stories · sorted by recency
── more on @sphinx 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/show-hn-sphinx-a-hoo…] indexed:0 read:1min 2026-10-18 · —