-
-
-# Fusion
+# Fusion
### De idea inicial a código en producción — automáticamente.
-**Orquestador de agentes multinodo** — tareas, agentes, misiones, git, archivos y worktrees, con cualquier modelo, local o en la nube.
+### 🏭 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)
@@ -45,6 +45,72 @@ Un tablero. Controlado desde cualquier lugar. Laptop, Mac mini, servidor Linux,
---
+## 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 tap runfusion/fusion
+brew install fusion
+fusion dashboard # o: fn dashboard
+```
+
+O en una sola línea (añade el tap automáticamente): `brew install runfusion/fusion/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
```
@@ -87,6 +153,122 @@ Cada tarea muestra su plan, sus revisiones, sus diffs y sus cambios de archivos
---
+## 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
+
+
+
+
+
+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 — gasto por modelo, en caché vs. entrada vs. salida, a lo largo del tiempo.
+
Productividad — resultados, percentiles de duración, mezcla de lenguajes.
+
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)
+
+
+
+
+
+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
+
+
+
+
+
+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
+
+
+
+
+
+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
+
+
+
+
+
+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
@@ -225,72 +407,6 @@ npx companies.sh add paperclipai/companies/gstack
---
-## 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 tap runfusion/fusion
-brew install fusion
-fusion dashboard # o: fn dashboard
-```
-
-O en una sola línea (añade el tap automáticamente): `brew install runfusion/fusion/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).
-
----
-
## Documentación
| Guía | Qué cubre |
diff --git a/README.fr.md b/README.fr.md
index 1cb4a030a4..8104b42cf9 100644
--- a/README.fr.md
+++ b/README.fr.md
@@ -1,12 +1,12 @@
-
-
-# Fusion
+# Fusion
### De l'idée brute au code de production — automatiquement.
-**Orchestrateur d'agents multi-nœuds** — tâches, agents, missions, git, fichiers et worktrees, avec n'importe quel modèle, local ou cloud.
+### 🏭 Une usine logicielle, pilotée par un orchestrateur multi-agents.
+
+Décrivez ce que vous voulez — une équipe d'agents IA le **planifie, le construit, le révise et le livre** pour vous. Fusion est votre usine logicielle : une chaîne de montage pour le code qui s'étend sur les tâches, les agents, les missions, git, les fichiers et les worktrees, avec n'importe quel modèle, local ou cloud.
[**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)
@@ -45,6 +45,73 @@ Un tableau. Contrôlé de n'importe où. Laptop, Mac mini, serveur Linux, VM clo
---
+## Démarrage rapide
+
+**Sans installation, directement depuis npm :**
+
+```bash
+npx runfusion.ai
+```
+
+Cela lance le tableau de bord. Les sous-commandes passent directement : `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Ou de façon verbeuse : `npx @runfusion/fusion dashboard`.)
+
+**Installateur en une ligne** (macOS et Linux — choisit automatiquement Homebrew, bascule sur npm en secours) :
+
+```bash
+curl -fsSL https://runfusion.ai/install.sh | sh
+fusion dashboard
+```
+
+**Homebrew** (macOS et Linux) :
+
+```bash
+brew tap runfusion/fusion
+brew install fusion
+fusion dashboard # ou : fn dashboard
+```
+
+Ou en une ligne (tap automatique) : `brew install runfusion/fusion/fusion`.
+
+**npm global** :
+
+```bash
+npm install -g @runfusion/fusion
+fn dashboard # ou : fusion dashboard
+```
+
+**Depuis un clone** (pour le développement) :
+
+```bash
+pnpm dev dashboard
+```
+
+Cliquez ensuite sur l'URL `Open:` affichée dans le terminal. Elle intègre un jeton bearer
+(`http://localhost:4040/?token=fn_...`) que le navigateur capture dans
+`localStorage` à la première visite et réutilise automatiquement par la suite. Côté
+serveur, Fusion persiste désormais le jeton du tableau de bord/démon dans
+`~/.fusion/settings.json` à la première exécution authentifiée et le réutilise
+lors des démarrages ultérieurs, sauf si vous le remplacez (`--token`,
+`FUSION_DASHBOARD_TOKEN`, `FUSION_DAEMON_TOKEN`) ou désactivez l'authentification
+avec `--no-auth`. Voir
+[Référence CLI → fn dashboard → Authentification](./docs/cli-reference.md#fn-dashboard)
+pour la précédence complète et les options de réinitialisation/révocation.
+
+### Configuration au premier lancement
+
+Au premier lancement, Fusion ouvre l'**assistant d'intégration** en trois étapes guidées :
+
+1. **Configuration IA** — Utilisez la liste simplifiée de fournisseurs de démarrage rapide (fournisseurs recommandés et fournisseurs déjà connectés), puis développez les **Paramètres avancés du fournisseur** uniquement si vous avez besoin de fournisseurs supplémentaires ou de détails de configuration. Un seul fournisseur suffit pour commencer. Les entrées de fournisseurs dépréciés Google Gemini CLI / Antigravity sont intentionnellement masquées ; les chemins clé API Google/Gemini, Google Generative AI, Vertex et Cloud Code restent pris en charge.
+2. **GitHub (optionnel)** — Connectez GitHub pour l'import de tickets et la gestion des PR
+3. **Première tâche** — Créez votre première tâche ou importez depuis GitHub (si aucun projet n'est actif, l'assistant vous invite d'abord à enregistrer/sélectionner un répertoire de projet)
+
+L'assistant est **dismissable et non bloquant** — cliquez sur **Ignorer pour l'instant** pour utiliser le tableau de bord immédiatement. Relancez-le plus tard depuis **Paramètres → Authentification → Rouvrir le guide d'intégration**.
+
+### Mobile
+
+Pour le workflow Capacitor + PWA, voir [MOBILE.md](./MOBILE.md).
+
+---
+
## Le flux
```
@@ -71,13 +138,13 @@ Chaque tâche affiche son plan, ses révisions, ses diffs et ses modifications d
| | |
|---|---|
| 🧠 **Planification IA** | Décrivez une tâche en langage naturel. Les agents de planification la transforment en plan `PROMPT.md` avec étapes, périmètre des fichiers et critères d'acceptation. |
-| 🔁 **Portes de workflow** | Plan → Révision → Exécution → Révision à chaque étape. Les portes pré-fusion bloquent le mauvais code ; les portes post-fusion effectuent des vérifications informatives. |
+| 🔁 **Workflows sélectionnables** | Les workflows intégrés couvrent le codage, les correctifs rapides, le travail à forte révision, l'exécution par étapes, le Compound Engineering activé par plugin et les fragments de cycle de vie de PR. Choisissez un workflow par tâche ou créez-en des personnalisés dans l'[Éditeur de workflows](./docs/workflow-editor.md). |
| 🌳 **Isolation par worktree** | Chaque tâche s'exécute dans sa propre branche et son propre worktree (`fusion/{task-id}`). Tâches parallèles. Zéro conflit. Délégation [worktrunk](https://github.com/max-sixty/worktrunk) optionnelle via [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (voir [abstraction WorktreeBackend](./docs/architecture.md#worktreebackend-abstraction)). |
-| ⚡ **Fusion intelligente** | Toutes les portes franchies ? Fusion effectue un squash-merge et passe à la suite. Activez la validation manuelle où vous le souhaitez. |
+| ⚡ **Fusion intelligente** | Toutes les portes franchies ? Fusion effectue un squash-merge et passe à la suite. Activez la validation manuelle où vous le souhaitez, héritez du défaut global d'auto-fusion en direct, ou définissez des remplacements auto/manuel explicites par tâche. |
| 🛰️ **Maillage multi-nœuds** | Laptop, Mac mini, serveur Linux, VM cloud, téléphone — tout synchronisé. Bureau, mobile, web. |
-| 🧩 **N'importe quel modèle** | Anthropic, OpenAI, Ollama et plus encore. Local et cloud coexistent. |
+| 🧩 **N'importe quel modèle** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, runtimes locaux et [fournisseurs personnalisés](./docs/dashboard-guide.md#custom-providers) définis par l'utilisateur. Local et cloud coexistent, avec des voies de modèle/fallback de workflow configurables par projet. |
| 🏢 **Entreprises d'agents** | Importez des équipes prédéfinies — plus de 440 agents répartis dans 16 entreprises — et faites-les fonctionner de façon autonome pendant des semaines. |
-| 📬 **Messagerie inter-agents** | Boîte aux lettres intégrée entre agents. Déléguer, clarifier, coordonner. |
+| 📬 **Messagerie inter-agents** | Boîte aux lettres intégrée entre agents. Déléguer, clarifier, coordonner ; les agents au rôle d'ingénieur peuvent activer la réclamation automatique du backlog quand vous voulez de l'aide à l'implémentation au-delà du retrait réservé à l'exécuteur. |
| 🗨️ **Chat d’agents** | Chat direct, chat de tâche, pièces jointes, cartes de questions, flux reprenables et salles multi-agents expérimentales où les membres mentionnés répondent directement et les membres ambiants peuvent participer jusqu’à un plafond. ([Docs Chat](./docs/dashboard-guide.md#chat-view)) |
| 🗺️ **Missions** | Planification hiérarchique (Mission → Jalon → Tranche → Fonctionnalité → Tâche) avec pilotage automatique et contrats de validation. |
| 🔬 **Recherche** | Exécutions de recherche délimitées avec recherche web, GitHub, docs locaux et synthèse LLM (plus prise en charge intégrée de WebSearch/WebFetch dans les flux de planification et de synthèse lorsque disponible). Transformez les résultats en tâches. ([Docs](./docs/research.md)) |
@@ -86,6 +153,122 @@ Chaque tâche affiche son plan, ses révisions, ses diffs et ses modifications d
---
+## Voir en action
+
+
+
+Les surfaces les plus récentes de Fusion, en un coup d'œil — contrôle de mission, workflows visuels, chat d'agents, salles multi-agents et messagerie inter-agents.
+
+### 🛰️ Command Center — le contrôle de mission de votre flotte d'agents
+
+
+
+
+
+Un seul écran pour tout ce que font vos agents. Ajustez la capacité du planificateur en direct, suivez la dépense de tokens par modèle en temps réel et prouvez la valeur avec des chiffres concrets.
+
+
+
+
Tokens — dépense par modèle, en cache vs. entrée vs. sortie, dans le temps.
+
Productivité — résultats, percentiles de durée, mix de langages.
+
Équipe — organigramme des agents et part de tokens par agent.
+
+
+
+> Tokens · Outils · Activité · Productivité · Équipe · Écosystème · GitHub · Signaux · Système · Fiabilité · Mission Control — chaque onglet est un angle différent sur la même flotte en direct.
+
+**La même flotte, à votre façon** — Command Center (et tout le tableau de bord) se re-thématise en direct sur **plus de 70 thèmes de couleurs**. Le voici en Shadcn Light et Shadcn Dark Gray :
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+
+Une douzaine de thèmes clairs & une douzaine de thèmes sombres (cliquer pour développer)
+
+
+
+
+
+Le parcours d'une tâche, de l'idée à la fusion, est un **workflow** — et c'est à vous de le choisir et de le façonner. Choisissez un workflow intégré (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering et plus encore), inspectez son graphe, puis dupliquez et personnalisez les colonnes, les portes, les voies de modèle et la politique de révision dans l'[Éditeur de workflows](./docs/workflow-editor.md) visuel. Aucun fork du moteur requis.
+
+Voici le graphe **Stepwise coding** — planifier, exécuter et réviser chaque étape avant la suivante — exploré nœud par nœud en Shadcn Light et Dark Gray :
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 🗨️ Chat d'agents — parlez à vos agents, en plein vol
+
+
+
+
+
+Chat direct et chat par tâche avec n'importe quel agent, sur n'importe quel modèle. Demandez pourquoi une tâche a échoué, orientez une approche, déposez des pièces jointes, répondez aux cartes de questions intégrées et reprenez les flux là où vous les avez laissés — rendu complet du markdown et du code de bout en bout.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 👥 Salles de chat multi-agents
+
+
+
+
+
+Placez plusieurs agents dans une salle et laissez-les se coordonner. Mentionnez un membre et il répond directement ; les membres ambiants peuvent rejoindre la conversation jusqu'à un plafond. Ici, les agents **CEO**, **Product Manager** et **CTO** s'accordent sur l'attribution des tâches dans `#leads` — sans humain dans la boucle. ([Docs Chat](./docs/dashboard-guide.md#chat-view))
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 📬 Messagerie d'agents — une boîte de réception entre vos agents
+
+
+
+
+
+Une boîte aux lettres intégrée pour la délégation, la clarification et les passations. Les agents déposent des résumés de triage, demandent des approbations et coordonnent le travail à travers la flotte — avec les vues Boîte de réception, Boîte d'envoi, Agents et Approbations, pour que vous puissiez auditer chaque échange.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+---
+
## Comment ça fonctionne
```mermaid
@@ -224,73 +407,6 @@ npx companies.sh add paperclipai/companies/gstack
---
-## Démarrage rapide
-
-**Sans installation, directement depuis npm :**
-
-```bash
-npx runfusion.ai
-```
-
-Cela lance le tableau de bord. Les sous-commandes passent directement : `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Ou de façon verbeuse : `npx @runfusion/fusion dashboard`.)
-
-**Installateur en une ligne** (macOS et Linux — choisit automatiquement Homebrew, bascule sur npm en secours) :
-
-```bash
-curl -fsSL https://runfusion.ai/install.sh | sh
-fusion dashboard
-```
-
-**Homebrew** (macOS et Linux) :
-
-```bash
-brew tap runfusion/fusion
-brew install fusion
-fusion dashboard # ou : fn dashboard
-```
-
-Ou en une ligne (tap automatique) : `brew install runfusion/fusion/fusion`.
-
-**npm global** :
-
-```bash
-npm install -g @runfusion/fusion
-fn dashboard # ou : fusion dashboard
-```
-
-**Depuis un clone** (pour le développement) :
-
-```bash
-pnpm dev dashboard
-```
-
-Cliquez ensuite sur l'URL `Open:` affichée dans le terminal. Elle intègre un jeton bearer
-(`http://localhost:4040/?token=fn_...`) que le navigateur capture dans
-`localStorage` à la première visite et réutilise automatiquement par la suite. Côté
-serveur, Fusion persiste désormais le jeton du tableau de bord/démon dans
-`~/.fusion/settings.json` à la première exécution authentifiée et le réutilise
-lors des démarrages ultérieurs, sauf si vous le remplacez (`--token`,
-`FUSION_DASHBOARD_TOKEN`, `FUSION_DAEMON_TOKEN`) ou désactivez l'authentification
-avec `--no-auth`. Voir
-[Référence CLI → fn dashboard → Authentification](./docs/cli-reference.md#fn-dashboard)
-pour la précédence complète et les options de réinitialisation/révocation.
-
-### Configuration au premier lancement
-
-Au premier lancement, Fusion ouvre l'**assistant d'intégration** en trois étapes guidées :
-
-1. **Configuration IA** — Utilisez la liste simplifiée de fournisseurs de démarrage rapide (fournisseurs recommandés et fournisseurs déjà connectés), puis développez les **Paramètres avancés du fournisseur** uniquement si vous avez besoin de fournisseurs supplémentaires ou de détails de configuration. Un seul fournisseur suffit pour commencer. Les entrées de fournisseurs dépréciés Google Gemini CLI / Antigravity sont intentionnellement masquées ; les chemins clé API Google/Gemini, Google Generative AI, Vertex et Cloud Code restent pris en charge.
-2. **GitHub (optionnel)** — Connectez GitHub pour l'import de tickets et la gestion des PR
-3. **Première tâche** — Créez votre première tâche ou importez depuis GitHub (si aucun projet n'est actif, l'assistant vous invite d'abord à enregistrer/sélectionner un répertoire de projet)
-
-L'assistant est **dismissable et non bloquant** — cliquez sur **Ignorer pour l'instant** pour utiliser le tableau de bord immédiatement. Relancez-le plus tard depuis **Paramètres → Authentification → Rouvrir le guide d'intégration**.
-
-### Mobile
-
-Pour le workflow Capacitor + PWA, voir [MOBILE.md](./MOBILE.md).
-
----
-
## Documentation
| Guide | Ce qu'il couvre |
diff --git a/README.ko.md b/README.ko.md
index 9b8026f4d6..76abbb1e3b 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -1,12 +1,12 @@
-
-
-# Fusion
+# Fusion
### 거친 아이디어에서 프로덕션 코드까지 — 자동으로.
-**멀티 노드 에이전트 오케스트레이터** — 태스크, 에이전트, 미션, git, 파일, 워크트리를 어떤 모델에서도, 로컬 또는 클라우드에서 실행합니다.
+### 🏭 멀티 에이전트 오케스트레이터가 운영하는 소프트웨어 공장.
+
+원하는 것을 설명하세요 — AI 에이전트 팀이 **계획하고, 만들고, 검토하고, 배포**해 드립니다. Fusion은 여러분의 소프트웨어 공장입니다: 태스크, 에이전트, 미션, git, 파일, 워크트리를 가로질러 어떤 모델로든, 로컬 또는 클라우드에서 실행되는 코드 조립 라인입니다.
[**runfusion.ai →**](https://runfusion.ai) · [문서](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
@@ -45,6 +45,72 @@
---
+## 빠른 시작
+
+**설치 없이 npm에서 바로:**
+
+```bash
+npx runfusion.ai
+```
+
+이 명령은 대시보드를 실행합니다. 하위 명령은 다음과 같이 전달됩니다: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help` 등. (또는 명시적으로: `npx @runfusion/fusion dashboard`.)
+
+**원라인 설치 프로그램** (macOS & Linux — Homebrew를 자동 선택하고, 없으면 npm으로 대체):
+
+```bash
+curl -fsSL https://runfusion.ai/install.sh | sh
+fusion dashboard
+```
+
+**Homebrew** (macOS & Linux):
+
+```bash
+brew tap runfusion/fusion
+brew install fusion
+fusion dashboard # 또는: fn dashboard
+```
+
+또는 원라인(자동 탭 추가): `brew install runfusion/fusion/fusion`.
+
+**npm 전역 설치**:
+
+```bash
+npm install -g @runfusion/fusion
+fn dashboard # 또는: fusion dashboard
+```
+
+**클론으로 시작** (개발용):
+
+```bash
+pnpm dev dashboard
+```
+
+터미널에 출력되는 `Open:` URL을 클릭하세요. URL에는 베어러 토큰
+(`http://localhost:4040/?token=fn_...`)이 포함되어 있으며, 브라우저가 첫 방문 시
+`localStorage`에 캡처하여 이후 자동으로 재사용합니다. 서버 측에서 Fusion은
+첫 번째 인증된 실행 시 `~/.fusion/settings.json`에 대시보드/데몬 토큰을
+저장하고, 이후 시작 시 재사용합니다(`--token`, `FUSION_DASHBOARD_TOKEN`,
+`FUSION_DAEMON_TOKEN`으로 재정의하거나 `--no-auth`로 인증을 비활성화하지 않는 한).
+전체 우선순위 및 재설정/취소 옵션은
+[CLI 참조 → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)을
+참조하세요.
+
+### 최초 실행 설정
+
+Fusion을 처음 시작하면 세 단계로 안내하는 **온보딩 마법사**가 열립니다:
+
+1. **AI 설정** — 간소화된 빠른 시작 공급자 목록(권장 공급자 및 이미 연결된 공급자)을 사용하고, 추가 공급자나 설정 세부 사항이 필요한 경우에만 **고급 공급자 설정**을 펼칩니다. 시작하려면 공급자 하나만 있으면 됩니다. 더 이상 사용되지 않는 Google Gemini CLI / Antigravity 공급자 항목은 의도적으로 숨겨져 있으며, Google/Gemini API 키, Google Generative AI, Vertex, Cloud Code 경로는 계속 지원됩니다.
+2. **GitHub (선택 사항)** — 이슈 임포트 및 PR 관리를 위해 GitHub 연결
+3. **첫 번째 태스크** — 첫 번째 태스크를 생성하거나 GitHub에서 임포트(활성 프로젝트가 없는 경우, 온보딩이 먼저 프로젝트 디렉터리 등록/선택을 안내합니다)
+
+마법사는 **해제 가능하며 비차단적** — **지금 건너뛰기**를 클릭하면 즉시 대시보드를 사용할 수 있습니다. 나중에 **설정 → 인증 → 온보딩 가이드 다시 열기**에서 재실행할 수 있습니다.
+
+### 모바일
+
+Capacitor + PWA 워크플로우는 [MOBILE.md](./MOBILE.md)를 참조하세요.
+
+---
+
## 흐름
```
@@ -86,6 +152,122 @@
---
+## 실제 동작 모습
+
+
+
+Fusion의 최신 화면들을 한눈에 — 미션 컨트롤, 시각적 워크플로, 에이전트 채팅, 멀티 에이전트 룸, 에이전트 간 메일.
+
+### 🛰️ Command Center — 에이전트 플릿을 위한 미션 컨트롤
+
+
+
+
+
+에이전트들이 하는 모든 일을 위한 한 화면. 실시간 스케줄러 용량을 조정하고, 모델별 토큰 소비를 실시간으로 지켜보며, 확실한 수치로 가치를 입증하세요.
+
+
+
+
토큰 — 모델별 소비, 캐시 대 입력 대 출력, 시간 경과별.
+
생산성 — 성과, 소요 시간 백분위, 언어 구성.
+
팀 — 에이전트 조직도와 에이전트별 토큰 점유율.
+
+
+
+> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control — 모든 탭은 동일한 라이브 플릿을 바라보는 서로 다른 렌즈입니다.
+
+**동일한 플릿, 당신의 방식대로** — Command Center(그리고 대시보드 전체)는 **70개 이상의 색상 테마**로 실시간 리스킨됩니다. 여기 Shadcn Light와 Shadcn Dark Gray로 표시된 모습입니다:
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+
+12가지 라이트 테마 & 12가지 다크 테마 (클릭하여 펼치기)
+
+
+
+
+
+
+
+
+
+
+
+### 🔁 시각적으로 작성하는 선택 가능한 워크플로
+
+
+
+
+
+태스크가 아이디어에서 머지까지 거치는 여정이 곧 **워크플로**이며 — 직접 선택하고 다듬을 수 있습니다. 내장 워크플로(Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering 등)를 고르고, 그래프를 살펴본 뒤, 시각적 [워크플로 편집기](./docs/workflow-editor.md)에서 복제하여 컬럼, 게이트, 모델 레인, 검토 정책을 커스터마이즈하세요. 엔진 포크는 필요 없습니다.
+
+다음은 **Stepwise coding** 그래프입니다 — 다음 단계로 넘어가기 전에 모든 단계를 계획, 실행, 검토합니다 — Shadcn Light와 Dark Gray에서 노드별로 살펴봅니다:
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 🗨️ 에이전트 채팅 — 실행 중인 에이전트와 대화
+
+
+
+
+
+어떤 모델에서든 어떤 에이전트와도 직접 채팅 및 태스크별 채팅을 할 수 있습니다. 태스크가 왜 실패했는지 묻고, 접근 방식을 조정하고, 첨부파일을 넣고, 인채팅 질문 카드에 답하고, 멈췄던 지점에서 스트림을 재개하세요 — 전체에 걸쳐 완전한 마크다운 및 코드 렌더링을 지원합니다.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 👥 멀티 에이전트 채팅 룸
+
+
+
+
+
+여러 에이전트를 한 룸에 넣고 서로 조율하게 하세요. 구성원을 언급하면 직접 응답하고, 주변 구성원은 제한 내에서 대화에 참여할 수 있습니다. 여기서는 **CEO**, **Product Manager**, **CTO** 에이전트가 `#leads`에서 태스크 소유권을 정렬합니다 — 사람의 개입 없이. ([채팅 문서](./docs/dashboard-guide.md#chat-view))
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 📬 에이전트 메일 — 에이전트 간 받은편지함
+
+
+
+
+
+위임, 확인, 인계를 위한 내장 메일박스. 에이전트는 트리아지 요약을 제출하고, 승인을 요청하고, 플릿 전반에 걸쳐 작업을 조율합니다 — Inbox, Outbox, Agents, Approvals 보기를 제공하여 모든 교환을 감사할 수 있습니다.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+---
+
## 작동 방식
```mermaid
@@ -224,72 +406,6 @@ npx companies.sh add paperclipai/companies/gstack
---
-## 빠른 시작
-
-**설치 없이 npm에서 바로:**
-
-```bash
-npx runfusion.ai
-```
-
-이 명령은 대시보드를 실행합니다. 하위 명령은 다음과 같이 전달됩니다: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help` 등. (또는 명시적으로: `npx @runfusion/fusion dashboard`.)
-
-**원라인 설치 프로그램** (macOS & Linux — Homebrew를 자동 선택하고, 없으면 npm으로 대체):
-
-```bash
-curl -fsSL https://runfusion.ai/install.sh | sh
-fusion dashboard
-```
-
-**Homebrew** (macOS & Linux):
-
-```bash
-brew tap runfusion/fusion
-brew install fusion
-fusion dashboard # 또는: fn dashboard
-```
-
-또는 원라인(자동 탭 추가): `brew install runfusion/fusion/fusion`.
-
-**npm 전역 설치**:
-
-```bash
-npm install -g @runfusion/fusion
-fn dashboard # 또는: fusion dashboard
-```
-
-**클론으로 시작** (개발용):
-
-```bash
-pnpm dev dashboard
-```
-
-터미널에 출력되는 `Open:` URL을 클릭하세요. URL에는 베어러 토큰
-(`http://localhost:4040/?token=fn_...`)이 포함되어 있으며, 브라우저가 첫 방문 시
-`localStorage`에 캡처하여 이후 자동으로 재사용합니다. 서버 측에서 Fusion은
-첫 번째 인증된 실행 시 `~/.fusion/settings.json`에 대시보드/데몬 토큰을
-저장하고, 이후 시작 시 재사용합니다(`--token`, `FUSION_DASHBOARD_TOKEN`,
-`FUSION_DAEMON_TOKEN`으로 재정의하거나 `--no-auth`로 인증을 비활성화하지 않는 한).
-전체 우선순위 및 재설정/취소 옵션은
-[CLI 참조 → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)을
-참조하세요.
-
-### 최초 실행 설정
-
-Fusion을 처음 시작하면 세 단계로 안내하는 **온보딩 마법사**가 열립니다:
-
-1. **AI 설정** — 간소화된 빠른 시작 공급자 목록(권장 공급자 및 이미 연결된 공급자)을 사용하고, 추가 공급자나 설정 세부 사항이 필요한 경우에만 **고급 공급자 설정**을 펼칩니다. 시작하려면 공급자 하나만 있으면 됩니다. 더 이상 사용되지 않는 Google Gemini CLI / Antigravity 공급자 항목은 의도적으로 숨겨져 있으며, Google/Gemini API 키, Google Generative AI, Vertex, Cloud Code 경로는 계속 지원됩니다.
-2. **GitHub (선택 사항)** — 이슈 임포트 및 PR 관리를 위해 GitHub 연결
-3. **첫 번째 태스크** — 첫 번째 태스크를 생성하거나 GitHub에서 임포트(활성 프로젝트가 없는 경우, 온보딩이 먼저 프로젝트 디렉터리 등록/선택을 안내합니다)
-
-마법사는 **해제 가능하며 비차단적** — **지금 건너뛰기**를 클릭하면 즉시 대시보드를 사용할 수 있습니다. 나중에 **설정 → 인증 → 온보딩 가이드 다시 열기**에서 재실행할 수 있습니다.
-
-### 모바일
-
-Capacitor + PWA 워크플로우는 [MOBILE.md](./MOBILE.md)를 참조하세요.
-
----
-
## 문서
| 가이드 | 내용 |
diff --git a/README.md b/README.md
index 1af2c5e23a..cf99084ede 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
-
-
-# Fusion
+# Fusion
### From rough idea to production code — automatically.
-**Multi-node agent orchestrator** — tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
+### 🏭 A software factory, run by a multi-agent orchestrator.
+
+Describe what you want — a team of AI agents **plans, builds, reviews, and ships** it for you. Fusion is your software factory: an assembly line for code that runs across tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
[**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)
@@ -43,6 +43,72 @@ One board. Controlled from anywhere. Laptop, Mac mini, Linux server, cloud VM, p
---
+## Quick start
+
+**Zero install, straight from npm:**
+
+```bash
+npx runfusion.ai
+```
+
+That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
+
+**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
+
+```bash
+curl -fsSL https://runfusion.ai/install.sh | sh
+fusion dashboard
+```
+
+**Homebrew** (macOS & Linux):
+
+```bash
+brew tap runfusion/fusion
+brew install fusion
+fusion dashboard # or: fn dashboard
+```
+
+Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
+
+**npm global**:
+
+```bash
+npm install -g @runfusion/fusion
+fn dashboard # or: fusion dashboard
+```
+
+**From a clone** (for development):
+
+```bash
+pnpm dev dashboard
+```
+
+Then click the `Open:` URL printed in the terminal. It embeds a bearer token
+(`http://localhost:4040/?token=fn_...`) that the browser captures to
+`localStorage` on first visit and reuses automatically thereafter. On the
+server side, Fusion now persists the dashboard/daemon token in
+`~/.fusion/settings.json` on first authenticated run and reuses it on later
+starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
+`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
+[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
+for full precedence and reset/revocation options.
+
+### First-run setup
+
+On first launch, Fusion opens the **onboarding wizard** with three guided steps:
+
+1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
+2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
+3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
+
+The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
+
+### Mobile
+
+For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
+
+---
+
## The flow
```
@@ -84,6 +150,122 @@ Every task shows its plan, its reviews, its diffs, and its file changes in real
---
+## See it in action
+
+
+
+The newest surfaces in Fusion, at a glance — mission control, visual workflows, agent chat, multi-agent rooms, and inter-agent mail.
+
+### 🛰️ Command Center — mission control for your agent fleet
+
+
+
+
+
+One screen for everything your agents are doing. Tune live scheduler capacity, watch token spend by model in real time, and prove the value with hard numbers.
+
+
+
+
Tokens — spend by model, cached vs. input vs. output, over time.
+
Productivity — outcomes, duration percentiles, language mix.
+
Team — agent org chart and token share per agent.
+
+
+
+> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control — every tab is a different lens on the same live fleet.
+
+**The same fleet, your way** — Command Center (and the whole dashboard) re-skins live across **70+ color themes**. Here it is in Shadcn Light and Shadcn Dark Gray:
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+
+A dozen light themes & a dozen dark themes (click to expand)
+
+
+
+
+
+A task's journey from idea to merge is a **workflow** — and it's yours to choose and shape. Pick a built-in (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering, and more), inspect its graph, then duplicate and customize columns, gates, model lanes, and review policy in the visual [Workflow Editor](./docs/workflow-editor.md). No engine fork required.
+
+Here's the **Stepwise coding** graph — plan, execute, and review every step before the next — explored node-by-node in Shadcn Light and Dark Gray:
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 🗨️ Agent chat — talk to your agents, mid-flight
+
+
+
+
+
+Direct chat and per-task chat with any agent, on any model. Ask why a task failed, steer an approach, drop attachments, answer in-chat question cards, and resume streams where you left off — full markdown and code rendering throughout.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 👥 Multi-agent chat rooms
+
+
+
+
+
+Put multiple agents in a room and let them coordinate. Mention a member and it responds directly; ambient members can join the conversation up to a cap. Here the **CEO**, **Product Manager**, and **CTO** agents align on task ownership in `#leads` — no human in the loop. ([Chat docs](./docs/dashboard-guide.md#chat-view))
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+### 📬 Agent mail — an inbox between your agents
+
+
+
+
+
+A built-in mailbox for delegation, clarification, and hand-offs. Agents file triage summaries, request approvals, and coordinate work across the fleet — with Inbox, Outbox, Agents, and Approvals views, so you can audit every exchange.
+
+
+
+
Shadcn Light
+
Shadcn Dark Gray
+
+
+
+---
+
## How it works
```mermaid
@@ -227,72 +409,6 @@ npx companies.sh add paperclipai/companies/gstack
---
-## Quick start
-
-**Zero install, straight from npm:**
-
-```bash
-npx runfusion.ai
-```
-
-That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
-
-**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
-
-```bash
-curl -fsSL https://runfusion.ai/install.sh | sh
-fusion dashboard
-```
-
-**Homebrew** (macOS & Linux):
-
-```bash
-brew tap runfusion/fusion
-brew install fusion
-fusion dashboard # or: fn dashboard
-```
-
-Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
-
-**npm global**:
-
-```bash
-npm install -g @runfusion/fusion
-fn dashboard # or: fusion dashboard
-```
-
-**From a clone** (for development):
-
-```bash
-pnpm dev dashboard
-```
-
-Then click the `Open:` URL printed in the terminal. It embeds a bearer token
-(`http://localhost:4040/?token=fn_...`) that the browser captures to
-`localStorage` on first visit and reuses automatically thereafter. On the
-server side, Fusion now persists the dashboard/daemon token in
-`~/.fusion/settings.json` on first authenticated run and reuses it on later
-starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
-`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
-[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
-for full precedence and reset/revocation options.
-
-### First-run setup
-
-On first launch, Fusion opens the **onboarding wizard** with three guided steps:
-
-1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
-2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
-3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
-
-The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
-
-### Mobile
-
-For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
-
----
-
## Documentation
| Guide | What it covers |
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 54ffc03ec5..e8a87d7405 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,12 +1,12 @@