parthh01/sphinx
You can outsource your thinking, but not your understanding. A hook for agent-assisted development that quizzes you on the changes before you push to prod.
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
Sphinx You can outsource your thinking, but not your understanding. Works with Claude Code · Codex · Cursor · OpenCode · Pi · or a plain git push Reviews run on your Claude Code or Codex plan · OpenRouter · any OpenAI-compatible endpoint Sphinx adds an understanding check to agent-assisted development. When you push to a protected branch, Git waits while Sphinx asks you to predict what your change will do. If you miss something, it explains and gives you another try, usually with a new scenario. Once you pass, the same push continues. This works whether you or a coding agent ran git push. The questions come from a separate reviewer model. It reads the committed change through read-only Git tools and does not see the conversation that produced the code. This is an illustrative exchange for a change that adds a background job queue: Questions cover behavior, failure…
Read the full README ↗ · Preview checked 2026-11-01T05:49:35.919Z
Inside the original README — Document outline
- What a check looks like
- Before you install
- Quick start
- 1. Install (required)
- 2. Load Sphinx in your coding agent (required if you use one)
- 3. Set up a repository (required)
- 4. Check the setup (recommended)
- 5. Push and pass your first check
- During and after a check
- Limits and cost
- Commands
- Reference
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
You can outsource your thinking, but not your understanding. A hook for agent-assisted development that quizzes you on the changes before you push to prod.
Repository facts
- Owner
- parthh01
- Primary language
- JavaScript
- Stars
- 268
- Forks
- 12
- Open issues + pull requests
- 2
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-10-14T20:26:45.000Z
- Last push
- 2026-10-21T04:23:06.000Z
Topics and intended use
No topics were included in the latest source metadata.
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-21T12:11:54.486Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.