specrails-desktop 2.30.2 → 2.31.0

package/docs/guide/es/integrations/2-plugins.md

@@ -21,7 +21,7 @@ El plugin estrella es:
 3. Entra en el plugin para **previsualizar la instalación**: esto te muestra exactamente qué archivos cambiarán antes de que ocurra nada.
 4. Haz clic en **Instalar**. Verás el progreso en directo mientras se configura.
 
-Por debajo, la instalación es *quirúrgica y aditiva*: solo añade sus propias entradas al `.mcp.json` de tu proyecto (y, para algunos plugins, un archivo de fragmento en el espacio protegido `.claude/agents/`). Nunca reescribe tu configuración por completo, y añadir un segundo plugin nunca puede alterar el primero. Si la instalación no puede verificarse como saludable, se revierte de forma limpia.
+Por debajo, la instalación es *quirúrgica y aditiva*: solo añade sus entradas a la configuración MCP nativa del provider elegido (y, en algunas instalaciones Claude, un fragmento en `.claude/agents/`). Nunca reescribe la configuración por completo; si no puede verificarse como saludable, se revierte de forma limpia.
 
 ## Gestionar los plugins instalados
 
@@ -37,8 +37,8 @@ Por debajo, la instalación es *quirúrgica y aditiva*: solo añade sus propias
 
 ## Notas sobre proveedores
 
-Los plugins son conscientes del proveedor. Serena y otros plugins MCP similares se resuelven para los proveedores que registran MCP a través del `.mcp.json` del proyecto (Claude y Gemini). Para los proyectos con Codex, los servidores MCP se gestionan en cambio a través de la propia configuración global de Codex, así que las entradas de plugins en **Integraciones** se filtran en consecuencia. La tarjeta de Jira en Integraciones es independiente del proveedor y se muestra para todos: consulta la guía de Jira.
+Los plugins son conscientes del proveedor. Serena admite Claude mediante `.mcp.json`, Codex mediante `codex mcp add` con un `CODEX_HOME` aislado por proyecto y Kimi mediante `.kimi-code/mcp.json`. Solo aparece si su manifiesto declara el provider; por eso Serena no se ofrece para Gemini. La tarjeta de Jira es independiente del proveedor y se muestra para todos.
 
 ## Archivos reservados
 
-Los plugins gestionan un conjunto pequeño y bien definido de archivos en tu proyecto: tu `.mcp.json` (mezclado quirúrgicamente), algo de estado bajo `.specrails/plugins/` y fragmentos de agente por plugin en `.claude/agents/custom-<plugin>.md`. Estos son activos de equipo que puedes commitear si quieres compartir una integración con tus compañeros: la app nunca los sobrescribe a ciegas.
+Los plugins gestionan la configuración MCP nativa del provider, estado bajo `.specrails/plugins/` y, solo cuando corresponde a Claude, fragmentos en `.claude/agents/custom-<plugin>.md`. Las entradas Kimi viven en `.kimi-code/mcp.json`; la app no escribe fragmentos exclusivos de Claude para Kimi ni sobrescribe configuraciones a ciegas.

package/docs/guide/es/integrations/6-agent-chat.md

@@ -22,7 +22,14 @@ Elegir un proyecto aquí **no** mueve tu panel: el objetivo del agente y lo que
 
 ## Proveedor y modelo
 
-Justo encima del cuadro de mensaje eliges el **proveedor** (Claude, Codex o Gemini) y su **modelo**. Cada proveedor tiene su propia lista de modelos, y cambiar de proveedor inicia una sesión nueva con el modelo por defecto de ese proveedor, así que puedes, por ejemplo, manejar la app con Claude y pasar a Codex para otra conversación sin que se mezcle nada.
+Justo encima del cuadro de mensaje eliges el **proveedor** (Claude, Codex,
+Gemini o Kimi) y su **modelo**. Cada proveedor tiene su propia lista y cambiar
+de proveedor inicia una sesión separada.
+
+Con Kimi, los niveles limitan las herramientas MCP de Specrails, pero no
+convierten `kimi -p` en un sandbox: Kimi aprueba sus herramientas nativas
+automáticamente. Las acciones pure-output inseguras se rechazan antes de
+iniciar el proceso; consulta la [matriz Kimi](../../../kimi.md).
 
 ## Niveles de permiso: tú llevas las riendas
 

package/docs/guide/es/pipeline/1-rails-and-jobs.md

@@ -35,8 +35,8 @@ Eso es todo. El rail arranca un proceso de la CLI de IA en el contexto de ejecuc
 | **Pastilla de estado** | `idle`, `running` o `failed`. No hay un estado "completed" aparte — un rail vuelve a `idle` cuando su job termina limpiamente. |
 | **Lista de specs** | Los IDs asignados a este rail. Arrastra más para añadirlas, o sácalas para desvincularlas. |
 | **Selector de Loop** | El Loop que ejecuta este rail — uno integrado (`Implement` / `Batch` / `Freestyle`) o un loop personalizado. Mira la tabla de más abajo. Se recuerda por rail. |
-| **Selector de perfil** | Qué perfil de agentes se ejecuta (solo en rails de Claude). Solo aparece cuando el proyecto tiene al menos un perfil. |
-| **Selector de motor** | Qué proveedor instalado ejecuta este rail — Claude, Codex o Gemini. Solo se muestra cuando el proyecto tiene más de un proveedor. Mira [Elegir un motor por rail](picking-an-engine-per-rail). |
+| **Selector de perfil** | Qué perfil del proveedor se ejecuta (rails Claude y Kimi). |
+| **Selector de motor** | Qué proveedor ejecuta el rail — Claude, Codex, Gemini o Kimi. |
 | **▶ Play / ■ Stop** | Iniciar o cancelar. |
 
 ### Qué ejecuta un rail: Loops
@@ -47,9 +47,11 @@ Un rail ejecuta un **Loop** — la receta del trabajo. Tres loops están **integ
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Un job que cubre todas las specs del rail. Ejecuta el pipeline completo Architect → Developer → Reviewer → Ship. El predeterminado del día a día. |
 | **Batch** | `/specrails:batch-implement` | Un job que recorre las specs del rail de forma secuencial, en oleadas según sus dependencias. Lo mejor para varias specs relacionadas. |
-| **Freestyle** | Freestyle | Claude implementa cada spec de forma autónoma, **saltándose** el pipeline. Un job independiente por spec. Solo Claude. |
+| **Freestyle** | Freestyle | Claude o Kimi implementan cada spec de forma autónoma, **saltándose** el pipeline. |
 
-Freestyle es el caso especial: se salta la cadena de agentes y le entrega a Claude la spec en bruto para que la trabaje con sus herramientas nativas. Es de final abierto, así que al pulsar Play primero se abre una confirmación, y un selector de modelo por rail te deja elegir Haiku / Sonnet / Opus. Solo aparece cuando el motor del rail es Claude. Una ejecución Freestyle es además el único job que **se queda abierto esperándote**: chatea con él desde el compositor del detalle del job y pulsa **Finalize** cuando estés satisfecho (todos los demás jobs terminan solos).
+Freestyle usa las herramientas nativas y el catálogo de modelos del proveedor.
+Claude tiene transporte interactivo persistente; Kimi usa un proceso agentic
+`kimi -p` sin stdin persistente.
 
 Más allá de los integrados, puedes **construir tus propios loops** — repetir un ciclo verify → fix → verify hasta cumplir un objetivo, encadenar comandos de shell entre pasos de IA y más. Esos loops personalizados aparecen en el mismo selector de Loop. Esa es la siguiente gran idea: [El Loop Builder](the-loop-builder).
 
@@ -81,7 +83,8 @@ Pulsa **■ Stop** en la cabecera del rail. La app envía `SIGTERM` al subproces
 
 ## Si un rail no se lanza
 
-Si eliges un motor cuya CLI no está instalada en tu máquina, el lanzamiento **falla rápido** en vez de iniciar un job roto — no se arranca nada. Instala la CLI del proveedor que falte ([Usar Codex](../integrations/using-codex), [Usar Gemini](../integrations/using-gemini)) y vuelve a lanzar. Si falta Claude o Codex, verás un mensaje preciso de "*<provider> CLI not found*"; si falta Gemini, hoy aparece un error de lanzamiento genérico, pero el resultado es el mismo.
+Si falta la CLI elegida, el lanzamiento falla antes de iniciar. Para Kimi
+instala/autentica `kimi` 0.27+; Desktop no inicia un servidor.
 
 ## Detenerlo todo
 
@@ -96,4 +99,4 @@ Si algo parece ir mal:
 - [El Loop Builder](the-loop-builder) — qué ejecuta un rail y cómo construir tus propios loops.
 - [La vista de detalle del job](the-job-detail-view) — fases, métricas en vivo, tarjetas de ticket.
 - [Batch implement y multifuncionalidad](batch-implement-and-multi-feature) — ejecuta varias specs a la vez.
-- [Elegir un motor por rail](picking-an-engine-per-rail) — Claude vs Codex vs Gemini.
+- [Elegir un motor por rail](picking-an-engine-per-rail) — Claude, Codex, Gemini o Kimi.

package/docs/guide/es/pipeline/2-the-job-detail-view.md

@@ -94,7 +94,9 @@ Algunas cosas que conviene saber:
 - **La línea de totales es real.** El compositor muestra un resumen en vivo `N turnos · $X`, sumado a partir del uso real de cada turno completado — coherente con la promesa de esta página de no adivinar nada.
 - **Dos formas de terminar una sesión.** La mayoría de los jobs **terminan solos**: en cuanto un turno acaba sin mensajes en cola, la sesión se asienta y el job se completa — tus mensajes son dirección opcional, nunca una obligación. Una acción discreta **Terminar ahora** la cierra antes con todo lo producido hasta el momento. Los jobs **Freestyle** son la excepción: quedan a la espera entre turnos hasta que tú pulsas **Finalize** — ese es su diseño, una sesión de ida y vuelta que cierras cuando terminas.
 - **En un loop, los mensajes van al paso activo.** En un loop propio o integrado, tu mensaje llega al **paso de IA que está corriendo en ese momento**. Entre pasos (mientras el Loop Decider piensa, o corre un comando de shell) el compositor muestra un breve estado *«Esperando el siguiente paso…»* — tu texto redactado se conserva, y el envío se reactiva cuando arranca el siguiente paso de IA. **Asentar este paso** cierra el paso actual antes de tiempo y deja que el loop avance con lo que produjo.
-- **Solo Claude, por ahora.** Los jobs de Codex y Gemini se ejecutan de una sola pasada exactamente como antes — no aparece compositor. (Los operadores del servidor pueden desactivar la función entera con `SPECRAILS_INTERACTIVE_JOBS=false`.)
+- **La interacción persistente es solo Claude.** Codex, Gemini y Kimi se
+  ejecutan one-shot; Kimi reanuda chats con un nuevo `kimi --session=<id> -p` después de
+  recibir un resume hint.
 
 ## Exportar diagnóstico
 

package/docs/guide/es/pipeline/3-batch-implement-and-multi-feature.md

@@ -81,4 +81,4 @@ No hay límite global de concurrencia que ajustar. Abre los proyectos o rails qu
 
 - [Rails y jobs](rails-and-jobs) — el modelo de cola en profundidad.
 - [La vista de detalle del job](the-job-detail-view) — mira un batch ejecutarse en vivo.
-- [Elegir un motor por rail](picking-an-engine-per-rail) — ten en cuenta que Batch corre en cualquier proveedor; Freestyle es solo de Claude.
+- [Elegir un motor por rail](picking-an-engine-per-rail) — Batch corre en cualquier proveedor; Freestyle está disponible con Claude y Kimi.

package/docs/guide/es/pipeline/4-picking-an-engine-per-rail.md

@@ -1,6 +1,8 @@
 # Elegir un motor por rail
 
-Specrails desktop trata **Claude Code**, **Codex CLI** y **Gemini CLI** como motores de primera clase. Un proyecto puede tener uno, dos o los tres instalados — y cuando hay más de uno, eliges qué motor ejecuta cada rail. Esta página cubre el selector de motor por rail y cuándo recurrir a cada uno.
+Specrails desktop trata **Claude Code**, **Codex CLI**, **Gemini CLI** y
+**Kimi Code** como motores de primera clase. Un proyecto puede instalar
+cualquier combinación compatible.
 
 ## Cuándo aparece el selector
 
@@ -13,30 +15,28 @@ Cuando sí aparece, tu elección es **por rail y por lanzamiento** — distintos
 ## Cómo elegir un motor
 
 1. Asegúrate de que el selector de motor del rail está visible (el proyecto tiene 2 o más proveedores).
-2. Púlsalo y elige **Claude**, **Codex** o **Gemini**.
+2. Púlsalo y elige **Claude**, **Codex**, **Gemini** o **Kimi**.
 3. Lanza el rail con **▶ Play**.
 
 El motor seleccionado ejecuta cada fase del pipeline de ese rail. Si la CLI del motor elegido no está instalada, el lanzamiento falla rápido — no se arranca nada. Instala la CLI que falta y vuelve a intentarlo.
 
 ## En qué destaca cada motor
 
-Los tres ejecutan los pipelines estándar **Implement** y **Batch**. Aquí tienes una guía práctica para elegir:
+Los cuatro ejecutan **Implement** y **Batch**:
 
 | Motor | Recurre a él cuando… | Notas |
 |--------|--------------------|-------|
-| **Claude** | Quieres el conjunto completo de funciones: perfiles de agentes, Freestyle, reporte de coste nativo, el soporte de herramientas más rico. El predeterminado para la mayoría del trabajo. | El único motor que admite **perfiles de agentes**, **Freestyle** y algunas funciones de spec exclusivas de Claude (Contract Layer, SMASH). |
+| **Claude** | Necesitas coste nativo, interacción persistente o políticas de tools estrictas. | Perfiles, Freestyle y transforms estructurados. |
 | **Codex** | Prefieres la CLI de OpenAI Codex o quieres comparar implementaciones entre proveedores. | `codex` ≥ 0.128.0. Sin reporte de coste nativo — la app rellena el coste desde su tarifario. Los perfiles no aplican. |
 | **Gemini** | Quieres la CLI de Gemini de Google, telemetría nativa o una ejecución más barata para specs rutinarias. | `gemini` ≥ 0.11.0 (define `GEMINI_API_KEY`). Telemetría OTLP nativa. Los perfiles no aplican. |
+| **Kimi** | Quieres Kimi agentic para Implement, Batch, Freestyle o loops sin Decider. | `kimi` ≥ 0.27.0 externo; perfiles/roles y effort low/high/max solo para K3; tokens/coste no disponibles. |
 
-### Las funciones exclusivas de Claude
+### Diferencias de capacidad
 
-Algunas cosas solo funcionan en rails de Claude — elige Claude si las necesitas:
-
-- **Perfiles de agentes** — enrutamiento de modelo por agente. En rails de Codex o Gemini la ejecución siempre usa el modo legacy y cualquier perfil seleccionado se **ignora**. El selector de perfil se oculta para los motores que no son Claude.
-- **Freestyle** — el modo autónomo que se salta el pipeline. El segmento `Freestyle` y su selector de modelo Haiku/Sonnet/Opus solo aparecen cuando el motor del rail es Claude.
-- **Contract Layer y SMASH** — funciones de refinamiento de spec exclusivas de Claude (son opciones de Add-Spec, no de rail, pero aplica la misma restricción).
-
-Si un proyecto mezcla motores, la barra lateral derecha solo muestra las secciones que **todos** los proveedores instalados admiten — así, la sección **Agents** desaparece por completo en un proyecto que incluya cualquier proveedor que no sea Claude, porque los perfiles son específicos de Claude.
+Claude y Kimi admiten perfiles y Freestyle; Codex/Gemini usan legacy. Kimi no
+admite Loop Decider ni los transforms pure-output enumerados en la
+[guía Kimi](../../../kimi.md). Los perfiles Claude/Kimi están separados por
+proveedor.
 
 ## Un flujo de trabajo práctico
 
@@ -49,12 +49,14 @@ Los proyectos multiproveedor brillan cuando quieres **comparar** o **afinar cost
 ## Cosas a tener en cuenta
 
 - **La selección de proveedor es inmutable tras crear el proyecto** (v1). Eliges los proveedores instalados al añadir el proyecto; no hay un interruptor en Ajustes para añadir o quitar uno después.
-- **El coste siempre se registra**, incluso para los motores sin reporte de coste nativo — la app recurre a un tarifario para que las ejecuciones de Codex y Gemini también aparezcan en [analíticas](../analytics/tracking-cost).
+- **Las métricas disponibles se registran.** Kimi no emite tokens ni coste USD
+  autoritativos; esos campos quedan vacíos.
 - **El botón "Abrir CLI de IA" del terminal** también ofrece un selector de proveedor en proyectos multiproveedor, por si prefieres manejar una CLI a mano.
 
 ## A dónde ir después
 
 - [Usar Codex](../integrations/using-codex) — instalar e iniciar sesión.
 - [Usar Gemini](../integrations/using-gemini) — instalar, `GEMINI_API_KEY`, telemetría.
+- [Usar Kimi](../../../kimi.md) — instalación y matriz completa.
 - [Rails y jobs](rails-and-jobs) — la cola y el flujo de lanzamiento.
 - [Seguimiento de costes](../analytics/tracking-cost) — desglose de coste por motor.

package/docs/guide/es/pipeline/5-the-loop-builder.md

@@ -17,7 +17,7 @@ Un **loop** es la *receta* del trabajo; un **rail** es el *carril* que la ejecut
 
 - Los loops viven en la sección **Loops** (barra lateral izquierda, junto a tus proyectos) — son **globales**, compartidos entre todos los proyectos.
 - Un rail **elige un loop** en su cabecera (el selector de Loop) y lo ejecuta cuando pulsas Play.
-- El **rail** decide el proveedor, el modelo y el esfuerzo de razonamiento — *no* los pasos del loop. El mismo loop se ejecuta en Claude, Codex o Gemini según el rail.
+- El **rail** decide el proveedor, modelo y esfuerzo compatible. Un loop compatible puede ejecutarse en Claude, Codex, Gemini o Kimi.
 
 Así que: construye un loop una vez y luego elígelo en cualquier rail de cualquier proyecto.
 
@@ -41,6 +41,10 @@ Un loop es un grafo de **nodos** conectados por **aristas** (las flechas). Cada
 
 Las aristas conectan los pasos en orden. El **Loop Decider** tiene dos salidas etiquetadas — **continue** y **stop** — así que cableas "aún no terminado" de vuelta al trabajo y "terminado" hacia un End.
 
+> **Kimi ejecuta loops con pasos AI/shell, pero no con Loop Decider.** El
+> veredicto es pure-output y `kimi -p` no puede imponer su límite sin
+> herramientas; el run se rechaza antes del primer paso.
+
 ### Escribir el texto de un paso
 
 Dentro de cualquier AI Step o Decider puedes referenciar:
@@ -57,7 +61,7 @@ Un loop que nunca para gastaría dinero para siempre, así que cada ejecución t
 |-------|--------------|
 | **Max iterations** | Tope duro de cuántas veces puede el Decider volver atrás, sin importar su veredicto. |
 | **Timeout (min)** | Límite de tiempo real para toda la ejecución. |
-| **Max cost ($)** | *Opcional.* Detiene el loop una vez el coste acumulado cruza tu presupuesto. Se comprueba **entre pasos** (el coste de un paso solo se conoce cuando termina), así que puede sobrepasar por un paso. En Claude el coste es exacto; en Codex y Gemini es una estimación. Déjalo vacío para no poner tope. |
+| **Max cost ($)** | *Opcional.* Claude aporta coste; Codex/Gemini usan estimación. Kimi no emite coste USD autoritativo. |
 
 ## Construir con confianza
 

package/docs/guide/es/specs/2-add-spec-quick-mode.md

@@ -2,6 +2,10 @@
 
 El modo Quick es para cuando ya sabes lo que quieres. Escribes tu idea, la IA redacta la spec completa y esta aterriza en tu tablero como **Por hacer**. Sin idas y venidas: solo descríbela y listo.
 
+> **Kimi no está disponible en Quick Spec.** `kimi -p` no puede imponer el
+> límite pure-output de este formulario. La petición se rechaza antes de
+> iniciar Kimi; usa Explore, Raw o Quick Launcher (`/opsx:ff`).
+
 ## Crear una spec en modo Quick
 
 Para crear una spec rápidamente:
@@ -19,7 +23,8 @@ Ese es todo el flujo. Todo lo que viene a continuación son ajustes opcionales.
 
 **Modelo**: por defecto, la IA elige un modelo razonable. Puedes sobrescribirlo por spec desde el selector de modelo si quieres uno más rápido o más capaz.
 
-**Motor**: si tu proyecto tiene instalado más de un proveedor de IA (cualquier combinación de Claude, Codex y Gemini), un selector de motor aparece en la parte superior del diálogo para que elijas cuál genera esta spec. Tu elección se recuerda por proyecto. Los proyectos con un solo proveedor no muestran esto: no hay entre qué elegir.
+**Motor**: si el proyecto tiene más de un proveedor **compatible**, aparece el
+selector. Kimi queda excluido de Quick Spec.
 
 **Contexto**: el modo Quick normalmente se ejecuta en un solo turno, porque no necesita leer tu código para escribir una spec a partir de tu descripción. Pero un control deslizante de contexto te permite darle más material con el que trabajar:
 

package/docs/guide/fr/agents/2-profiles-and-the-balanced-default.md

@@ -37,7 +37,11 @@ Voilà tout le flux : choisir un profil, lancer, terminé. Des rails simultanés
 
 ## Quand la section Agents reste silencieuse
 
-Les profils sont une capacité de Claude. Sur un projet qui inclut un provider non-Claude (Codex ou Gemini), la section Agents est masquée et les rails tournent sans profils — c'est le comportement attendu, pas un bug. Les profils exigent aussi un `specrails-core` suffisamment récent dans le projet ; s'il est plus ancien, vous verrez une bannière jaune. Les profils que vous créez sont tout de même **enregistrés** — ils n'affectent simplement pas le pipeline tant que core n'est pas mis à jour. Mettez à jour avec la commande indiquée dans la bannière pour les débloquer.
+Les profils sont séparés par fournisseur. Claude et Kimi prennent en charge
+profils/rôles ; Codex et Gemini utilisent le mode legacy. Dans un projet
+mixte, un même nom ne traverse jamais Claude/Kimi. Kimi permet les rôles
+manuels, mais génération, smoke test et AI Refine d'Agent Studio échouent
+avant démarrage. Kimi exige `specrails-core` 4.12.0 ou plus récent.
 
 ## Pour aller plus loin
 

package/docs/guide/fr/agents/4-custom-agents-catalog.md

@@ -11,21 +11,24 @@ Chaque entrée du catalogue indique à quoi sert l'agent et son modèle par déf
 
 ## Ajouter un agent personnalisé
 
-Les agents personnalisés sont de simples fichiers Markdown dans votre dépôt, sous `.claude/agents/`, nommés `custom-<quelque-chose>.md`. Le fichier contient les instructions de l'agent (son system prompt) et un petit en-tête frontmatter qui inclut un `model:` par défaut.
+Les rôles sont des assets natifs du fournisseur : Claude utilise
+`.claude/agents/custom-<nom>.md` ; Kimi utilise
+`.kimi-code/skills/custom-<nom>/SKILL.md`.
 
-Dès que le fichier existe dans le projet, il apparaît dans le catalogue comme agent personnalisé, et vous pouvez ajouter son id à la chaîne d'agents de n'importe quel profil (et y router des tâches). L'id doit correspondre au nom du fichier — une entrée `custom-docs` correspond à `.claude/agents/custom-docs.md`.
+Dès que l'asset existe, il apparaît dans le catalogue de ce fournisseur et son id peut rejoindre un profil du même fournisseur. `custom-docs` correspond à `.claude/agents/custom-docs.md` pour Claude ou à `.kimi-code/skills/custom-docs/SKILL.md` pour Kimi ; les deux restent indépendants.
 
 Parce qu'ils vivent dans votre dépôt, les agents personnalisés sont des **ressources d'équipe commitables** : commitez le fichier et toute votre équipe récupère l'agent. Cela reflète l'idée centrale qui traverse toute la section Agents —
 
 > **Les définitions d'agents sont partagées (elles vivent dans le dépôt et voyagent avec `git`). La configuration des modèles est propre au projet (elle vit dans les profils).**
 
-L'espace de noms `custom-*` est réservé et protégé : les commandes `init` et `update` de `specrails-core` ne touchent jamais à `.claude/agents/custom-*.md`, si bien que vos agents personnalisés survivent intacts aux mises à jour de core. (La même protection couvre les fragments contribués par les plugins, comme `custom-serena.md`.)
+Core protège les deux formats. Kimi permet création/édition manuelle et
+exécution ; Generate, Test et AI Refine échouent avant démarrage.
 
 ## Mettre un agent personnalisé au travail
 
 Le flux typique :
 
-1. Rédigez `.claude/agents/custom-<nom>.md` avec des instructions et un modèle par défaut.
+1. Créez l'asset natif Claude ou le Skill Kimi avec instructions/modèle valides.
 2. Vérifiez qu'il apparaît bien dans **Agents → Catalogue** sous Personnalisés.
 3. Dans **Agents → Profils**, ajoutez l'agent à la chaîne d'un profil (en surchargeant éventuellement son modèle pour ce profil).
 4. Ajoutez une règle de routage pour que les tâches portant les bons tags l'atteignent — ou reposez-vous sur l'ordre de la chaîne.

package/docs/guide/fr/getting-started/1-what-is-specrails.md

@@ -36,6 +36,7 @@ Specrails fonctionne avec les principales CLI de codage IA :
 - **Claude** (Claude Code)
 - **Codex** (Codex CLI)
 - **Gemini** (Gemini CLI)
+- **Kimi** (Kimi Code)
 
 Choisissez celui que vous utilisez déjà — ou installez-en plusieurs et choisissez selon la tâche. Un projet peut tourner sur un seul fournisseur ou sur plusieurs à la fois, vous n'êtes donc jamais enfermé.
 

package/docs/guide/fr/getting-started/2-installing-and-first-run.md

@@ -23,6 +23,7 @@ La seule chose que specrails ne peut pas intégrer, c'est la **CLI du fournisseu
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 Installez celle que vous comptez utiliser, connectez-vous une fois depuis votre terminal, et le tour est joué. Specrails détecte automatiquement les fournisseurs présents.
 

package/docs/guide/fr/getting-started/4-the-dashboard-tour.md

@@ -26,13 +26,13 @@ La barre latérale droite est votre tableau d'aiguillage pour le projet courant.
 
 - **Tableau de bord** — le tableau des specs et les rails (là d'où vous venez).
 - **Jobs** — chaque exécution de pipeline pour ce projet, passée et présente, avec son statut, sa durée et la possibilité de plonger dans le détail et les logs de n'importe quelle exécution.
-- **Analytics** — ce que coûte votre usage de l'IA. Les dépenses ventilées par jour, par activité, par modèle et par ticket — pour éviter les mauvaises surprises.
-- **Agents** — les profils d'agents de votre projet : quels agents s'exécutent dans le pipeline et quels modèles d'IA ils utilisent. *(Projets propulsés par Claude uniquement.)*
-- **Code** — un explorateur de fichiers en lecture seule, avec des résumés IA en langage clair et des badges indiquant quels fichiers l'IA a touchés. Idéal pour les non-développeurs qui veulent suivre.
+- **Analytics** — les invocations par jour, activité, modèle et ticket. Claude fournit le coût facturé, Codex/Gemini des estimations, et Kimi laisse vides les champs tokens/coût USD indisponibles.
+- **Agents** — profils et catalogues de rôles propres au fournisseur pour Claude et Kimi. Avec Kimi, les rôles se créent et se modifient manuellement ; Generate, Test et AI Refine sont indisponibles.
+- **Code** — un explorateur de fichiers en lecture seule et des badges indiquant quels fichiers l'IA a touchés. Les résumés IA en langage clair n'apparaissent qu'avec un fournisseur compatible ; ils sont indisponibles avec Kimi.
 - **Intégrations** — des extensions facultatives, comme connecter vos specs à un tableau **Jira** ou activer des outils supplémentaires pour l'IA.
 - **Paramètres** — les options par projet (télémétrie, budgets, configuration des fournisseurs, et plus encore).
 
-> Certaines sections n'apparaissent que lorsqu'elles ont du sens pour les fournisseurs que vous avez choisis — par exemple, **Agents** est spécifique à Claude. Si vous ne voyez pas une section, c'est simplement qu'elle ne s'applique pas à la configuration de ce projet.
+> Les sections et actions suivent les capacités du fournisseur effectif. Les profils fonctionnent par exemple avec Claude et Kimi, mais les actions IA d'Agent Studio échouent de façon fermée avec Kimi.
 
 ## La barre de statut
 

package/docs/guide/fr/integrations/1-ai-providers.md

@@ -1,16 +1,21 @@
-# Fournisseurs d'IA (Claude, Codex, Gemini)
+# Fournisseurs d'IA (Claude, Codex, Gemini, Kimi)
 
-Specrails n'est lié à aucune IA en particulier. Chaque endroit de l'app qui dialogue avec une IA — Explore Spec, Quick spec, les rails, le chat, l'AI Edit, le bouton « Open AI CLI » du terminal — peut passer par l'un des trois fournisseurs de premier plan. Vous choisissez ceux qu'un projet utilise, et vous pouvez même changer de fournisseur tâche par tâche.
+Specrails n'est lié à aucune IA. Claude, Codex, Gemini et Kimi sont des
+fournisseurs de premier plan ; chaque surface ne propose que les moteurs dont
+les capacités respectent son contrat.
 
-## Les trois fournisseurs
+## Les quatre fournisseurs
 
 | Fournisseur | CLI | Édité par | Notes |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | Le plus complet. Seul fournisseur pour les Agents (profils), les rails Freestyle et le Contract Refine. |
+| **Claude** | `claude` | Anthropic | Coût natif et transport interactif persistant. |
 | **Codex** | `codex` | OpenAI | Nécessite codex `0.128.0+`. Lit ses serveurs MCP depuis votre fichier global `~/.codex/config.toml`. |
 | **Gemini** | `gemini` | Google | Nécessite gemini `0.11.0+`. Utilise une télémétrie native et un fichier d'instructions `GEMINI.md`. |
+| **Kimi Code** | `kimi` | Moonshot AI | Nécessite Kimi `0.27.0+`. Desktop lance la CLI externe avec `-p` ; aucun serveur n'est installé ou démarré. |
 
-Les trois sont **activés par défaut**. Un fournisseur apparaît dans **Ajouter un projet** dès que sa CLI est installée et présente dans votre `PATH`. La première étape est donc toujours la même : installez la CLI souhaitée et connectez-vous avec, exactement comme l'indique sa propre documentation. Dès que `claude --version` (ou `codex`, ou `gemini`) fonctionne dans votre terminal, Specrails peut l'utiliser.
+Les quatre sont **activés par défaut**. Un fournisseur apparaît dans **Ajouter
+un projet** lorsque sa CLI est installée et présente dans votre `PATH`. Pour
+Kimi, vérifiez `kimi --version` puis exécutez `kimi login`.
 
 ## Installer un fournisseur pour un projet
 
@@ -25,40 +30,46 @@ Vous pouvez installer **plus d'un** fournisseur dans le même projet — par exe
 Quelques points utiles à connaître sur les projets multi-fournisseurs :
 
 - **Avec un seul fournisseur, rien ne change.** Si un projet n'a qu'un seul fournisseur, vous ne verrez jamais de sélecteur de fournisseur où que ce soit — l'app reste épurée et simple.
-- **La barre latérale droite n'affiche que les sections prises en charge par tous les fournisseurs installés.** Comme les Agents (profils) sont un concept propre à Claude, la section **Agents** disparaît dès qu'un projet inclut un fournisseur autre que Claude. Tout le reste (Specs, Code, Analytics, Intégrations, Terminal, Chat) demeure.
+- **Les capacités pilotent l'interface.** Claude et Kimi prennent en charge des
+  profils séparés par fournisseur ; Codex et Gemini utilisent le mode legacy.
 - **Le choix des fournisseurs est verrouillé après la création.** Dans cette version, vous choisissez vos fournisseurs au moment d'ajouter le projet et vous ne pouvez plus les modifier ensuite depuis les Réglages. S'il vous faut une combinaison différente, créez un nouveau projet.
 
 ## Choisir un fournisseur à chaque invocation
 
 Tout l'intérêt d'un projet multi-fournisseurs, c'est de choisir l'IA la plus adaptée à chaque tâche — sans toucher au moindre réglage global. Partout où une IA s'exécute, un petit sélecteur de fournisseur apparaît (uniquement lorsque le projet en compte plusieurs) :
 
-- **Ajouter une spec** — un sélecteur de moteur vous permet d'Explorer ou de générer en Quick une spec avec le fournisseur de votre choix.
+- **Ajouter une spec** — Explore accepte Kimi ; Quick Spec ne propose que les
+  fournisseurs capables d'imposer sa frontière pure-output, donc pas Kimi.
 - **En-tête de rail** — choisissez le moteur de ce rail précis avant de le lancer.
 - **Terminal** — le bouton « Open AI CLI » (Sparkles) ouvre un menu de fournisseurs pour basculer dans n'importe quelle CLI installée, dans le répertoire de ce projet.
 
 Votre choix est mémorisé par projet, avec le fournisseur principal comme valeur par défaut, pour ne pas avoir à le refaire à chaque fois.
 
-## Ce que seul Claude peut faire
+## Différences de capacités
 
-Une poignée de fonctionnalités sont par nature propres à Claude : elles sont donc soit masquées, soit ignorées lorsqu'un autre fournisseur est en jeu :
+Kimi prend en charge Project/Agent Chat, Explore et les propositions, Quick
+Launcher (`/opsx:ff`), les rails, Freestyle, les loops sans Decider, les
+profils/rôles manuels, MCP, Serena, le terminal et les pièces jointes.
 
-- **Agents (profils)** — le catalogue d'agents par projet et le routage des modèles. Masqué sur tout projet incluant un fournisseur autre que Claude.
-- **Rails Freestyle** — toujours exécutés sur Claude.
-- **Contract Refine** — la passe supplémentaire « Contract Layer » sur une spec validée ne s'exécute que lorsque le fournisseur de la conversation est Claude.
-- **Modes avancés d'Ajouter une spec** (SMASH / Contract Layer) — masqués pour les moteurs autres que Claude.
-
-Tout le reste — Explore, Quick spec, le pipeline complet des rails, l'AI Edit, le chat, les analytics de coût — fonctionne avec les trois fournisseurs.
+`kimi -p` approuve automatiquement les outils et ne peut pas imposer une
+frontière sans outils/read-only. Sont donc refusés avant démarrage : Quick
+Spec, AI Edit, Contract Refine, SMASH/Re-SMASH, génération de
+blueprint/milestone Project Builder, Loop Decider, résumés/histoire de
+construction et automatisation Agent Studio. L'auto-title utilise un fallback
+déterministe. Voir le [guide Kimi](../../../kimi.md).
 
 ## Suivi des coûts entre fournisseurs
 
-La page **Analytics** suit chaque invocation facturable, quel que soit le fournisseur. Sur les projets multi-fournisseurs, elle ajoute des puces de filtre par moteur pour comparer les dépenses par fournisseur. Claude rapporte son coût exact ; pour Codex et Gemini, Specrails estime le coût à partir d'une table de tarifs intégrée — ce sont donc des approximations proches plutôt que les montants réellement facturés.
+**Analytics** enregistre les invocations réellement lancées. Claude rapporte
+son coût ; Codex et Gemini utilisent une estimation. Kimi ne fournit ni tokens
+ni coût USD autoritatifs, donc ces champs restent vides.
 
 ## Dépannage
 
-- **Un fournisseur que j'ai installé n'est pas proposé.** Vérifiez que la CLI est dans votre `PATH` (essayez `claude --version` / `codex --version` / `gemini --version` dans un terminal neuf). L'app sonde les CLI des fournisseurs via votre `PATH` système.
+- **Un fournisseur que j'ai installé n'est pas proposé.** Vérifiez la CLI dans votre `PATH` (`claude --version` / `codex --version` / `gemini --version` / `kimi --version`).
 - **Les serveurs MCP de Codex ne se chargent pas dans le chat.** Codex lit ses serveurs MCP depuis votre fichier global `~/.codex/config.toml` — enregistrez-les là avec `codex mcp add`.
 - **Désactivation d'urgence.** Un fournisseur peut être coupé à l'échelle de l'app via une variable d'environnement (`SPECRAILS_CODEX_BETA=0` ou `SPECRAILS_GEMINI_BETA=0`). Cela masque uniquement le fournisseur de la *sélection* ; c'est rarement nécessaire.
 
 ## Voir aussi
 
-Les guides dédiés à chaque fournisseur entrent davantage dans le détail de chaque CLI : le guide Codex et le guide Gemini couvrent chacun l'installation, ce qui fonctionne et les particularités propres au fournisseur.
+Consultez les guides dédiés à [Kimi](../../../kimi.md), Codex et Gemini.

package/docs/guide/fr/integrations/2-plugins.md

@@ -21,7 +21,7 @@ Le plugin phare est :
 3. Cliquez sur le plugin pour **prévisualiser l'installation** — cela vous montre exactement quels fichiers vont changer avant que quoi que ce soit ne se produise.
 4. Cliquez sur **Installer**. Vous suivez la progression en direct pendant la mise en place.
 
-En coulisses, l'installation est *chirurgicale et additive* : elle n'ajoute que ses propres entrées au `.mcp.json` de votre projet (et, pour certains plugins, un fichier de fragment dans l'espace de noms protégé `.claude/agents/`). Elle ne réécrit jamais votre configuration dans son ensemble, et l'ajout d'un second plugin ne peut jamais perturber le premier. Si l'installation ne parvient pas à se vérifier comme saine, elle effectue un retour arrière propre.
+En coulisses, l'installation est *chirurgicale et additive* : elle n'ajoute ses entrées qu'à la configuration MCP native du fournisseur choisi (et, pour certaines installations Claude, un fragment sous `.claude/agents/`). Elle ne réécrit jamais toute la configuration et revient proprement en arrière si la vérification échoue.
 
 ## Gérer les plugins installés
 
@@ -37,8 +37,8 @@ En coulisses, l'installation est *chirurgicale et additive* : elle n'ajoute que
 
 ## Notes sur les fournisseurs
 
-Les plugins tiennent compte du fournisseur. Serena et les plugins MCP similaires s'activent pour les fournisseurs qui enregistrent MCP via le `.mcp.json` du projet (Claude et Gemini). Pour les projets Codex, les serveurs MCP sont gérés via la configuration globale propre à Codex ; les entrées de plugin dans **Intégrations** sont donc filtrées en conséquence. La carte Jira dans Intégrations est indépendante du fournisseur et s'affiche pour tout le monde — voir le guide Jira.
+Les plugins tiennent compte du fournisseur. Serena prend en charge Claude via `.mcp.json`, Codex via `codex mcp add` avec un `CODEX_HOME` isolé par projet, et Kimi via `.kimi-code/mcp.json`. Un plugin n'apparaît que si son manifeste déclare le fournisseur ; Serena n'est donc pas proposé pour Gemini. La carte Jira reste indépendante du fournisseur.
 
 ## Fichiers réservés
 
-Les plugins gèrent un petit ensemble de fichiers bien défini dans votre projet : votre `.mcp.json` (fusionné chirurgicalement), un peu d'état sous `.specrails/plugins/`, et les fragments d'agent par plugin dans `.claude/agents/custom-<plugin>.md`. Ce sont des ressources d'équipe versionnables si vous souhaitez partager une intégration avec vos coéquipiers — l'app ne les écrase jamais aveuglément.
+Les plugins gèrent la configuration MCP native du fournisseur, l'état sous `.specrails/plugins/` et, uniquement pour Claude si nécessaire, des fragments sous `.claude/agents/custom-<plugin>.md`. Les entrées Kimi vivent dans `.kimi-code/mcp.json` ; l'app n'écrit aucun fragment réservé à Claude pour Kimi et n'écrase jamais une configuration aveuglément.

package/docs/guide/fr/integrations/6-agent-chat.md

@@ -22,7 +22,14 @@ Choisir un projet ici **ne déplace pas** votre tableau de bord : la cible de l'
 
 ## Fournisseur et modèle
 
-Juste au-dessus de la zone de message, vous choisissez le **fournisseur** (Claude, Codex ou Gemini) et son **modèle**. Chaque fournisseur a sa propre liste de modèles, et changer de fournisseur démarre une nouvelle session avec le modèle par défaut de ce fournisseur — vous pouvez ainsi, par exemple, piloter l'application avec Claude et passer à Codex pour une autre conversation sans que rien ne se mélange.
+Juste au-dessus de la zone de message, vous choisissez le **fournisseur**
+(Claude, Codex, Gemini ou Kimi) et son **modèle**. Changer de fournisseur
+démarre une session séparée.
+
+Avec Kimi, les niveaux limitent les outils MCP Specrails mais ne transforment
+pas `kimi -p` en sandbox : ses outils natifs sont approuvés automatiquement.
+Les actions pure-output non sûres sont refusées avant démarrage ; voir la
+[matrice Kimi](../../../kimi.md).
 
 ## Niveaux d'autorisation — c'est vous qui tenez la laisse
 

package/docs/guide/fr/pipeline/1-rails-and-jobs.md

@@ -35,8 +35,8 @@ Voilà. Le rail démarre un processus AI CLI dans le bon contexte d'exécution e
 | **Pastille de statut** | `idle`, `running`, ou `failed`. Il n'y a pas de « completed » séparé — un rail revient à `idle` quand son job se termine proprement. |
 | **Liste de specs** | Les IDs assignés à ce rail. Glissez-en d'autres, retirez-les pour les détacher. |
 | **Sélecteur de Loop** | Le Loop que ce rail exécute — un intégré (`Implement` / `Batch` / `Freestyle`) ou un loop personnalisé. Voir le tableau ci-dessous. Persisté par rail. |
-| **Sélecteur de profil** | Quel profil d'agent s'exécute (rails Claude uniquement). N'apparaît que lorsque le projet a au moins un profil. |
-| **Sélecteur de moteur** | Quel provider installé exécute ce rail — Claude, Codex, ou Gemini. Ne s'affiche que lorsque le projet a plus d'un provider. Voir [Choisir un moteur par rail](picking-an-engine-per-rail). |
+| **Sélecteur de profil** | Quel profil fournisseur s'exécute (rails Claude et Kimi). |
+| **Sélecteur de moteur** | Quel provider exécute ce rail — Claude, Codex, Gemini ou Kimi. |
 | **▶ Play / ■ Stop** | Démarrer ou annuler. |
 
 ### Ce qu'un rail exécute : les Loops
@@ -47,9 +47,11 @@ Un rail exécute un **Loop** — la recette du travail. Trois loops sont **inté
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Un seul job couvrant tous les specs du rail. Exécute tout le pipeline Architect → Developer → Reviewer → Ship. Le choix par défaut au quotidien. |
 | **Batch** | `/specrails:batch-implement` | Un seul job qui traite les specs du rail séquentiellement, en vagues tenant compte des dépendances. Idéal pour plusieurs specs liés. |
-| **Freestyle** | Freestyle | Claude implémente chaque spec de manière autonome, en **contournant** le pipeline. Un job indépendant par spec. Claude uniquement. |
+| **Freestyle** | Freestyle | Claude ou Kimi implémente chaque spec de manière autonome, en **contournant** le pipeline. |
 
-Freestyle est le cas à part : il saute la chaîne d'agents et confie le spec brut à Claude pour qu'il travaille avec ses outils natifs. C'est ouvert, donc appuyer sur Play ouvre d'abord une confirmation, et un sélecteur de modèle par rail vous laisse choisir Haiku / Sonnet / Opus. Il n'apparaît que lorsque le moteur du rail est Claude. Une exécution Freestyle est aussi le seul job qui **reste ouvert pour vous** : discutez avec lui depuis le composeur de la vue détaillée du job et cliquez sur **Finalize** quand vous êtes satisfait (tous les autres jobs se terminent tout seuls).
+Freestyle utilise les outils et modèles natifs du fournisseur. Claude possède
+un transport interactif persistant ; Kimi utilise un processus agentic
+`kimi -p` sans stdin persistant.
 
 Au-delà des intégrés, vous pouvez **construire vos propres loops** — répéter un cycle verify → fix → verify jusqu'à ce qu'un objectif soit atteint, enchaîner des commandes shell entre les étapes IA, et plus encore. Ces loops personnalisés apparaissent dans le même sélecteur de Loop. C'est la prochaine grande idée : [Le Loop Builder](the-loop-builder).
 
@@ -81,7 +83,8 @@ Cliquez sur **■ Stop** dans l'en-tête du rail. L'app envoie `SIGTERM` au sous
 
 ## Si un rail ne se lance pas
 
-Si vous choisissez un moteur dont le CLI n'est pas installé sur votre machine, le lancement **échoue immédiatement** au lieu de démarrer un job cassé — rien ne démarre. Installez le CLI du provider manquant ([Utiliser Codex](../integrations/using-codex), [Utiliser Gemini](../integrations/using-gemini)) et relancez. Un Claude ou Codex manquant donne un message précis « *<provider> CLI not found* » ; un Gemini manquant fait apparaître une erreur de lancement générique aujourd'hui, mais le résultat est le même.
+Si la CLI choisie manque, le lancement échoue avant démarrage. Pour Kimi,
+installez/authentifiez `kimi` 0.27+ ; Desktop ne démarre aucun serveur.
 
 ## Tout arrêter
 
@@ -96,4 +99,4 @@ Si quelque chose semble anormal :
 - [Le Loop Builder](the-loop-builder) — ce qu'un rail exécute, et comment construire vos propres loops.
 - [La vue détaillée du job](the-job-detail-view) — phases, métriques en direct, cartes de ticket.
 - [Batch implement et multi-fonctionnalité](batch-implement-and-multi-feature) — exécutez plusieurs specs à la fois.
-- [Choisir un moteur par rail](picking-an-engine-per-rail) — Claude vs Codex vs Gemini.
+- [Choisir un moteur par rail](picking-an-engine-per-rail) — Claude, Codex, Gemini ou Kimi.

package/docs/guide/fr/pipeline/2-the-job-detail-view.md

@@ -94,7 +94,9 @@ Quelques points à connaître :
 - **La ligne de totaux est réelle.** Le composeur affiche un résumé en direct `N tours · $X`, sommé à partir de l'usage réel de chaque tour terminé — cohérent avec la promesse de cette page de ne rien deviner.
 - **Deux façons de terminer une session.** La plupart des jobs **se terminent tout seuls** : dès qu'un tour se conclut sans message en attente, la session se règle et le job se termine — vos messages sont un pilotage optionnel, jamais une obligation. Une action discrète **Conclure maintenant** l'arrête plus tôt avec tout ce qui a été produit. Les jobs **Freestyle** sont l'exception : ils patientent entre les tours jusqu'à ce que vous cliquiez sur **Finalize** — c'est leur conception, une session d'aller-retour que vous fermez quand vous avez fini.
 - **Dans un loop, les messages vont à l'étape active.** Sur un loop intégré ou personnalisé, votre message atteint **l'étape IA en cours d'exécution**. Entre les étapes (pendant que le Loop Decider réfléchit ou qu'une commande shell tourne), le composeur affiche un bref état *« En attente de la prochaine étape… »* — votre brouillon est conservé, et l'envoi se réactive au démarrage de la prochaine étape IA. **Régler cette étape** termine l'étape en cours plus tôt et laisse le loop avancer avec ce qu'elle a produit.
-- **Claude uniquement, pour l'instant.** Les jobs Codex et Gemini s'exécutent en un seul passage exactement comme avant — aucun composeur n'apparaît. (Les opérateurs du serveur peuvent désactiver toute la fonctionnalité avec `SPECRAILS_INTERACTIVE_JOBS=false`.)
+- **L'interaction persistante est réservée à Claude.** Codex, Gemini et Kimi
+  sont one-shot ; Kimi reprend un chat avec un nouveau `kimi --session=<id> -p` après un
+  resume hint réussi.
 
 ## Export de diagnostic
 

package/docs/guide/fr/pipeline/3-batch-implement-and-multi-feature.md

@@ -81,4 +81,4 @@ Il n'y a aucune limite globale de concurrence à régler. Ouvrez les projets ou
 
 - [Rails et jobs](rails-and-jobs) — le modèle de file d'attente en détail.
 - [La vue détaillée du job](the-job-detail-view) — regarder un batch s'exécuter en direct.
-- [Choisir un moteur par rail](picking-an-engine-per-rail) — notez que Batch fonctionne sur n'importe quel fournisseur ; Freestyle est réservé à Claude.
+- [Choisir un moteur par rail](picking-an-engine-per-rail) — Batch fonctionne avec tous les fournisseurs ; Freestyle est disponible avec Claude et Kimi.

package/docs/guide/fr/pipeline/4-picking-an-engine-per-rail.md

@@ -1,6 +1,8 @@
 # Choisir un moteur par rail
 
-Specrails desktop traite **Claude Code**, **Codex CLI** et **Gemini CLI** comme des moteurs de premier plan. Un projet peut en avoir un, deux ou les trois installés — et lorsque plus d'un est présent, vous choisissez quel moteur exécute chaque rail. Cette page couvre le sélecteur de moteur par rail et le moment où choisir chacun.
+Specrails desktop traite **Claude Code**, **Codex CLI**, **Gemini CLI** et
+**Kimi Code** comme des moteurs de premier plan. Toute combinaison compatible
+peut être installée.
 
 ## Quand le sélecteur apparaît
 
@@ -13,30 +15,28 @@ Quand il apparaît, votre choix se fait **par rail et par lancement** — diffé
 ## Comment choisir un moteur
 
 1. Assurez-vous que le sélecteur de moteur du rail est visible (le projet a 2 fournisseurs ou plus).
-2. Cliquez dessus et choisissez **Claude**, **Codex** ou **Gemini**.
+2. Cliquez dessus et choisissez **Claude**, **Codex**, **Gemini** ou **Kimi**.
 3. Lancez le rail avec **▶ Play**.
 
 Le moteur sélectionné exécute chaque phase du pipeline de ce rail. Si la CLI du moteur choisi n'est pas installée, le lancement échoue immédiatement — rien ne démarre. Installez la CLI manquante et réessayez.
 
 ## Les points forts de chaque moteur
 
-Les trois exécutent les pipelines standards **Implement** et **Batch**. Voici un guide pratique pour choisir :
+Les quatre exécutent **Implement** et **Batch** :
 
 | Moteur | À privilégier quand… | Notes |
 |--------|--------------------|-------|
-| **Claude** | Vous voulez l'ensemble complet des fonctionnalités : profils d'agents, Freestyle, rapport de coût natif, le support d'outils le plus riche. Le choix par défaut pour la plupart du travail. | Le seul moteur qui prend en charge les **profils d'agents**, **Freestyle**, et quelques fonctionnalités de spec réservées à Claude (Contract Layer, SMASH). |
+| **Claude** | Vous avez besoin du coût natif, de l'interaction persistante ou de politiques d'outils strictes. | Profils, Freestyle et transforms structurés. |
 | **Codex** | Vous préférez la CLI Codex d'OpenAI ou vous voulez comparer les implémentations entre fournisseurs. | `codex` ≥ 0.128.0. Pas de rapport de coût natif — l'application complète le coût à partir de sa table de tarifs. Les profils ne s'appliquent pas. |
 | **Gemini** | Vous voulez la CLI Gemini de Google, la télémétrie native, ou une exécution moins chère pour les specs de routine. | `gemini` ≥ 0.11.0 (définissez `GEMINI_API_KEY`). Télémétrie OTLP native. Les profils ne s'appliquent pas. |
+| **Kimi** | Vous voulez Kimi agentic pour Implement, Batch, Freestyle ou loops sans Decider. | `kimi` ≥ 0.27.0 externe ; profils/rôles, effort K3 seulement ; tokens/coût indisponibles. |
 
-### Les fonctionnalités réservées à Claude
+### Différences de capacité
 
-Quelques éléments ne fonctionnent que sur les rails Claude — choisissez Claude si vous en avez besoin :
-
-- **Profils d'agents** — routage de modèle par agent. Sur les rails Codex ou Gemini, l'exécution utilise toujours le mode legacy et tout profil sélectionné est **ignoré**. Le sélecteur de profil est masqué pour les moteurs non-Claude.
-- **Freestyle** — le mode autonome qui contourne le pipeline. Le segment `Freestyle` et son sélecteur de modèle Haiku/Sonnet/Opus n'apparaissent que lorsque le moteur du rail est Claude.
-- **Contract Layer et SMASH** — fonctionnalités de raffinement de spec réservées à Claude (ce sont des options d'Add Spec, pas des options de rail, mais la même contrainte s'applique).
-
-Si un projet mélange les moteurs, la barre latérale droite n'affiche que les sections prises en charge par **tous** les fournisseurs installés — la section **Agents** disparaît donc entièrement sur un projet qui inclut un fournisseur non-Claude, car les profils sont spécifiques à Claude.
+Claude et Kimi prennent en charge profils et Freestyle ; Codex/Gemini
+utilisent le mode legacy. Kimi refuse Loop Decider et les transforms
+pure-output listés dans le [guide Kimi](../../../kimi.md). Les profils
+Claude/Kimi restent séparés.
 
 ## Un flux de travail pratique
 
@@ -49,12 +49,14 @@ Les projets multi-fournisseurs brillent lorsque vous voulez **comparer** ou **op
 ## Points à garder en tête
 
 - **La sélection des fournisseurs est immuable après la création du projet** (v1). Vous choisissez les fournisseurs installés au moment d'ajouter le projet ; il n'y a aucun réglage dans les Paramètres pour en ajouter ou en retirer un plus tard.
-- **Le coût est toujours suivi**, même pour les moteurs sans rapport de coût natif — l'application se rabat sur une table de tarifs, de sorte que les exécutions Codex et Gemini apparaissent quand même dans les [analytics](../analytics/tracking-cost).
+- **Les métriques disponibles sont suivies.** Kimi ne fournit ni tokens ni
+  coût USD autoritatifs ; ces champs restent vides.
 - **Le bouton « Open AI CLI » du terminal** propose également un sélecteur de fournisseur sur les projets multi-fournisseurs, si vous préférez piloter une CLI à la main.
 
 ## Où aller ensuite
 
 - [Utiliser Codex](../integrations/using-codex) — installation et connexion.
 - [Utiliser Gemini](../integrations/using-gemini) — installation, `GEMINI_API_KEY`, télémétrie.
+- [Utiliser Kimi](../../../kimi.md) — installation et matrice complète.
 - [Rails et jobs](rails-and-jobs) — la file d'attente et le flux de lancement.
 - [Suivre le coût](../analytics/tracking-cost) — répartition du coût par moteur.