Fusion ### De idea inicial a código en producción — automáticamente. ### 🏭 Una fábrica de software, gestionada por un orquestador multiagente. Describe lo que quieres — un equipo de agentes de IA lo **planifica, construye, revisa y entrega** por ti. Fusion es tu fábrica de software: una línea de montaje para el código que opera a través de tareas, agentes, misiones, git, archivos y worktrees, con cualquier modelo, local o en la nube. [**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR) [English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · **Español** · [한국어](./README.ko.md) *Esta es una traducción automática; el README en inglés es el documento canónico.* [![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) [![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) [![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) ![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) ![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg)
Demo de Fusion: de idea inicial a código en producción

Demo de Fusion: de idea inicial a código en producción

Panel de Fusion: columnas kanban de Planificación, Pendiente, En progreso, En revisión y Listo con tarjetas de tarea activas

--- ## Todo tu entorno de desarrollo. En una sola pantalla. Describe una tarea en lenguaje natural. Un agente de planificación lee tu proyecto, comprende el contexto y escribe un plan completo en `PROMPT.md` — pasos, alcance de archivos, criterios de aceptación. Luego Fusion planifica, revisa, ejecuta y vuelve a revisar, en un worktree de git aislado, con una aprobación humana donde tú la necesites. Un tablero. Controlado desde cualquier lugar. Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todo conectado. > Como Trello, pero tus tareas son especificadas, ejecutadas y entregadas por IA. Construido sobre el gran trabajo de [dustinbyrne/kb](https://github.com/dustinbyrne/kb). --- ## Inicio rápido **Sin instalación, directo desde npm:** ```bash npx runfusion.ai ``` Esto lanza el panel. Los subcomandos se pasan directamente: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (O de forma explícita: `npx @runfusion/fusion dashboard`.) **Instalador en una línea** (macOS y Linux — usa Homebrew automáticamente, recurre a npm como alternativa): ```bash curl -fsSL https://runfusion.ai/install.sh | sh fusion dashboard ``` **Homebrew** (macOS y Linux): ```bash brew install runfusion/fusion/fusion fusion dashboard # o: fn dashboard ``` La instalación con nombre completo hace auto-tap y, en Homebrew 6.0+, confía solo en la fórmula Fusion. Si ya ejecutaste `brew tap runfusion/fusion` y la instalación por nombre corto falla con “untrusted tap”, ejecuta `brew trust --formula runfusion/fusion/fusion` y luego `brew install fusion`. **npm global**: ```bash npm install -g @runfusion/fusion fn dashboard # o: fusion dashboard ``` **Desde un clon** (para desarrollo): ```bash pnpm dev dashboard ``` Luego haz clic en la URL `Open:` que aparece en la terminal. Incorpora un token de portador (`http://localhost:4040/?token=fn_...`) que el navegador guarda en `localStorage` en la primera visita y reutiliza automáticamente. En el lado del servidor, Fusion ahora persiste el token del panel/daemon en `~/.fusion/settings.json` en la primera ejecución autenticada y lo reutiliza en inicios posteriores a menos que lo sobreescribas (`--token`, `FUSION_DASHBOARD_TOKEN`, `FUSION_DAEMON_TOKEN`) o deshabilites la autenticación con `--no-auth`. Consulta [Referencia CLI → fn dashboard → Autenticación](./docs/cli-reference.md#fn-dashboard) para conocer la precedencia completa y las opciones de restablecimiento/revocación. ### Configuración inicial En el primer lanzamiento, Fusion abre el **asistente de incorporación** con tres pasos guiados: 1. **Configuración de IA** — Usa una lista de proveedores simplificada para el inicio rápido (proveedores recomendados más los ya conectados), luego expande la **Configuración avanzada de proveedores** solo si necesitas proveedores adicionales o detalles de configuración. Solo necesitas un proveedor para comenzar. Las entradas de proveedor obsoletas de Google Gemini CLI / Antigravity están intencionalmente ocultas; las rutas de clave API de Google/Gemini, Google Generative AI, Vertex y Cloud Code permanecen disponibles. 2. **GitHub (Opcional)** — Conecta GitHub para importar issues y gestionar PRs 3. **Primera tarea** — Crea tu primera tarea o impórtala desde GitHub (si no hay ningún proyecto activo, la incorporación primero te pedirá que registres/selecciones un directorio de proyecto) El asistente se puede **descartar y no bloquea** — haz clic en **Omitir por ahora** para usar el panel de inmediato. Vuélvelo a activar más tarde desde **Configuración → Autenticación → Reabrir guía de incorporación**. ### Móvil Para el flujo de trabajo con Capacitor + PWA, consulta [MOBILE.md](./MOBILE.md). --- ## El flujo ``` ① Describir ② Planificación ③ El tablero ④ Worktree aislado ───────────── ───────────── ───────────── ───────────────────── "Agregar modo → El agente escribe → Plan → Revisión → → rama fusion/FN-123 oscuro al PROMPT.md Ejecución → concurrente, cero panel de (pasos, alcance, Revisión (por conflictos de configuración" aceptación) paso, hasta archivos terminar) ``` ### Ve cada paso antes del merge

Detalle de tarea en Fusion: pasos del flujo visibles en una tarea en progreso con diffs y cambios de archivos

Cada tarea muestra su plan, sus revisiones, sus diffs y sus cambios de archivos en tiempo real. Entra a una tarea activa y ajusta la dirección, refina las restricciones, pausa o reescribe el prompt. --- ## Qué lo hace diferente | | | |---|---| | 🧠 **Planificación con IA** | Describe una tarea en lenguaje natural. Los agentes de planificación la convierten en un plan `PROMPT.md` con pasos, alcance de archivos y criterios de aceptación. | | 🔁 **Workflows seleccionables** | Los integrados cubren codificación, arreglos rápidos, trabajo con revisión intensa, ejecución paso a paso, Compound Engineering con plugin y fragmentos de ciclo de vida de PR. Elige un workflow por tarea o crea personalizados en el [Editor de workflows](./docs/workflow-editor.md). | | 🌳 **Aislamiento con worktrees** | Cada tarea corre en su propia rama y worktree (`fusion/{task-id}`). Tareas en paralelo. Cero conflictos. Delegación opcional a [worktrunk](https://github.com/max-sixty/worktrunk) mediante [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (ver [abstracción WorktreeBackend](./docs/architecture.md#worktreebackend-abstraction)). | | ⚡ **Controles de merge inteligente** | ¿Pasa todas las puertas? Fusion hace squash-merge y avanza. Puedes exigir aprobación manual, heredar el valor global de auto-merge o definir sobreescrituras por tarea. | | 🛰️ **Malla multinodo** | Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados. Escritorio, móvil, web. | | 🧩 **Cualquier modelo** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, runtimes locales y [proveedores personalizados](./docs/dashboard-guide.md#custom-providers). Local y nube coexisten, con canales de modelo/fallback configurables por workflow. | | 🏢 **Empresas de agentes** | Importa equipos predefinidos — más de 440 agentes en 16 empresas — y ejecútalos de forma autónoma durante semanas. | | 📬 **Mensajería entre agentes** | Buzón incorporado entre agentes. Delega, aclara, coordina. | | 🗨️ **Chat de agentes** | Chat directo, chat de tareas, adjuntos, tarjetas de preguntas en chat, streams reanudables y salas multiagente experimentales donde los miembros mencionados responden directamente y miembros ambientales pueden sumarse hasta un límite. ([Documentación de chat](./docs/dashboard-guide.md#chat-view)) | | 🗺️ **Misiones** | Planificación jerárquica (Misión → Hito → Slice → Característica → Tarea) con piloto automático y contratos de validación. | | 🔬 **Investigación** | Ejecuciones de investigación delimitadas con búsqueda web, GitHub, documentación local y síntesis con LLM (además de soporte integrado en tiempo de ejecución para WebSearch/WebFetch en flujos de planificación y síntesis cuando está disponible). Convierte los hallazgos en tareas. ([Documentación](./docs/research.md)) | | 🧪 **Automejora** | Los agentes reflexionan sobre su propio resultado y actualizan sus prompts a medida que aprenden tu base de código. | | 🔓 **Código abierto. MIT.** | Sin dependencia de proveedor. Ejecútalo en tu propio hardware. Se actualiza semanalmente. | --- ## Míralo en acción Las superficies más recientes de Fusion, de un vistazo — control de misión, workflows visuales, chat de agentes, salas multiagente y correo entre agentes. ### 🛰️ Command Center — control de misión para tu flota de agentes

Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs

Una sola pantalla para todo lo que hacen tus agentes. Ajusta en vivo la capacidad del planificador, observa el gasto de tokens por modelo en tiempo real y demuestra el valor con números concretos.

Tokens by model, token trend, and tokens-over-time charts

_{Tokens — gasto por modelo, en caché vs. entrada vs. salida, a lo largo del tiempo.}

Productivity: commits, human-hours saved, task duration percentiles, and files by language

_{Productividad — resultados, percentiles de duración, mezcla de lenguajes.}

Agent org chart with token share and tokens-by-agent breakdown

_{Equipo — organigrama de agentes y participación de tokens por agente.}

> Tokens · Herramientas · Actividad · Productividad · Equipo · Ecosistema · GitHub · Señales · Sistema · Fiabilidad · Control de misión — cada pestaña es una lente distinta sobre la misma flota en vivo. **La misma flota, a tu manera** — Command Center (y todo el panel) se re-estiliza en vivo en más de **70 temas de color**. Aquí está en Shadcn Light y Shadcn Dark Gray:

_{Shadcn Light}

_{Shadcn Dark Gray}

Una docena de temas claros y una docena de temas oscuros (clic para expandir)

Command Center across 12 light color themes

Command Center across 12 dark color themes

### 🔁 Workflows seleccionables, creados visualmente

Fusion Workflow Editor: switching between built-in workflow graphs

El recorrido de una tarea desde la idea hasta el merge es un **workflow** — y tú lo eliges y le das forma. Elige uno integrado (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering y más), inspecciona su grafo, luego duplícalo y personaliza columnas, puertas, canales de modelo y política de revisión en el [Editor de workflows](./docs/workflow-editor.md) visual. Sin necesidad de bifurcar el motor. Aquí está el grafo de **Stepwise coding** — planifica, ejecuta y revisa cada paso antes del siguiente — explorado nodo a nodo en Shadcn Light y Dark Gray:

_{Shadcn Light}

_{Shadcn Dark Gray}

### 🗨️ Chat de agentes — habla con tus agentes, en pleno vuelo

Fusion agent chat: a threaded conversation with an agent diagnosing a failed task

Chat directo y chat por tarea con cualquier agente, en cualquier modelo. Pregunta por qué falló una tarea, orienta un enfoque, suelta adjuntos, responde tarjetas de preguntas en chat y reanuda los streams donde los dejaste — con renderizado completo de markdown y código en todo momento.

_{Shadcn Light}

_{Shadcn Dark Gray}

### 👥 Salas de chat multiagente

Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads

Coloca varios agentes en una sala y deja que se coordinen. Menciona a un miembro y responde directamente; los miembros ambientales pueden sumarse a la conversación hasta un límite. Aquí los agentes **CEO**, **Product Manager** y **CTO** se alinean sobre la propiedad de la tarea en `#leads` — sin ningún humano en el bucle. ([Documentación de chat](./docs/dashboard-guide.md#chat-view))

_{Shadcn Light}

_{Shadcn Dark Gray}

### 📬 Correo de agentes — una bandeja de entrada entre tus agentes

Fusion mailbox: inter-agent messages with triage summaries and approvals

Un buzón incorporado para delegación, aclaraciones y traspasos. Los agentes registran resúmenes de triage, solicitan aprobaciones y coordinan el trabajo en toda la flota — con vistas de Bandeja de entrada, Bandeja de salida, Agentes y Aprobaciones, para que puedas auditar cada intercambio.

_{Shadcn Light}

_{Shadcn Dark Gray}

--- ## Cómo funciona ```mermaid graph TD H((Tú)) -->|idea inicial| T["Planificación
planificación automática"] T --> TD["Pendiente
programado para ejecución"] TD --> IP["En progreso
para cada paso:
planificar, revisar, ejecutar, revisar"] subgraph IP["En progreso"] direction TD NS([Iniciar paso]) --> P[Planificar] P --> R1{Revisar} R1 -->|revisar| P R1 -->|aprobar| E[Ejecutar] E --> R2{Revisar} R2 -->|revisar| E R2 -->|siguiente paso| NS R2 -->|repensar| P end R2 -->|listo| IR["En revisión
listo para merge,
o completado automáticamente"] IR -->|squash merge directo
o PR mergeado| D["Listo"] style H fill:#161b22,stroke:#8b949e,color:#e6edf3 style T fill:#2d2006,stroke:#d29922,color:#d29922 style TD fill:#0d2044,stroke:#58a6ff,color:#58a6ff style IP fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff style P fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3 style R1 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3 style E fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3 style R2 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3 style NS fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff style IR fill:#0d2d16,stroke:#3fb950,color:#3fb950 style D fill:#1a1a1a,stroke:#8b949e,color:#8b949e ``` Las tareas con dependencias se procesan secuencialmente. Las tareas independientes se ejecutan en paralelo. Opcionalmente puedes requerir aprobación manual antes de que las tareas pasen de Planificación a Pendiente (configuración `requirePlanApproval`). --- ## Resumen del flujo de trabajo Fusion workflows definen cómo una tarea pasa de una idea a una entrega. La ruta de codificación predeterminada sigue siendo el ciclo **Planificación/triage → Ejecución → Pasos del flujo → Revisión → Merge**, pero ahora la política vive en un workflow seleccionable en lugar de estar solo codificada en el motor. - **Selecciona por tarea:** elige un workflow desde los controles de workflow de la tarea/tablero, o asígnalo con `fn_workflow_select` / `workflow_id` al crear tareas. - **Catálogo integrado:** Coding (`builtin:coding`), Quick fix (`builtin:quick-fix`), Review-heavy (`builtin:review-heavy`), Compound engineering (`builtin:compound-engineering`, requiere plugin), Stepwise coding (`builtin:stepwise-coding`) y PR lifecycle (`builtin:pr-workflow`, un fragmento reutilizable de grafo de PR). - **Personaliza con seguridad:** inspecciona los workflows integrados, duplícalos o crea workflows personalizados en el [Editor de workflows](./docs/workflow-editor.md). Los ajustes específicos de workflow cubren canales de modelo, revisión/aprobación, ejecución de pasos, campos de tarea y columnas. Lee [Pasos del flujo](./docs/workflow-steps.md) para la semántica de ejecución y [Editor de workflows](./docs/workflow-editor.md) para la guía de autoría en el panel. --- ## Multinodo. Un tablero. Todas las plataformas.

Malla de Fusion: laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados

![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) ![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) ![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) ![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) ![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) ![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white)

Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — cada nodo es un par. El estado de tus tareas, agentes, registros y diffs permanecen sincronizados en toda la malla. El mismo Fusion se distribuye como: - 🖥️ **Aplicación de escritorio** — Electron para **macOS** (Intel + Apple Silicon), **Windows** 10/11 y **Linux** - 📱 **Aplicación móvil** — Capacitor para **iOS/iPadOS** y **Android** ([MOBILE.md](./MOBILE.md)) - 🌐 **Panel web** — cualquier navegador moderno, servido desde el daemon `fn dashboard` - 🔌 **CLI** — binario `fn` + extensión para flujos de trabajo centrados en la terminal Inicia el daemon en cualquier nodo, conecta tus otros dispositivos y el tablero te sigue a todas partes. --- ## Ejecuta una empresa de agentes

Empresa de agentes Fusion: importa un equipo y ejecútalo de forma autónoma durante semanas

Importa un equipo. Ejecútalo de forma autónoma durante semanas. **Más de 440 agentes en 16 empresas**, preparados para misiones, buzones y delegación entre agentes. ```bash npx companies.sh add paperclipai/companies/gstack ``` --- ## Compatible con las herramientas que ya usas. Fusion se integra con las herramientas que ya conoces. **Hermes**, **Paperclip** y **OpenClaw** vienen como plugins de primera clase — enruta cualquier espacio de trabajo al entorno de ejecución que mejor se adapte a la tarea. Y cualquier empresa de agentes de Paperclip se importa con un solo comando.

### [Hermes](https://hermes-agent.nousresearch.com) _{`experimental`} _{Nous Research} El agente autónomo de código abierto de **Nous Research**. Instala el plugin de Hermes y ejecuta agentes a través de Hermes para trabajos de larga duración con contexto creciente — enruta cualquier espacio de trabajo de Fusion hacia él. ### OpenClaw _{`experimental`} El soporte del entorno de ejecución de OpenClaw está disponible como plugin experimental (`fusion-plugin-openclaw-runtime`) para paridad en el descubrimiento y la configuración del entorno. Configura los agentes con `runtimeConfig.runtimeHint: "openclaw"` después de instalar el plugin.

### [Paperclip](https://paperclip.ing) _{`experimental`} _{paperclip.ing} El plano de control humano para la mano de obra de IA. Instala el plugin de Paperclip para ejecutar agentes a través de Paperclip dentro de Fusion. Fusion también soporta nativamente el estándar de empresa de agentes **[`companies.sh`](https://github.com/paperclipai/companies)**: importa un equipo predefinido — **más de 440 agentes en 16 empresas** — y déjalos coordinarse a través del buzón, las misiones y las puertas de flujo de Fusion durante semanas de trabajo autónomo. El mismo formato de empresa, los mismos agentes, las mismas habilidades que Paperclip. ```bash npx companies.sh add paperclipai/companies/gstack ```
> **Hermes**, **Paperclip** y **OpenClaw** son plugins de entorno de ejecución **experimentales** — las APIs y los formatos de comunicación pueden cambiar entre versiones menores. --- ## Documentación | Guía | Qué cubre | |---|---| | [Primeros pasos](./docs/getting-started.md) | Instalación, incorporación, primera tarea y selección básica de workflows | | [Guía del panel](./docs/dashboard-guide.md) | Vistas de tablero/lista, chat, editor de workflows, gestor de git, configuración y herramientas UI | | [Gestión de tareas](./docs/task-management.md) | Ciclo de vida, especificaciones de prompts, comentarios, archivado e integración con GitHub | | [Referencia CLI](./docs/cli-reference.md) | Referencia completa de comandos `fn` y daemon | | [Referencia de configuración](./docs/settings-reference.md) | Configuración global/proyecto, jerarquía de modelos, configuración de workflows y proveedores personalizados | | [Pasos del flujo](./docs/workflow-steps.md) | Runtime de workflows, integrados, puertas, plantillas y fases | | [Editor de workflows](./docs/workflow-editor.md) | Autoría visual, importación/exportación, campos/columnas/configuración y editor móvil | | [Investigación](./docs/research.md) | Ejecuciones de investigación, hallazgos, exportaciones e integración con tareas | | [Agentes](./docs/agents.md) | Gestión de agentes, spawning, latidos y buzones | | [Misiones](./docs/missions.md) | Jerarquía, planificación, piloto automático y contratos de validación | | [Gestión de plugins](./docs/plugin-management.md) | Descubrir, instalar, habilitar, configurar y solucionar plugins | | [Autoría de plugins](./docs/PLUGIN_AUTHORING.md) | Crear plugins con hooks, rutas, herramientas, runtimes y superficies de panel | | [Acceso remoto](./docs/remote-access.md) | Acceso remoto con token, Tailscale/Cloudflare y solución de problemas | | [Multiproyecto](./docs/multi-project.md) | Registro central, aislamiento y migraciones | | [Docker](./docs/docker.md) | Despliegue en contenedores | --- ## Características principales - **AI Planning** — Planning agent generates detailed `PROMPT.md` with steps, file scope, and acceptance criteria - **Step-by-step Execution** — Plan → Review → Execute → Review cycle for each task step, with graph-mode workflows able to model per-step parse/execute/review/rework explicitly - **Git Worktree Isolation** — Each task runs in its own worktree (`fusion/{task-id}` branch) - **Selectable workflows** — Pick Coding, Quick fix, Review-heavy, Stepwise coding, plugin-gated Compound Engineering, custom workflows, or PR lifecycle fragments where appropriate ([overview](#resumen-del-flujo-de-trabajo); [Workflow Steps](./docs/workflow-steps.md#resumen-del-flujo-de-trabajo)) - **Visual Workflow Editor** — Inspect read-only built-ins, duplicate/customize workflows, and edit graph nodes, columns, task fields, typed settings, and per-project values ([Workflow Editor](./docs/workflow-editor.md)) - **Workflow Steps** — Configurable quality gates (pre-merge blocks merge; post-merge informational), plus opt-in [Browser Verification](./docs/workflow-steps.md#workflow-declared-optional-steps) - **Workflow-native policy** — Fast-mode planning, typed triage thresholds, review/approval, step execution, and model/fallback lanes are workflow settings ([Settings Reference](./docs/settings-reference.md#workflow-settings)) - **GitHub + PR lifecycle** — Import issues, create PRs, display live PR/issue badges, and use workflow-mode PR lifecycle graph fragments where enabled - **Dashboard** — Real-time kanban/list/graph views, agent management, terminal, git manager, missions, chat, workflow editor, custom providers, and one-click updates - **Missions** — Hierarchical planning (Mission → Milestone → Slice → Feature → Task) with autopilot, validation contracts, fix-feature retries, mission-goal linking, and blocked handoffs - **Multi-Project** — Manage multiple projects from one installation with project isolation - **Custom Providers** — Add OpenAI-compatible, OpenAI Responses, Anthropic-compatible, or Google Generative AI providers; saved models appear in project and workflow model dropdowns ([Dashboard Guide](./docs/dashboard-guide.md#custom-providers)) - **Smart merge controls** — Global auto-merge stays live for default tasks, while explicit per-task overrides can force auto/manual behavior - **Inter-Agent Messaging** — Built-in messaging for coordination between agents and users; engineer-role agents can opt into backlog auto-claim - **Agent Chat + Chat Rooms** — Direct/task chat supports attachments, resumable streams, question response cards, and renameable conversations; experimental rooms route mentioned members as direct responders ([Dashboard Guide → Chat View](./docs/dashboard-guide.md#chat-view)) ### Autenticación de proveedores Fusion soporta autenticación basada en OAuth para proveedores de IA configurados en **Configuración → Autenticación**. Para la mayoría de los proveedores OAuth, cuando se accede al panel desde un host que no es localhost (nodo remoto, host/IP de LAN o proxy inverso), las URLs de inicio de sesión del proveedor se reescriben para enrutar los callbacks de OAuth a través de un endpoint puente (`/api/auth/oauth-callback`) de modo que las redirecciones lleguen a la sesión de navegador activa. - **Anthropic (Claude)** — Usa un flujo de código de autorización pegado en Configuración/incorporación: inicia sesión y pega la URL de redirección final (o el código) de vuelta en Fusion para completar el inicio de sesión - **OpenAI Codex** — Usa el mismo flujo de código de autorización pegado con validación segura de estado - **Factory AI — mediante Droid CLI** *(opcional)* — requiere instalación local de Droid CLI + `droid auth login`; la detección sigue la ruta efectiva del binario en tiempo de ejecución (predeterminado `droid`, o `droidBinaryPath` del plugin cuando está configurado), luego habilita en **Configuración → Autenticación** y reinicia Fusion - **llama.cpp — mediante servidor HTTP** *(opcional)* — configura la URL de tu servidor llama.cpp (predeterminado `http://127.0.0.1:8080`) y la clave API opcional, luego habilita en **Configuración → Autenticación** - **Otros proveedores** — Autentícate mediante entrada de clave API en Configuración (incluidas la clave API de Google/Gemini, Google Generative AI, Vertex y los alias de Cloud Code) ### Sistema de modelos Fusion usa una jerarquía de modelos de doble alcance con cinco canales independientes. La configuración global define los valores predeterminados de referencia; la configuración de proyecto proporciona sobreescrituras por proyecto. | Canal | Propósito | Claves de referencia global | Claves de sobreescritura por proyecto | |------|---------|---------------------|----------------------| | Executor | Agente de ejecución de tareas | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` | | Planning | Agente de planificación de tareas | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` | | Validator | Revisor de plan/código | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` | | Title Summarization | Generación automática de títulos | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` | | Workflow Step Refinement | Refinamiento de prompts con IA | (usa `defaultProvider`/`defaultModelId`) | (usa `modelProvider`/`modelId` en WorkflowStep) | **Canales de workflow:** El workflow predeterminado expone canales de modelo Plan/Triage, Executor, Reviewer y fallback en **Configuración → Modelos de proyecto**, y los workflows avanzados pueden declarar valores tipados adicionales ([Referencia de configuración](./docs/settings-reference.md#workflow-settings)). **Sobreescrituras por tarea:** Las tareas pueden sobreescribir los canales de executor, validator y planning con campos de modelo por tarea (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`). **Precedencia:** Por tarea → Sobreescritura de proyecto → Canal global → `defaultProvider`/`defaultModelId` → Resolución automática. Para la documentación completa de configuración, consulta la [Referencia de configuración](./docs/settings-reference.md). ### Tareas programadas / automatizaciones Fusion soporta automatización de tareas programadas a través de los endpoints `/api/automations`. Las automatizaciones pueden ejecutar comandos de shell o flujos de trabajo de múltiples pasos en un horario configurable. #### Alcance de la programación Las automatizaciones y rutinas pueden ejecutarse en dos alcances: - **Global** — Se ejecuta en todos los proyectos. Úsalo para mantenimiento entre proyectos, copias de seguridad o reportes unificados. - **Proyecto** — Se ejecuta solo dentro de un proyecto específico. Úsalo para CI, pruebas o tareas de despliegue específicas del proyecto. Cuando creas una programación sin elegir un alcance, Fusion usa por defecto el **alcance de proyecto** con el ID de proyecto `default` por compatibilidad con versiones anteriores. Para especificar un alcance de forma explícita: - En el modal de **Tareas programadas** del panel, usa el selector **Global / Proyecto**. - Mediante la API, pasa `?scope=global` o `?scope=project&projectId=` en los endpoints de automatización/rutina. **Reglas de resolución de alcance:** - `scope=global` siempre se resuelve en el canal de automatización/rutina global, independientemente del proyecto activo. - `scope=project` requiere un `projectId`. Si se omite, vuelve a `"default"`. - Las operaciones de CRUD, ejecución, activación/desactivación y webhook están estrictamente aisladas por alcance: una programación global no puede ser modificada desde una solicitud de alcance de proyecto, y viceversa. **Orientación operativa para configuraciones multiproyecto:** - Prefiere programaciones **globales** para infraestructura compartida (p. ej., copias de seguridad nocturnas, extracción de información de memoria). - Prefiere programaciones de **proyecto** para automatización por repositorio (p. ej., ejecutores de pruebas por proyecto, hooks de despliegue). - Los canales global y de proyecto son sondeados de forma independiente por el motor, por lo que las ejecuciones pendientes en un canal no bloquean al otro. #### Automatizaciones | Endpoint | Método | Descripción | |---------|--------|-------------| | `/api/automations` | GET | Listar todas las automatizaciones (filtradas por alcance si se especifica) | | `/api/automations` | POST | Crear automatización (el alcance predeterminado es `project`) | | `/api/automations/:id` | GET | Obtener automatización por ID | | `/api/automations/:id` | PATCH | Actualizar automatización | | `/api/automations/:id` | DELETE | Eliminar automatización | | `/api/automations/:id/run` | POST | Activar ejecución manual | | `/api/automations/:id/toggle` | POST | Activar/desactivar | | `/api/automations/:id/steps/reorder` | POST | Reordenar pasos de la automatización | #### Rutinas Las rutinas son tareas de agente de IA activadas por programaciones cron, webhooks o ejecución manual. Las rutinas comparten el mismo modelo de alcance global/proyecto que las automatizaciones. | Endpoint | Método | Descripción | |---------|--------|-------------| | `/api/routines` | GET | Listar todas las rutinas (filtradas por alcance si se especifica) | | `/api/routines` | POST | Crear rutina (el alcance predeterminado es `project`) | | `/api/routines/:id` | GET | Obtener rutina por ID | | `/api/routines/:id` | PATCH | Actualizar rutina | | `/api/routines/:id` | DELETE | Eliminar rutina | | `/api/routines/:id/run` | POST | Activar manualmente | | `/api/routines/:id/trigger` | POST | Activación manual canónica | | `/api/routines/:id/runs` | GET | Obtener historial de ejecuciones | | `/api/routines/:id/webhook` | POST | Activación por webhook (verificación de firma compatible) | --- ## Ejemplos rápidos de CLI ```bash fn task create "Fix the login bug" # Entrada rápida → planificación fn task plan "Build auth system" # Planificación guiada por IA fn task import owner/repo --labels bug # Importar issues de GitHub fn task show FN-001 # Ver detalles de la tarea fn task logs FN-001 --follow # Transmitir registros de ejecución fn task steer FN-001 "Use TypeScript" # Guiar al agente durante la ejecución fn project add my-app /path/to/app # Registrar un proyecto fn project list # Listar todos los proyectos fn settings set maxConcurrent 4 # Configurar ajustes fn settings export # Exportar configuración fn mission create "Auth System" "Build auth" # Crear misión fn mission activate-slice # Activar un slice fn skills search react # Buscar en skills.sh fn skills install firebase/agent-skills # Instalar habilidades de agente ``` --- ## Paquetes | Paquete | Descripción | |---------|-------------| | `@fusion/core` | Modelo de dominio — tareas, columnas del tablero, almacén SQLite | | `@fusion/dashboard` | Interfaz web — servidor Express + tablero kanban con SSE | | `@fusion/engine` | Motor de IA — planificación, ejecución, programación, pasos del flujo | | `@runfusion/fusion` | CLI + extensión — publicado en npm | --- ## Desarrollo ```bash pnpm install # Instalar dependencias pnpm local # Iniciar panel/API local en un puerto distinto al 4040 pnpm local -- --engine # Iniciar panel local con el motor de IA pnpm build # Compilar paquetes del espacio de trabajo predeterminado (excluye escritorio/móvil) pnpm build:all # Compilar todos los paquetes (incluyendo escritorio/móvil) pnpm dev dashboard # Ejecutar panel + motor de IA pnpm dev:ui # Solo el panel (sin motor de IA) pnpm lint # Verificar estilo de código en todos los paquetes pnpm typecheck # Verificar tipos en todos los paquetes pnpm test # Ejecutar todas las pruebas ``` ### Compilar un ejecutable independiente Compila un binario `fn` autocontenido usando [Bun](https://bun.sh/): ```bash pnpm build:exe # Compilar para la plataforma actual pnpm build:exe:all # Compilación cruzada para todas las plataformas ``` --- ## Licencia MIT — código abierto, sin dependencia de proveedor. Ver [LICENSE](./LICENSE).

**[runfusion.ai →](https://runfusion.ai)**