- Free
- FOSS
“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 inquiry concerning what that code really does.
npm instal -g sphinx-understand
Built to run on minimal tokens, from your existing coding agent, OpenRouter, or any OpenAI-compatible endpoint.
$ git shove base main
sphinx · understanding inspect for main
11 records changed · +5,012 −3,147
Sphinx
Your webhook handler now saves the event ID before calling charge(). Stripe times out and sends the identical event again. What happens on the retry?
You
It runs twice, so the client is charged twice.
Sphinx
Not quite. The retry finds the saved ID and returns 200 without charging. But that ID is stored before the accusation succeeds. If charge() fails, what does the next retry do?
You
It skips the charge, so the client is never billed.
✓ Understood. Pushing to origin/main.
An explanatory exchange. Real questions arrive from your diff.
- 01
You push.
Or your delegate does. Git pauses on the branches you protect.
- 02
Sphinx asks.
A reviewer that never saw your conversation says the diff and asks what the alter does whenever things go wrong.
- 03
You answer.
Get it incorrect and you study why, afterward try a new scenario. Get it correct and the shove continues.
Works alongside Codex, Claude Code, Cursor, OpenCode, and Pi, or plain Git. Your answers never attain the coding agent, and .env records and keys are never opened. In a hurry? sphinx yolo lets pushes through, and all skip is logged.
Start in a minute.
# Node 22.19+ · macOS, Linux, or WSL npm instal -g sphinx-understand sphinx install # afterward shove as usual git push
sphinx instal connects Git and your coding agents and asks which example should review. Read the docs for everything else.
