Sphinx es un hook de Git diseñado para el desarrollo asistido por agentes de inteligencia artificial. Su función principal es interrumpir el proceso de envío de código (push) para solicitar al desarrollador que explique la lógica detrás de las modificaciones antes de que el código se integre en el repositorio. Esta herramienta busca mitigar el riesgo de que los agentes de IA generen código incorrecto o ineficiente, asegurando que el humano comprenda el impacto de los cambios, especialmente en escenarios de error.
La herramienta está construida para operar con un mínimo de tokens y es compatible con agentes de codificación existentes, como Codex, Claude Code, Cursor y OpenCode, así como con endpoints compatibles con OpenAI. Sphinx funciona como un manejador de webhooks que gestiona eventos de pago, evitando errores comunes como la facturación doble en caso de reintentos de Stripe. El sistema garantiza que las respuestas del desarrollador no se compartan con el agente de codificación y que las claves de API no se expongan en archivos de entorno.
El proceso de uso es sencillo: el desarrollador instala Sphinx mediante npm, conecta Git y los agentes de IA, y activa la revisión. Cuando se realiza un push, Sphinx analiza la diferencia (diff) y pregunta qué hace el código cuando ocurre un fallo. Si la respuesta es correcta, el push continúa; si es incorrecta, el desarrollador debe corregir su comprensión. Sphinx incluye una función de 'yolo' para permitir pushes rápidos sin revisión, aunque cada omisión se registra para auditoría. La herramienta requiere Node.js 22.19 o superior y funciona en macOS, Linux y WSL.