parthh01/sphinx

해결하는 문제

에이전트 지원 개발은 인간 운영자가 완전히 이해하지 못하는 코드를 생성할 수 있습니다. Sphinx는 푸시 워크플로에 이해 확인을 추가합니다. 보호된 브랜치에 푸시하면 Git이 일시 중지하고 변경 사항이 무엇을 할지 예측하도록 요청합니다. 놓친 부분이 있으면 설명하고 새 시나리오를 제공합니다. 통과하면 푸시가 계속됩니다. 사용자 또는 코딩 에이전트가 푸시를 실행했는지 여부에 관계없이 작동하며 설치 후 머신의 모든 저장소에 적용됩니다.

작동 방식

Sphinx는 구성한 브랜치(기본값: main 및 master)에 대한 푸시에서 트리거되는 전역 Git 훅(core.hooksPath)을 설치합니다. 별도의 리뷰어 모델이 읽기 전용 Git 도구를 통해 커밋된 변경 사항을 읽습니다. 코드를 생성한 대화는 절대 보지 않습니다. 파일 이름이나 함수 이름이 아닌 동작, 실패 모드 및 불변성에 대한 질문을 생성합니다. 로컬 브라우저 페이지(또는 터미널)에서 예측과 간단한 추론을 답변합니다. 틀린 답변에는 설명과 새 시나리오가 제공되며, 이의는 특별히 처리됩니다. 확인은 개방형입니다. 답변하는 동안 코드를 읽을 수 있습니다. 통과는 24시간 동안 유효하며 동일한 푸시에 대해 다시 묻지 않습니다. 리뷰는 Claude Code 또는 Codex 플랜, OpenRouter 또는 OpenAI 호환 엔드포인트에서 실행됩니다. Sphinx 자체에는 호스팅 서비스가 없습니다.

대상 사용자

코딩 에이전트(Claude Code, Codex, Cursor, OpenCode, Pi 또는 일반 git push)를 사용하고 보호된 브랜치에 커밋되는 변경 사항을 이해하고 싶은 개발자. Node.js 22.19+, Git 및 macOS/Linux/WSL(Windows는 아직 지원되지 않음)이 필요합니다. 또한 리뷰어 모델 계정(예: 로그인된 Codex 또는 Claude Code CLI, OpenRouter 키 또는 OpenAI 호환 엔드포인트)이 있다고 가정합니다. 개인 연습 도구로 의도되었으며 보안 게이트가 아닙니다.

주요 기능

• 통과, 일시 중지 또는 건너뛸 때까지 Git 차단 — 일치하는 푸시는 최대 25분 동안 대기하며 나중에 재개할 수 있습니다.
• 개방형 질문은 동작 및 실패 모드를 다룹니다 — 파일 이름이 아니라 각 질문 옆에 탐색 가능한 diff와 리뷰어의 증거가 표시됩니다.
• 다양한 에이전트 및 제공업체에서 작동 — Claude Code, Codex, Cursor, OpenCode, Pi, 일반 git 및 모든 OpenAI 호환 엔드포인트.
• 저장소별 및 전역 정책 파일 — .sphinxconfig, .sphinxignore 및 .sphinxcontext.md를 사용하여 브랜치, 질문 깊이 및 리뷰어가 볼 수 있는 코드를 제어할 수 있습니다.
• 투명하고 제어 가능 — sphinx doctor는 설정을 확인하고, sphinx status는 최근 건너뛴 항목을 표시하며, 모델 호출을 제한하거나 사전 설정으로 모델을 전환할 수 있습니다.