Sobre el proyecto

Commitarium proporciona un entorno local-first para orquestar agentes de codificación que planifican, implementan y revisan software juntos. El sistema se basa en un coordinador que gestiona proyectos, características, transiciones de flujo de trabajo y sesiones de agentes, almacenando el estado operativo en SQLite. Admite tanto un modo de simulación determinista para pruebas como un modo de inclusión voluntaria con agentes de IA reales (Codex o Claude). En el modo de agente real, el coordinador se conecta a conversaciones persistentes con los agentes líderes y revisores seleccionados. El flujo de trabajo implica la clarificación de objetivos, la planificación, la implementación y los ciclos de revisión. El sistema se integra con Forgejo, una forja de Git auto-alojada, para servir como la fuente de verdad para los planes, las revisiones y las solicitudes de extracción. Cada agente opera con su propia identidad de Forgejo con alcance, asegurando una pista de auditoría de commits y trabajo de PR estructurado. El coordinador verifica las salidas de los agentes, como los hashes de commit y las cabezas de PR, antes de avanzar en el flujo de trabajo. La arquitectura normalmente se ejecuta a través de Docker Compose con servicios para el coordinador, Forgejo y los agentes trabajadores. Admite perfiles de proveedor aislados para Codex y Claude, permitiendo la autenticación y configuración independientes. El sistema incluye características para la recuperación de reinicio, donde las sesiones activas se pueden reanudar después de un reinicio del coordinador. También ofrece capacidades de importación de proyectos, permitiendo a los usuarios asociar repositorios de Git existentes con el espacio de trabajo. El diseño enfatiza el control del usuario, con opciones para la aprobación automática o manual de fusiones y pasos del flujo de trabajo.