specrails-desktop 2.18.2 → 2.19.1

package/docs/guide/en/integrations/5-mcp-server.md

@@ -31,6 +31,25 @@ In a client like Claude Desktop or Cursor, the config looks like:
 
 Clients that support remote HTTP MCP servers can instead point straight at `http://127.0.0.1:4200/api/mcp` with the token from the panel.
 
+### From the terminal: Claude Code, Gemini CLI, Codex CLI
+
+Copy your token from **Settings ▸ MCP ▸ Copy token**, then:
+
+```bash
+# Claude Code
+claude mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <your token>"
+
+# Gemini CLI
+gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <your token>"
+
+# Codex CLI (stdio — register the bridge command shown in Settings ▸ MCP)
+codex mcp add specrails -- <bridge command from Settings ▸ MCP>
+```
+
+The `Authorization: Bearer <token>` header works too. If you changed the app port, swap `4200` for yours.
+
 Once connected, your assistant sees about **18 tools** covering the whole app — projects, specs, rails and jobs, chat/Explore, agents, plugins, Jira, loops, the code explorer, analytics, settings — plus a built-in **guide** tool it reads first so it understands how Specrails works without you explaining anything.
 
 ## What you can do with it
@@ -51,7 +70,7 @@ Keep **Destructive** off and it can build all night without ever deleting anythi
 > *"Check all my projects. Tell me which have specs in the backlog and no rail running, and start the highest-priority one in each."*
 
 **Hands-free while you code.** Drive Specrails from your editor or by voice, without switching windows:
-> *"Launch rail 0 in ultracode mode with Opus for ticket #42 and tell me when it's done."*
+> *"Launch rail 0 in Freestyle mode with Opus for ticket #42 and tell me when it's done."*
 
 **Ask about cost and history.** Your analytics, in plain language:
 > *"Where did I spend the most on AI this week, by project and by model? Show me the five most expensive tickets."*

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

@@ -23,7 +23,7 @@ You can have several rails to organise work into named lanes (one for the featur
 ## Launching a rail on a spec
 
 1. **Drag a spec card** from the SpecsBoard onto a rail. The spec's ID shows up in the rail's spec list. (Prefer not to drag? Use the **Move to rail** popover on the spec card — it shows a status dot per rail so you don't drop work onto a busy lane.)
-2. **Pick a Loop** in the rail header. A rail runs a **Loop** — that's the work it performs. The default is the built-in `Implement` loop; you can also pick `Batch`, `Ultracode`, or a custom loop you built yourself. See [The Loop Builder](the-loop-builder).
+2. **Pick a Loop** in the rail header. A rail runs a **Loop** — that's the work it performs. The default is the built-in `Implement` loop; you can also pick `Batch`, `Freestyle`, or a custom loop you built yourself. See [The Loop Builder](the-loop-builder).
 3. **Press ▶ Play.**
 
 That's it. The rail spins up an AI CLI process in your project and starts the pipeline.
@@ -34,7 +34,7 @@ That's it. The rail spins up an AI CLI process in your project and starts the pi
 |---------|--------------|
 | **Status pill** | `idle`, `running`, or `failed`. There's no separate "completed" — a rail returns to `idle` when its job finishes cleanly. |
 | **Spec list** | The IDs assigned to this rail. Drag more in, drag them out to detach. |
-| **Loop picker** | The Loop this rail runs — a built-in (`Implement` / `Batch` / `Ultracode`) or a custom loop. See the table below. Persisted per rail. |
+| **Loop picker** | The Loop this rail runs — a built-in (`Implement` / `Batch` / `Freestyle`) or a custom loop. See the table below. Persisted per rail. |
 | **Profile picker** | Which agent profile runs (Claude rails only). Only appears once the project has at least one profile. |
 | **Engine selector** | Which installed provider runs this rail — Claude, Codex, or Gemini. Only renders when the project has more than one provider. See [Picking an engine per rail](picking-an-engine-per-rail). |
 | **▶ Play / ■ Stop** | Start or cancel. |
@@ -47,9 +47,9 @@ A rail runs a **Loop** — the recipe for the work. Three loops are **built in**
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | One job covering all specs on the rail. Runs the full Architect → Developer → Reviewer → Ship pipeline. The everyday default. |
 | **Batch** | `/specrails:batch-implement` | One job that works through the rail's specs sequentially, in dependency-aware waves. Best for several related specs. |
-| **Ultracode** | Ultracode | Claude implements each spec autonomously, **bypassing** the pipeline. One independent job per spec. Claude only. |
+| **Freestyle** | Freestyle | Claude implements each spec autonomously, **bypassing** the pipeline. One independent job per spec. Claude only. |
 
-Ultracode is the odd one out: it skips the agent chain and hands Claude the raw spec to work on with its native tools. It's open-ended, so pressing Play opens a confirmation first, and a per-rail model picker lets you choose Haiku / Sonnet / Opus. It only appears when the rail's engine is Claude.
+Freestyle is the odd one out: it skips the agent chain and hands Claude the raw spec to work on with its native tools. It's open-ended, so pressing Play opens a confirmation first, and a per-rail model picker lets you choose Haiku / Sonnet / Opus. It only appears when the rail's engine is Claude.
 
 Beyond the built-ins, you can **build your own loops** — repeat a verify → fix → verify cycle until a goal is met, chain shell commands between AI steps, and more. Those custom loops appear in the same Loop picker. That's the next big idea: [The Loop Builder](the-loop-builder).
 

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

@@ -35,7 +35,7 @@ Each phase is a specialised agent the rail's engine invokes in your project dire
 | **Reviewer** | `sr-reviewer` | Reviews the output. |
 | **Ship** | (varies) | Final wrap-up: tests, commit, PR draft. |
 
-Which agent handles each phase is decided by the project's **agent profile**. The baseline trio (`sr-architect`, `sr-developer`, `sr-reviewer`) is always present; routing rules in a profile can add agents or swap which one runs a phase. The phase progress bar only appears when the command actually defines phases — Ultracode jobs (which bypass the pipeline) won't show one.
+Which agent handles each phase is decided by the project's **agent profile**. The baseline trio (`sr-architect`, `sr-developer`, `sr-reviewer`) is always present; routing rules in a profile can add agents or swap which one runs a phase. The phase progress bar only appears when the command actually defines phases — Freestyle jobs (which bypass the pipeline) won't show one.
 
 ## Live metrics — honest by design
 

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

@@ -24,7 +24,7 @@ All three run the standard **Implement** and **Batch** pipelines. Here's a pract
 
 | Engine | Reach for it when… | Notes |
 |--------|--------------------|-------|
-| **Claude** | You want the full feature set: agent profiles, Ultracode, native cost reporting, the richest tool support. The default for most work. | The only engine that supports **agent profiles**, **Ultracode**, and a few Claude-only spec features (Contract Layer, SMASH). |
+| **Claude** | You want the full feature set: agent profiles, Freestyle, native cost reporting, the richest tool support. The default for most work. | The only engine that supports **agent profiles**, **Freestyle**, and a few Claude-only spec features (Contract Layer, SMASH). |
 | **Codex** | You prefer the OpenAI Codex CLI or want to compare implementations across providers. | `codex` ≥ 0.128.0. No native cost reporting — the app fills in cost from its rate card. Profiles don't apply. |
 | **Gemini** | You want Google's Gemini CLI, native telemetry, or a cheaper run for routine specs. | `gemini` ≥ 0.11.0 (set `GEMINI_API_KEY`). Native OTLP telemetry. Profiles don't apply. |
 
@@ -33,7 +33,7 @@ All three run the standard **Implement** and **Batch** pipelines. Here's a pract
 A few things only work on Claude rails — pick Claude if you need them:
 
 - **Agent profiles** — per-agent model routing. On Codex or Gemini rails the run always uses legacy mode and any selected profile is **ignored**. The profile picker is hidden for non-Claude engines.
-- **Ultracode (`Ultra` mode)** — the autonomous, pipeline-bypassing mode. The `Ultra` segment and its Haiku/Sonnet/Opus model picker only appear when the rail's engine is Claude.
+- **Freestyle** — the autonomous, pipeline-bypassing mode. The `Freestyle` segment and its Haiku/Sonnet/Opus model picker only appear when the rail's engine is Claude.
 - **Contract Layer & SMASH** — Claude-only spec-refinement features (these are Add-Spec options, not rail options, but the same constraint applies).
 
 If a project mixes engines, the right sidebar only shows sections **every** installed provider supports — so the **Agents** section disappears entirely on a project that includes any non-Claude provider, because profiles are Claude-specific.

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

@@ -1,6 +1,6 @@
 # The Loop Builder
 
-A **rail runs a Loop**. The built-in loops (`Implement`, `Batch`, `Ultracode`) cover the everyday cases, but the **Loop Builder** lets you design your own — a visual, n8n-style editor for automation that repeats until a goal is met. This page explains what a loop is, how to build one, and how to run it on a rail.
+A **rail runs a Loop**. The built-in loops (`Implement`, `Batch`, `Freestyle`) cover the everyday cases, but the **Loop Builder** lets you design your own — a visual, n8n-style editor for automation that repeats until a goal is met. This page explains what a loop is, how to build one, and how to run it on a rail.
 
 ## Loops and rails — the relationship
 
@@ -11,7 +11,7 @@ A **loop** is the *recipe* for the work; a **rail** is the *lane* that runs it a
    ───────────────────────────             ─────────────
    Implement   (built-in)                  Rail 1
    Batch       (built-in)      pick on ►      Loop: Verify-until-green
-   Ultracode   (built-in)                     ▶ Play
+   Freestyle   (built-in)                     ▶ Play
    Verify-until-green (yours)
 ```
 

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

@@ -6,7 +6,7 @@ Specrails no está atado a una única IA. Cada parte de la app que habla con una
 
 | Proveedor | CLI | Creado por | Notas |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | El más completo. El único proveedor para Agents (perfiles) y los rails Ultracode, y para Contract Refine. |
+| **Claude** | `claude` | Anthropic | El más completo. El único proveedor para Agents (perfiles) y los rails Freestyle, y para Contract Refine. |
 | **Codex** | `codex` | OpenAI | Necesita codex `0.128.0+`. Lee sus servidores MCP desde tu `~/.codex/config.toml` global. |
 | **Gemini** | `gemini` | Google | Necesita gemini `0.11.0+`. Usa telemetría nativa y un archivo de instrucciones `GEMINI.md`. |
 
@@ -43,7 +43,7 @@ Tu elección se recuerda por proyecto y toma el proveedor principal por defecto,
 Un puñado de funciones son específicas de Claude por naturaleza, así que se ocultan o se omiten cuando hay otro proveedor en juego:
 
 - **Agents (perfiles)** — el catálogo de agentes por proyecto y el enrutado de modelos. Se oculta en cualquier proyecto que incluya un proveedor que no sea Claude.
-- **Rails Ultracode** — siempre se ejecutan con Claude.
+- **Rails Freestyle** — siempre se ejecutan con Claude.
 - **Contract Refine** — la pasada adicional de «Contract Layer» sobre una spec confirmada solo se ejecuta cuando el proveedor de la conversación es Claude.
 - **Modos avanzados de Añadir spec** (SMASH / Contract Layer) — se ocultan para los motores que no sean Claude.
 

package/docs/guide/es/integrations/5-mcp-server.md

@@ -31,6 +31,25 @@ En un cliente como Claude Desktop o Cursor, la configuración tiene este aspecto
 
 Los clientes que admiten servidores MCP remotos por HTTP pueden, en su lugar, apuntar directamente a `http://127.0.0.1:4200/api/mcp` con el token del panel.
 
+### Desde la terminal: Claude Code, Gemini CLI, Codex CLI
+
+Copia tu token desde **Ajustes ▸ MCP ▸ Copiar token** y después:
+
+```bash
+# Claude Code
+claude mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <tu token>"
+
+# Gemini CLI
+gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <tu token>"
+
+# Codex CLI (stdio — registra el comando del bridge que muestra Ajustes ▸ MCP)
+codex mcp add specrails -- <comando del bridge de Ajustes ▸ MCP>
+```
+
+La cabecera `Authorization: Bearer <token>` también funciona. Si cambiaste el puerto de la app, sustituye `4200` por el tuyo.
+
 Una vez conectado, tu asistente ve unas **18 herramientas** que cubren toda la app — proyectos, specs, rails y trabajos, chat/Explore, agentes, plugins, Jira, loops, el explorador de código, analíticas, configuración — más una herramienta de **guía** incorporada que lee primero para entender cómo funciona Specrails sin que tú tengas que explicar nada.
 
 ## Qué puedes hacer con él
@@ -51,7 +70,7 @@ Mantén **Destructivo** desactivado y podrá trabajar toda la noche sin borrar n
 > *"Revisa todos mis proyectos. Dime cuáles tienen specs en el backlog y ningún rail en marcha, y arranca el de mayor prioridad en cada uno."*
 
 **Sin manos mientras programas.** Maneja Specrails desde tu editor o por voz, sin cambiar de ventana:
-> *"Lanza el rail 0 en modo ultracode con Opus para el ticket #42 y avísame cuando termine."*
+> *"Lanza el rail 0 en modo Freestyle con Opus para el ticket #42 y avísame cuando termine."*
 
 **Pregunta por el coste y el historial.** Tus analíticas, en lenguaje natural:
 > *"¿Dónde he gastado más en IA esta semana, por proyecto y por modelo? Enséñame los cinco tickets más caros."*

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

@@ -23,7 +23,7 @@ Puedes tener varios rails para organizar el trabajo en carriles con nombre (uno
 ## Lanzar un rail sobre una spec
 
 1. **Arrastra una tarjeta de spec** desde el SpecsBoard hasta un rail. El ID de la spec aparece en la lista de specs del rail. (¿Prefieres no arrastrar? Usa el popover **Mover a rail** en la tarjeta de la spec — muestra un punto de estado por cada rail para que no dejes trabajo en un carril ocupado.)
-2. **Elige un Loop** en la cabecera del rail. Un rail ejecuta un **Loop** — eso es el trabajo que realiza. El predeterminado es el loop `Implement` integrado; también puedes elegir `Batch`, `Ultracode` o un loop personalizado que hayas construido tú mismo. Mira [El Loop Builder](the-loop-builder).
+2. **Elige un Loop** en la cabecera del rail. Un rail ejecuta un **Loop** — eso es el trabajo que realiza. El predeterminado es el loop `Implement` integrado; también puedes elegir `Batch`, `Freestyle` o un loop personalizado que hayas construido tú mismo. Mira [El Loop Builder](the-loop-builder).
 3. **Pulsa ▶ Play.**
 
 Eso es todo. El rail arranca un proceso de la CLI de IA en tu proyecto y empieza el pipeline.
@@ -34,7 +34,7 @@ Eso es todo. El rail arranca un proceso de la CLI de IA en tu proyecto y empieza
 |---------|--------------|
 | **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` / `Ultracode`) o un loop personalizado. Mira la tabla de más abajo. Se recuerda por rail. |
+| **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). |
 | **▶ Play / ■ Stop** | Iniciar o cancelar. |
@@ -47,9 +47,9 @@ 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. |
-| **Ultracode** | Ultracode | Claude implementa cada spec de forma autónoma, **saltándose** el pipeline. Un job independiente por spec. Solo Claude. |
+| **Freestyle** | Freestyle | Claude implementa cada spec de forma autónoma, **saltándose** el pipeline. Un job independiente por spec. Solo Claude. |
 
-Ultracode 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.
+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.
 
 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).
 

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

@@ -35,7 +35,7 @@ Cada fase es un agente especializado que el motor del rail invoca en el director
 | **Reviewer** | `sr-reviewer` | Revisa el resultado. |
 | **Ship** | (varía) | Cierre final: tests, commit, borrador de PR. |
 
-Qué agente se encarga de cada fase lo decide el **perfil de agentes** del proyecto. El trío base (`sr-architect`, `sr-developer`, `sr-reviewer`) está siempre presente; las reglas de enrutamiento de un perfil pueden añadir agentes o cambiar cuál ejecuta una fase. La barra de progreso de fases solo aparece cuando el comando define realmente fases — los jobs de Ultracode (que se saltan el pipeline) no mostrarán ninguna.
+Qué agente se encarga de cada fase lo decide el **perfil de agentes** del proyecto. El trío base (`sr-architect`, `sr-developer`, `sr-reviewer`) está siempre presente; las reglas de enrutamiento de un perfil pueden añadir agentes o cambiar cuál ejecuta una fase. La barra de progreso de fases solo aparece cuando el comando define realmente fases — los jobs de Freestyle (que se saltan el pipeline) no mostrarán ninguna.
 
 ## Métricas en vivo — honestas por diseño
 

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

@@ -24,7 +24,7 @@ Los tres ejecutan los pipelines estándar **Implement** y **Batch**. Aquí tiene
 
 | Motor | Recurre a él cuando… | Notas |
 |--------|--------------------|-------|
-| **Claude** | Quieres el conjunto completo de funciones: perfiles de agentes, Ultracode, 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**, **Ultracode** y algunas funciones de spec exclusivas de Claude (Contract Layer, SMASH). |
+| **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). |
 | **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. |
 
@@ -33,7 +33,7 @@ Los tres ejecutan los pipelines estándar **Implement** y **Batch**. Aquí tiene
 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.
-- **Ultracode (modo `Ultra`)** — el modo autónomo que se salta el pipeline. El segmento `Ultra` y su selector de modelo Haiku/Sonnet/Opus solo aparecen cuando el motor del rail es 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.

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

@@ -1,6 +1,6 @@
 # El Loop Builder
 
-Un **rail ejecuta un Loop**. Los loops integrados (`Implement`, `Batch`, `Ultracode`) cubren los casos del día a día, pero el **Loop Builder** te permite diseñar el tuyo propio — un editor visual al estilo n8n para automatizaciones que se repiten hasta cumplir un objetivo. Esta página explica qué es un loop, cómo construir uno y cómo ejecutarlo en un rail.
+Un **rail ejecuta un Loop**. Los loops integrados (`Implement`, `Batch`, `Freestyle`) cubren los casos del día a día, pero el **Loop Builder** te permite diseñar el tuyo propio — un editor visual al estilo n8n para automatizaciones que se repiten hasta cumplir un objetivo. Esta página explica qué es un loop, cómo construir uno y cómo ejecutarlo en un rail.
 
 ## Loops y rails — la relación
 
@@ -11,7 +11,7 @@ Un **loop** es la *receta* del trabajo; un **rail** es el *carril* que la ejecut
    ───────────────────────────             ─────────────
    Implement   (integrado)                 Rail 1
    Batch       (integrado)     elige en ►     Loop: Verify-until-green
-   Ultracode   (integrado)                    ▶ Play
+   Freestyle   (integrado)                    ▶ Play
    Verify-until-green (tuyo)
 ```
 

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

@@ -6,7 +6,7 @@ Specrails n'est lié à aucune IA en particulier. Chaque endroit de l'app qui di
 
 | Fournisseur | CLI | Édité par | Notes |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | Le plus complet. Seul fournisseur pour les Agents (profils), les rails Ultracode et le Contract Refine. |
+| **Claude** | `claude` | Anthropic | Le plus complet. Seul fournisseur pour les Agents (profils), les rails Freestyle et le Contract Refine. |
 | **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`. |
 
@@ -43,7 +43,7 @@ Votre choix est mémorisé par projet, avec le fournisseur principal comme valeu
 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 :
 
 - **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 Ultracode** — toujours exécutés sur 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.
 

package/docs/guide/fr/integrations/5-mcp-server.md

@@ -31,6 +31,25 @@ Dans un client comme Claude Desktop ou Cursor, la configuration ressemble à cec
 
 Les clients qui prennent en charge les serveurs MCP HTTP distants peuvent à la place pointer directement vers `http://127.0.0.1:4200/api/mcp` avec le jeton du panneau.
 
+### Depuis le terminal : Claude Code, Gemini CLI, Codex CLI
+
+Copiez votre jeton depuis **Réglages ▸ MCP ▸ Copier le jeton**, puis :
+
+```bash
+# Claude Code
+claude mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <votre jeton>"
+
+# Gemini CLI
+gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <votre jeton>"
+
+# Codex CLI (stdio — enregistrez la commande du bridge affichée dans Réglages ▸ MCP)
+codex mcp add specrails -- <commande du bridge depuis Réglages ▸ MCP>
+```
+
+L'en-tête `Authorization: Bearer <token>` fonctionne aussi. Si vous avez changé le port de l'app, remplacez `4200`.
+
 Une fois connecté, votre assistant voit environ **18 outils** couvrant toute l'app — projets, specs, rails et jobs, chat/Explore, agents, plugins, Jira, loops, l'explorateur de code, les analyses, les paramètres — plus un outil **guide** intégré qu'il lit en premier afin de comprendre le fonctionnement de Specrails sans que vous ayez à expliquer quoi que ce soit.
 
 ## Ce que vous pouvez en faire
@@ -51,7 +70,7 @@ Gardez **Destructif** désactivé et il peut construire toute la nuit sans jamai
 > *« Vérifie tous mes projets. Dis-moi lesquels ont des specs dans le backlog sans aucun rail en cours, et démarre la plus prioritaire dans chacun. »*
 
 **Sans les mains pendant que vous codez.** Pilotez Specrails depuis votre éditeur ou à la voix, sans changer de fenêtre :
-> *« Lance le rail 0 en mode ultracode avec Opus pour le ticket #42 et préviens-moi quand c'est terminé. »*
+> *« Lance le rail 0 en mode Freestyle avec Opus pour le ticket #42 et préviens-moi quand c'est terminé. »*
 
 **Interrogez les coûts et l'historique.** Vos analyses, en langage clair :
 > *« Où ai-je le plus dépensé en IA cette semaine, par projet et par modèle ? Montre-moi les cinq tickets les plus coûteux. »*

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

@@ -23,7 +23,7 @@ Vous pouvez avoir plusieurs rails pour organiser le travail en voies nommées (u
 ## Lancer un rail sur un spec
 
 1. **Glissez une carte de spec** depuis le SpecsBoard sur un rail. L'ID du spec apparaît dans la liste de specs du rail. (Vous préférez ne pas glisser ? Utilisez le popover **Move to rail** sur la carte de spec — il affiche un point de statut par rail pour que vous ne déposiez pas de travail sur une voie occupée.)
-2. **Choisissez un Loop** dans l'en-tête du rail. Un rail exécute un **Loop** — c'est le travail qu'il effectue. Par défaut, c'est le Loop intégré `Implement` ; vous pouvez aussi choisir `Batch`, `Ultracode`, ou un loop personnalisé que vous avez construit vous-même. Voir [Le Loop Builder](the-loop-builder).
+2. **Choisissez un Loop** dans l'en-tête du rail. Un rail exécute un **Loop** — c'est le travail qu'il effectue. Par défaut, c'est le Loop intégré `Implement` ; vous pouvez aussi choisir `Batch`, `Freestyle`, ou un loop personnalisé que vous avez construit vous-même. Voir [Le Loop Builder](the-loop-builder).
 3. **Appuyez sur ▶ Play.**
 
 Voilà. Le rail démarre un processus AI CLI dans votre projet et lance le pipeline.
@@ -34,7 +34,7 @@ Voilà. Le rail démarre un processus AI CLI dans votre projet et lance le pipel
 |---------|--------------|
 | **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` / `Ultracode`) ou un loop personnalisé. Voir le tableau ci-dessous. Persisté par rail. |
+| **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). |
 | **▶ Play / ■ Stop** | Démarrer ou annuler. |
@@ -47,9 +47,9 @@ 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. |
-| **Ultracode** | Ultracode | Claude implémente chaque spec de manière autonome, en **contournant** le pipeline. Un job indépendant par spec. Claude uniquement. |
+| **Freestyle** | Freestyle | Claude implémente chaque spec de manière autonome, en **contournant** le pipeline. Un job indépendant par spec. Claude uniquement. |
 
-Ultracode 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.
+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.
 
 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).
 

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

@@ -35,7 +35,7 @@ Chaque phase est un agent spécialisé que le moteur du rail invoque dans le ré
 | **Reviewer** | `sr-reviewer` | Relit le résultat. |
 | **Ship** | (variable) | Finalisation : tests, commit, brouillon de PR. |
 
-Quel agent gère chaque phase est décidé par le **profil d'agent** du projet. Le trio de base (`sr-architect`, `sr-developer`, `sr-reviewer`) est toujours présent ; les règles de routage d'un profil peuvent ajouter des agents ou changer celui qui exécute une phase. La barre de progression des phases n'apparaît que lorsque la commande définit réellement des phases — les jobs Ultracode (qui contournent le pipeline) n'en affichent pas.
+Quel agent gère chaque phase est décidé par le **profil d'agent** du projet. Le trio de base (`sr-architect`, `sr-developer`, `sr-reviewer`) est toujours présent ; les règles de routage d'un profil peuvent ajouter des agents ou changer celui qui exécute une phase. La barre de progression des phases n'apparaît que lorsque la commande définit réellement des phases — les jobs Freestyle (qui contournent le pipeline) n'en affichent pas.
 
 ## Métriques en direct — honnêtes par conception
 

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

@@ -24,7 +24,7 @@ Les trois exécutent les pipelines standards **Implement** et **Batch**. Voici u
 
 | Moteur | À privilégier quand… | Notes |
 |--------|--------------------|-------|
-| **Claude** | Vous voulez l'ensemble complet des fonctionnalités : profils d'agents, Ultracode, 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**, **Ultracode**, et quelques fonctionnalités de spec réservées à Claude (Contract Layer, SMASH). |
+| **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). |
 | **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. |
 
@@ -33,7 +33,7 @@ Les trois exécutent les pipelines standards **Implement** et **Batch**. Voici u
 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.
-- **Ultracode (mode `Ultra`)** — le mode autonome qui contourne le pipeline. Le segment `Ultra` et son sélecteur de modèle Haiku/Sonnet/Opus n'apparaissent que lorsque le moteur du rail est 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.

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

@@ -1,6 +1,6 @@
 # Le Loop Builder
 
-Un **rail exécute un Loop**. Les loops intégrés (`Implement`, `Batch`, `Ultracode`) couvrent les cas du quotidien, mais le **Loop Builder** vous laisse concevoir les vôtres — un éditeur visuel, de style n8n, pour de l'automatisation qui se répète jusqu'à ce qu'un objectif soit atteint. Cette page explique ce qu'est un loop, comment en construire un, et comment l'exécuter sur un rail.
+Un **rail exécute un Loop**. Les loops intégrés (`Implement`, `Batch`, `Freestyle`) couvrent les cas du quotidien, mais le **Loop Builder** vous laisse concevoir les vôtres — un éditeur visuel, de style n8n, pour de l'automatisation qui se répète jusqu'à ce qu'un objectif soit atteint. Cette page explique ce qu'est un loop, comment en construire un, et comment l'exécuter sur un rail.
 
 ## Loops et rails — la relation
 
@@ -11,7 +11,7 @@ Un **loop** est la *recette* du travail ; un **rail** est la *voie* qui l'exécu
    ───────────────────────────             ─────────────
    Implement   (intégré)                   Rail 1
    Batch       (intégré)      choisir ►       Loop: Verify-until-green
-   Ultracode   (intégré)                      ▶ Play
+   Freestyle   (intégré)                      ▶ Play
    Verify-until-green (le vôtre)
 ```
 

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

@@ -6,7 +6,7 @@ Specrails non è legato a una sola AI. Ogni parte dell'app che dialoga con un'AI
 
 | Provider | CLI | Realizzato da | Note |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | Il più completo. È l'unico provider per gli Agenti (profili), i rail Ultracode e il Contract Refine. |
+| **Claude** | `claude` | Anthropic | Il più completo. È l'unico provider per gli Agenti (profili), i rail Freestyle e il Contract Refine. |
 | **Codex** | `codex` | OpenAI | Richiede codex `0.128.0+`. Legge i suoi server MCP dal file globale `~/.codex/config.toml`. |
 | **Gemini** | `gemini` | Google | Richiede gemini `0.11.0+`. Usa la telemetria nativa e un file di istruzioni `GEMINI.md`. |
 
@@ -43,7 +43,7 @@ La tua scelta viene ricordata per progetto, con il provider primario come defaul
 Alcune funzioni sono per natura specifiche di Claude, quindi vengono nascoste o saltate quando è in uso un altro provider:
 
 - **Agenti (profili)** — il catalogo degli agenti per progetto e il routing dei modelli. Nascosti in qualsiasi progetto che includa un provider diverso da Claude.
-- **Rail Ultracode** — vengono sempre eseguiti su Claude.
+- **Rail Freestyle** — vengono sempre eseguiti su Claude.
 - **Contract Refine** — il passaggio aggiuntivo "Contract Layer" su una spec confermata viene eseguito solo quando il provider della conversazione è Claude.
 - **Modalità avanzate di Add Spec** (SMASH / Contract Layer) — nascoste per i motori diversi da Claude.
 

package/docs/guide/it/integrations/5-mcp-server.md

@@ -31,6 +31,25 @@ In un client come Claude Desktop o Cursor, la configurazione si presenta così:
 
 I client che supportano i server MCP HTTP remoti possono invece puntare direttamente a `http://127.0.0.1:4200/api/mcp` con il token preso dal pannello.
 
+### Dal terminale: Claude Code, Gemini CLI, Codex CLI
+
+Copia il tuo token da **Impostazioni ▸ MCP ▸ Copia token**, poi:
+
+```bash
+# Claude Code
+claude mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <il tuo token>"
+
+# Gemini CLI
+gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <il tuo token>"
+
+# Codex CLI (stdio — registra il comando bridge mostrato in Impostazioni ▸ MCP)
+codex mcp add specrails -- <comando bridge da Impostazioni ▸ MCP>
+```
+
+Funziona anche l'header `Authorization: Bearer <token>`. Se hai cambiato la porta dell'app, sostituisci `4200`.
+
 Una volta collegato, il tuo assistente vede circa **18 strumenti** che coprono l'intera app — progetti, spec, rail e job, chat/Explore, agenti, plugin, Jira, loop, l'esploratore del codice, le analisi, le impostazioni — più uno strumento **guida** integrato che legge per primo, così capisce come funziona Specrails senza che tu debba spiegargli nulla.
 
 ## Cosa puoi farci
@@ -51,7 +70,7 @@ Tieni **Distruttivo** disattivato e potrà lavorare tutta la notte senza mai eli
 > *"Controlla tutti i miei progetti. Dimmi quali hanno spec nel backlog e nessun rail in esecuzione, e avvia in ognuno quella a priorità più alta."*
 
 **Senza mani mentre programmi.** Pilota Specrails dal tuo editor o a voce, senza cambiare finestra:
-> *"Lancia il rail 0 in modalità ultracode con Opus per il ticket #42 e dimmi quando ha finito."*
+> *"Lancia il rail 0 in modalità Freestyle con Opus per il ticket #42 e dimmi quando ha finito."*
 
 **Chiedi di costi e cronologia.** Le tue analisi, in linguaggio naturale:
 > *"Dove ho speso di più in AI questa settimana, per progetto e per modello? Mostrami i cinque ticket più costosi."*

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

@@ -23,7 +23,7 @@ Puoi avere diversi rail per organizzare il lavoro in corsie con un nome (una per
 ## Avviare un rail su una spec
 
 1. **Trascina una scheda spec** dalla SpecsBoard su un rail. L'ID della spec compare nell'elenco di spec del rail. (Preferisci non trascinare? Usa il popover **Sposta su un rail** sulla scheda spec — mostra un pallino di stato per ogni rail, così non scarichi del lavoro su una corsia già occupata.)
-2. **Scegli un Loop** nell'intestazione del rail. Un rail esegue un **Loop** — è il lavoro che svolge. Quello predefinito è il Loop `Implement` integrato; puoi anche scegliere `Batch`, `Ultracode` o un loop personalizzato che hai costruito tu. Vedi [Il Loop Builder](the-loop-builder).
+2. **Scegli un Loop** nell'intestazione del rail. Un rail esegue un **Loop** — è il lavoro che svolge. Quello predefinito è il Loop `Implement` integrato; puoi anche scegliere `Batch`, `Freestyle` o un loop personalizzato che hai costruito tu. Vedi [Il Loop Builder](the-loop-builder).
 3. **Premi ▶ Play.**
 
 Tutto qui. Il rail avvia un processo CLI AI nel tuo progetto e dà il via alla pipeline.
@@ -34,7 +34,7 @@ Tutto qui. Il rail avvia un processo CLI AI nel tuo progetto e dà il via alla p
 |---------|--------------|
 | **Pillola di stato** | `idle`, `running` o `failed`. Non esiste uno stato "completed" separato — un rail torna a `idle` quando il suo job termina senza errori. |
 | **Elenco spec** | Gli ID assegnati a questo rail. Trascinane altri dentro, oppure fuori per staccarli. |
-| **Selettore Loop** | Il Loop che questo rail esegue — uno integrato (`Implement` / `Batch` / `Ultracode`) o un loop personalizzato. Vedi la tabella più sotto. Viene salvato per ogni rail. |
+| **Selettore Loop** | Il Loop che questo rail esegue — uno integrato (`Implement` / `Batch` / `Freestyle`) o un loop personalizzato. Vedi la tabella più sotto. Viene salvato per ogni rail. |
 | **Selettore profilo** | Quale profilo agente viene eseguito (solo per i rail Claude). Compare solo quando il progetto ha almeno un profilo. |
 | **Selettore engine** | Quale provider installato esegue questo rail — Claude, Codex o Gemini. Viene mostrato solo quando il progetto ha più di un provider. Vedi [Scegliere un engine per ogni rail](picking-an-engine-per-rail). |
 | **▶ Play / ■ Stop** | Avvia o annulla. |
@@ -47,9 +47,9 @@ Un rail esegue un **Loop** — la ricetta del lavoro. Tre loop sono **integrati*
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Un unico job che copre tutte le spec sul rail. Esegue l'intera pipeline Architect → Developer → Reviewer → Ship. L'impostazione predefinita di tutti i giorni. |
 | **Batch** | `/specrails:batch-implement` | Un unico job che lavora le spec del rail in sequenza, in ondate consapevoli delle dipendenze. Ideale per più spec correlate. |
-| **Ultracode** | Ultracode | Claude implementa ogni spec in autonomia, **bypassando** la pipeline. Un job indipendente per ogni spec. Solo Claude. |
+| **Freestyle** | Freestyle | Claude implementa ogni spec in autonomia, **bypassando** la pipeline. Un job indipendente per ogni spec. Solo Claude. |
 
-Ultracode è il caso a sé stante: salta la catena di agenti e affida a Claude la spec grezza, lasciandolo lavorare con i suoi strumenti nativi. È a finalità aperta, quindi premendo Play si apre prima una conferma, e un selettore di modello per rail ti permette di scegliere tra Haiku / Sonnet / Opus. Compare solo quando l'engine del rail è Claude.
+Freestyle è il caso a sé stante: salta la catena di agenti e affida a Claude la spec grezza, lasciandolo lavorare con i suoi strumenti nativi. È a finalità aperta, quindi premendo Play si apre prima una conferma, e un selettore di modello per rail ti permette di scegliere tra Haiku / Sonnet / Opus. Compare solo quando l'engine del rail è Claude.
 
 Oltre agli integrati, puoi **costruire i tuoi loop** — ripetere un ciclo verify → fix → verify finché un obiettivo non è raggiunto, concatenare comandi shell tra gli AI Step e altro ancora. Quei loop personalizzati compaiono nello stesso selettore Loop. È la prossima grande idea: [Il Loop Builder](the-loop-builder).
 

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

@@ -35,7 +35,7 @@ Ogni fase è un agente specializzato che l'engine del rail invoca nella cartella
 | **Reviewer** | `sr-reviewer` | Revisiona il risultato. |
 | **Ship** | (variabile) | Conclusione finale: test, commit, bozza di PR. |
 
-Quale agente gestisce ogni fase lo decide il **profilo agente** del progetto. Il trio di base (`sr-architect`, `sr-developer`, `sr-reviewer`) è sempre presente; le regole di routing in un profilo possono aggiungere agenti o cambiare quale di essi esegue una fase. La barra di avanzamento delle fasi compare solo quando il comando definisce effettivamente delle fasi — i job Ultracode (che bypassano la pipeline) non ne mostrano alcuna.
+Quale agente gestisce ogni fase lo decide il **profilo agente** del progetto. Il trio di base (`sr-architect`, `sr-developer`, `sr-reviewer`) è sempre presente; le regole di routing in un profilo possono aggiungere agenti o cambiare quale di essi esegue una fase. La barra di avanzamento delle fasi compare solo quando il comando definisce effettivamente delle fasi — i job Freestyle (che bypassano la pipeline) non ne mostrano alcuna.
 
 ## Metriche live — oneste per scelta
 

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

@@ -24,7 +24,7 @@ Tutti e tre eseguono le pipeline standard **Implement** e **Batch**. Ecco una gu
 
 | Engine | Scegli questo quando… | Note |
 |--------|--------------------|-------|
-| **Claude** | Vuoi l'intero set di funzionalità: profili agente, Ultracode, reportistica nativa dei costi, il supporto agli strumenti più ricco. L'impostazione predefinita per la maggior parte del lavoro. | L'unico engine che supporta i **profili agente**, **Ultracode** e alcune funzionalità delle spec esclusive di Claude (Contract Layer, SMASH). |
+| **Claude** | Vuoi l'intero set di funzionalità: profili agente, Freestyle, reportistica nativa dei costi, il supporto agli strumenti più ricco. L'impostazione predefinita per la maggior parte del lavoro. | L'unico engine che supporta i **profili agente**, **Freestyle** e alcune funzionalità delle spec esclusive di Claude (Contract Layer, SMASH). |
 | **Codex** | Preferisci la CLI Codex di OpenAI o vuoi confrontare le implementazioni tra provider diversi. | `codex` ≥ 0.128.0. Nessuna reportistica nativa dei costi — l'app ricava il costo dalla sua tabella prezzi. I profili non si applicano. |
 | **Gemini** | Vuoi la CLI Gemini di Google, telemetria nativa o un'esecuzione più economica per le spec di routine. | `gemini` ≥ 0.11.0 (imposta `GEMINI_API_KEY`). Telemetria OTLP nativa. I profili non si applicano. |
 
@@ -33,7 +33,7 @@ Tutti e tre eseguono le pipeline standard **Implement** e **Batch**. Ecco una gu
 Alcune cose funzionano solo sui rail Claude — scegli Claude se ne hai bisogno:
 
 - **Profili agente** — routing del modello per ogni agente. Sui rail Codex o Gemini l'esecuzione usa sempre la modalità legacy e qualsiasi profilo selezionato viene **ignorato**. Il selettore di profilo è nascosto per gli engine diversi da Claude.
-- **Ultracode (modalità `Ultra`)** — la modalità autonoma che bypassa la pipeline. Il segmento `Ultra` e il suo selettore di modello Haiku/Sonnet/Opus compaiono solo quando l'engine del rail è Claude.
+- **Freestyle** — la modalità autonoma che bypassa la pipeline. Il segmento `Freestyle` e il suo selettore di modello Haiku/Sonnet/Opus compaiono solo quando l'engine del rail è Claude.
 - **Contract Layer e SMASH** — funzionalità di affinamento delle spec esclusive di Claude (sono opzioni di Add Spec, non opzioni del rail, ma vale lo stesso vincolo).
 
 Se un progetto mescola engine, la barra laterale destra mostra solo le sezioni supportate da **ogni** provider installato — quindi la sezione **Agenti** sparisce del tutto su un progetto che include un provider diverso da Claude, perché i profili sono specifici di Claude.

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

@@ -1,6 +1,6 @@
 # Il Loop Builder
 
-Un **rail esegue un Loop**. I loop integrati (`Implement`, `Batch`, `Ultracode`) coprono i casi di tutti i giorni, ma il **Loop Builder** ti permette di progettare i tuoi — un editor visuale in stile n8n per automazioni che si ripetono finché un obiettivo non è raggiunto. Questa pagina spiega cos'è un loop, come costruirne uno e come eseguirlo su un rail.
+Un **rail esegue un Loop**. I loop integrati (`Implement`, `Batch`, `Freestyle`) coprono i casi di tutti i giorni, ma il **Loop Builder** ti permette di progettare i tuoi — un editor visuale in stile n8n per automazioni che si ripetono finché un obiettivo non è raggiunto. Questa pagina spiega cos'è un loop, come costruirne uno e come eseguirlo su un rail.
 
 ## Loop e rail — la relazione
 
@@ -11,7 +11,7 @@ Un **loop** è la *ricetta* del lavoro; un **rail** è la *corsia* che lo esegue
    ───────────────────────────             ─────────────
    Implement   (integrato)                 Rail 1
    Batch       (integrato)     scegli su ►    Loop: Verify-until-green
-   Ultracode   (integrato)                    ▶ Play
+   Freestyle   (integrato)                    ▶ Play
    Verify-until-green (tuo)
 ```
 

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

@@ -6,7 +6,7 @@ Specrails は特定の AI に縛られません。アプリの中で AI とや
 
 | プロバイダー | CLI | 提供元 | 備考 |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | 最も機能が充実しています。エージェント（プロファイル）と Ultracode レール、そして Contract Refine を使えるのは Claude だけです。 |
+| **Claude** | `claude` | Anthropic | 最も機能が充実しています。エージェント（プロファイル）と Freestyle レール、そして Contract Refine を使えるのは Claude だけです。 |
 | **Codex** | `codex` | OpenAI | codex `0.128.0+` が必要です。MCP サーバーはグローバルな `~/.codex/config.toml` から読み込みます。 |
 | **Gemini** | `gemini` | Google | gemini `0.11.0+` が必要です。ネイティブのテレメトリと `GEMINI.md` 指示ファイルを使用します。 |
 
@@ -43,7 +43,7 @@ Specrails は特定の AI に縛られません。アプリの中で AI とや
 いくつかの機能はその性質上 Claude 専用なので、ほかのプロバイダーが使われているときは非表示になるかスキップされます。
 
 - **エージェント（プロファイル）** — プロジェクトごとのエージェントカタログとモデルルーティング。Claude 以外のプロバイダーを含むプロジェクトでは非表示になります。
-- **Ultracode レール** — 常に Claude で実行されます。
+- **Freestyle レール** — 常に Claude で実行されます。
 - **Contract Refine** — コミット済みスペックに対する「Contract Layer」の追加パスは、会話のプロバイダーが Claude のときだけ実行されます。
 - **Add Spec の高度なモード**（SMASH / Contract Layer） — Claude 以外のエンジンでは非表示になります。
 

package/docs/guide/ja/integrations/5-mcp-server.md

@@ -31,6 +31,25 @@ Claude Desktop や Cursor のようなクライアントでは、設定は次の
 
 リモートの HTTP MCP サーバーに対応しているクライアントなら、代わりにパネルのトークンを使って `http://127.0.0.1:4200/api/mcp` を直接指すこともできます。
 
+### ターミナルから: Claude Code、Gemini CLI、Codex CLI
+
+**設定 ▸ MCP ▸ トークンをコピー** からトークンをコピーして、次を実行します:
+
+```bash
+# Claude Code
+claude mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <あなたのトークン>"
+
+# Gemini CLI
+gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
+  --header "X-Desktop-Token: <あなたのトークン>"
+
+# Codex CLI (stdio — 設定 ▸ MCP に表示されるブリッジコマンドを登録)
+codex mcp add specrails -- <設定 ▸ MCP のブリッジコマンド>
+```
+
+`Authorization: Bearer <token>` ヘッダーも使えます。アプリのポートを変更している場合は `4200` を置き換えてください。
+
 接続が完了すると、アシスタントにはアプリ全体をカバーする約 **18 個のツール**が見えるようになります — プロジェクト、スペック、レールとジョブ、チャット／Explore、エージェント、プラグイン、Jira、ループ、コードエクスプローラー、アナリティクス、設定など。さらに、最初に読み込む組み込みの**ガイド**ツールも含まれているので、あなたが何も説明しなくても、アシスタントは Specrails の仕組みを理解できます。
 
 ## これで何ができるか
@@ -51,7 +70,7 @@ Claude Desktop や Cursor のようなクライアントでは、設定は次の
 > *「私のプロジェクトを全部チェックして。バックログにスペックがあるのにレールが 1 つも動いていないものを教えて、それぞれで最も優先度の高いものを 1 つ起動して。」*
 
 **コーディング中も手を止めずに。** エディタからでも音声でも、ウィンドウを切り替えずに Specrails を操作できます。
-> *「チケット #42 のためにレール 0 を Opus で ultracode モードで起動して、終わったら教えて。」*
+> *「チケット #42 のためにレール 0 を Opus で Freestyle モードで起動して、終わったら教えて。」*
 
 **コストと履歴について尋ねる。** あなたのアナリティクスを、普通の言葉で。
 > *「今週、AI に一番お金を使ったのはどこ？ プロジェクト別とモデル別で。最もコストのかかったチケットを 5 つ見せて。」*