Conflux

Conflux es una herramienta que orquesta el desarrollo autónomo de agentes de codificación de IA basado en desarrollo guiado por especificaciones. Sin necesidad de supervisión humana constante, mantiene los cambios avanzando a través de todo el flujo: aplicación, validación de aceptación, archivado y fusión final.

El objetivo no es la generación puntual de código. La idea es definir primero la especificación y, a partir de ella, seguir acumulando cambios para hacer crecer de forma continua un producto terminado de cierta escala y pensado para uso real.

Además, Conflux no depende de un proveedor específico de IA. Está diseñado para poder intercambiar herramientas como Claude Code, Codex y OpenCode.

Conceptos básicos de Conflux

• Desarrollo autónomo que avanza mientras duermes: Aunque no haya una persona pendiente todo el tiempo, los agentes de IA procesan los cambios uno por uno y hacen avanzar el desarrollo.
• Desarrollo guiado por especificaciones: Con OpenSpec, primero se define la especificación y después se avanza en implementación, validación y mejora conforme a ella.
• Hacer crecer continuamente un producto terminado de cierta escala: No se queda en una generación puntual; Conflux acumula cambios y acerca progresivamente el proyecto a un producto completo.

Mecanismos que lo hacen posible

• Bucles Ralph múltiples: Mejora mediante iteraciones repetidas, manteniendo al mínimo el contexto que se transfiere en cada iteración para usar los LLM de forma más eficiente.
• Desarrollo en paralelo con git worktree: Al asignar un worktree independiente a cada change, Conflux permite avanzar con seguridad en varios cambios en paralelo.
• Elección de agentes independiente del proveedor: No queda atado a un proveedor concreto como Claude Code, Codex u OpenCode. Puedes sustituir los agentes de implementación o evaluación según el objetivo.
• Separación entre implementación y aceptación: Al separar el rol que impulsa la implementación del rol que valida el resultado, puedes combinar un codificador rápido con un revisor más inteligente. Así se aprovechan mejor los LLM y también se acelera el desarrollo en conjunto.

En resumen, Conflux es un orquestador para operar el desarrollo autónomo basado en especificaciones como un flujo de desarrollo práctico, con ejecución en paralelo y separación de roles, y para seguir impulsando de forma continua un producto terminado de cierta escala.

Uso principal

Uso	Comando
TUI	cflx
Ejecución headless	cflx run

Teclas útiles del TUI:

Tecla	Acción
Space	Marcar o desmarcar changes
F5	Iniciar, reanudar, reintentar o continuar el procesamiento
x	Poner en cola los changes not queued elegibles mientras el procesamiento está en marcha

Para la interfaz web de monitoreo, la API REST y /api/v2, consulta la guía de la Web UI (en inglés).

Inicio rápido

Para la configuración inicial, consulta QUICKSTART.es.md.

Comandos básicos

# TUI
cflx

# Ejecución headless
cflx run

# Ejecutar solo un cambio específico
cflx run --change add-feature-x

# Inicializar el archivo de configuración
cflx init

# Instalar bundled skills
cflx install-skills

# Instalar bundled skills para Claude Code
cflx install-skills --claude

# Instalar bundled skills globalmente para Claude Code
cflx install-skills --claude --global

Configuración

El archivo de configuración usa formato JSONC.

• .cflx.jsonc
• ~/.config/cflx/config.jsonc
• --config <PATH>

Las preferencias de usuario del TUI están separadas intencionalmente de la configuración de orquestación. La tecla predeterminada para iniciar, reanudar, reintentar o continuar es F5; para cambiar solo el binding local de inicio del TUI, usa ~/.config/cflx/tui.jsonc:

{
  "keybindings": {
    "start": ["F5", "!"]
  }
}

Generación de plantillas de configuración:

cflx init
cflx init --template opencode
cflx init --template codex
cflx init --force

Para ejemplos detallados de configuración, hooks, ejecución en workspaces y la cola de comandos, consulta docs/guides/USAGE.md.

Instalación

cargo install cflx

Documentación

Documento	Descripción
QUICKSTART.es.md	Configuración inicial
Guía de la Web UI (en inglés)	Web UI, API REST, /api/v2, migración desde el modo servidor
README.md	Documentación completa (inglés)
docs/guides/USAGE.md	Ejemplos de uso
CONTRIBUTING.md	Guía de contribución
docs/guides/DEVELOPMENT.md	Guía de desarrollo
docs/guides/RELEASE.md	Guía de lanzamiento
cflx openapi / GET /api/v2/openapi.yaml	Contrato canónico de /api/v2 (generado en tiempo de ejecución; no se versiona en el repositorio)

Licencia

MIT