Sphinx
Sphinx pauses Git pushes to protected branches and asks developers questions about their code diffs. Developers using coding agents can check their understanding of changes before those changes ship.
One of 71 tools in Coding
Who it's for
- Developers using Codex, Claude Code, Cursor, OpenCode, or Pi who want a code-understanding check before pushing.
- Teams protecting Git branches and seeking an additional review step for agent-assisted changes.
- Developers using plain Git who want questions about a diff before a protected-branch push continues.
Not the right fit if…
- Developers on environments other than macOS, Linux, or WSL: these are the environments listed on the page.
- Teams unable to use Node 22.19 or later: the page states this as a requirement.
How it fits your workflow
Install Sphinx and run sphinx install to connect it to Git and coding agents, then select which model should review.
When you or your agent pushes to a protected branch, Sphinx reads the diff and asks questions about what the code does, including what might happen when something goes wrong. Answer the questions; the push continues after the check.
If you need to bypass the check, sphinx yolo lets the push through, and the page says each skip is logged.
Pricing
Free: Sphinx is presented as free and MIT licensed.
Free
Free; the page describes Sphinx as MIT licensed.
- · Git hook for agent-assisted development
Prices checked on Oct 19, 2026 from the vendor's site. They can change; confirm before you buy.
Key features
- Understanding checks on push
- Pauses pushes to protected branches and asks questions based on the code diff before allowing the push to continue.
- Scenario-based questions
- Questions can probe how a change behaves in failure cases, such as what happens when a payment call fails and a webhook is retried.
- Works with coding agents or plain Git
- The page lists Codex, Claude Code, Cursor, OpenCode, and Pi, and also says Sphinx can be used with plain Git.
- YOLO bypass
- The sphinx yolo option lets pushes through when the developer is in a hurry; each skip is logged.
- Minimal-token design
- The page says Sphinx is built to run on minimal tokens and can use an existing coding agent, OpenRouter, or an OpenAI-compatible endpoint.
Works with
- Codex
- Claude Code
- Cursor
- OpenCode
- Pi
- OpenRouter
- OpenAI-compatible endpoints
- Git
Limitations to know
- Requires Node 22.19 or later.
- The page lists macOS, Linux, and WSL as supported environments.
Getting started
npm install -g sphinx-understand
Node 22.19 or later; macOS, Linux, or WSL.
- Install Node 22.19 or later on macOS, Linux, or WSL.
- Run npm install -g sphinx-understand.
- Run sphinx install to connect Git and your coding agents and choose a review model.
- Push as usual with git push.