specrails-desktop 2.17.0 → 2.18.0

package/client/dist/index.html

@@ -191,37 +191,38 @@
         .specrails-splash__mark .pill { opacity: 1; }
       }
     </style>
-    <script type="module" crossorigin src="/assets/index-CDEQ4aU_.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/chunk-CilyBKbf.js">
+    <script type="module" crossorigin src="/assets/index-B7vB20Jw.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/chunk-BNv3lrIs.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-DSXbuxSR.js">
-    <link rel="modulepreload" crossorigin href="/assets/clsx-pVRQNNR0.js">
+    <link rel="modulepreload" crossorigin href="/assets/clsx-1dnHRn8W.js">
     <link rel="modulepreload" crossorigin href="/assets/auth-Cvsb7-Ek.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-Ca2XoBi-.js">
-    <link rel="modulepreload" crossorigin href="/assets/addspec-DE_VfIyP.js">
-    <link rel="modulepreload" crossorigin href="/assets/agents-DzhSlNZd.js">
-    <link rel="modulepreload" crossorigin href="/assets/agentstudio-DCTpIqOx.js">
-    <link rel="modulepreload" crossorigin href="/assets/aiedit-Dirqf3Bm.js">
-    <link rel="modulepreload" crossorigin href="/assets/analytics-BE49LbUk.js">
-    <link rel="modulepreload" crossorigin href="/assets/attachments-C2JPppoP.js">
-    <link rel="modulepreload" crossorigin href="/assets/browser-Dpo_ug4c.js">
-    <link rel="modulepreload" crossorigin href="/assets/chat-mq1x9cxZ.js">
-    <link rel="modulepreload" crossorigin href="/assets/code-DtIatVES.js">
-    <link rel="modulepreload" crossorigin href="/assets/commands-CwypztRT.js">
-    <link rel="modulepreload" crossorigin href="/assets/common-kftoE0Q-.js">
-    <link rel="modulepreload" crossorigin href="/assets/dashboard-BQ3Oa8CE.js">
-    <link rel="modulepreload" crossorigin href="/assets/explore-CBYU76JD.js">
-    <link rel="modulepreload" crossorigin href="/assets/integrations-jJGaKwff.js">
-    <link rel="modulepreload" crossorigin href="/assets/jira-BwACz875.js">
-    <link rel="modulepreload" crossorigin href="/assets/jobs-DRInW0AE.js">
-    <link rel="modulepreload" crossorigin href="/assets/loops-DfGadne0.js">
-    <link rel="modulepreload" crossorigin href="/assets/mcp-D-zQCO5E.js">
-    <link rel="modulepreload" crossorigin href="/assets/nav-CyHKTZxn.js">
-    <link rel="modulepreload" crossorigin href="/assets/settings-Bap_q3rt.js">
-    <link rel="modulepreload" crossorigin href="/assets/setup-BxvjG5Xp.js">
-    <link rel="modulepreload" crossorigin href="/assets/specs-Dslng_yW.js">
-    <link rel="modulepreload" crossorigin href="/assets/terminal-XciDq6VV.js">
-    <link rel="modulepreload" crossorigin href="/assets/tickets-DbcMWq5L.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-BRMyOS1B.css">
+    <link rel="modulepreload" crossorigin href="/assets/activity-D8vQJrpW.js">
+    <link rel="modulepreload" crossorigin href="/assets/addspec-BloGn_ey.js">
+    <link rel="modulepreload" crossorigin href="/assets/agent-Dwkz5mPS.js">
+    <link rel="modulepreload" crossorigin href="/assets/agents-BjT_xLjv.js">
+    <link rel="modulepreload" crossorigin href="/assets/agentstudio-CZm2rOzt.js">
+    <link rel="modulepreload" crossorigin href="/assets/aiedit-DYtnZU9H.js">
+    <link rel="modulepreload" crossorigin href="/assets/analytics-B4FJ_pry.js">
+    <link rel="modulepreload" crossorigin href="/assets/attachments-Ci6_42Kh.js">
+    <link rel="modulepreload" crossorigin href="/assets/browser-ZB1afzjZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/chat-VMflhzxn.js">
+    <link rel="modulepreload" crossorigin href="/assets/code-wtcs0ivb.js">
+    <link rel="modulepreload" crossorigin href="/assets/commands-CckaBWdV.js">
+    <link rel="modulepreload" crossorigin href="/assets/common-BPQQkgJZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/dashboard-Cyzp4ox9.js">
+    <link rel="modulepreload" crossorigin href="/assets/explore-BKVV5JSu.js">
+    <link rel="modulepreload" crossorigin href="/assets/integrations-CuWnMR5L.js">
+    <link rel="modulepreload" crossorigin href="/assets/jira-DXMoAKWD.js">
+    <link rel="modulepreload" crossorigin href="/assets/jobs---dwa4Nf.js">
+    <link rel="modulepreload" crossorigin href="/assets/loops-D8Iu6Jss.js">
+    <link rel="modulepreload" crossorigin href="/assets/mcp-CIH0pH1K.js">
+    <link rel="modulepreload" crossorigin href="/assets/nav-DE3yWQw6.js">
+    <link rel="modulepreload" crossorigin href="/assets/settings-Bghm3pAV.js">
+    <link rel="modulepreload" crossorigin href="/assets/setup-CqGrWb6G.js">
+    <link rel="modulepreload" crossorigin href="/assets/specs-BYeAbIEy.js">
+    <link rel="modulepreload" crossorigin href="/assets/terminal-DFPNRLKp.js">
+    <link rel="modulepreload" crossorigin href="/assets/tickets-CkfbISuK.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-B0FxQALR.css">
   </head>
   <body>
     <div id="specrails-splash" aria-hidden="false" role="status" aria-label="Loading Specrails">

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

@@ -0,0 +1,64 @@
+# Specrails per Chat steuern (Agent Chat)
+
+Der **Agent Chat** ist ein Copilot, der *innerhalb* von Specrails lebt und die gesamte App für dich steuern kann. Statt dich durch Projekte, Specs, Rails und Analytics zu klicken, fragst du einfach: *„Wie viele Jobs waren diese Woche erfolgreich?“*, *„Erstelle eine Spec für Social Login im API-Projekt“*, *„Starte die drei Tickets mit der höchsten Priorität und sag mir Bescheid, wenn sie fertig sind“*. Er erledigt die Arbeit, indem er Specrails' eigene Werkzeuge aufruft — dieselben, die der [MCP-Server](./5-mcp-server.md) bereitstellt — während du das Dashboard dahinter live aktualisieren siehst.
+
+> **Nicht mit den Pipeline-Agenten zu verwechseln.** Der Abschnitt *Agenten* (Architect → Developer → Reviewer) geht darum, *wie ein Rail eine Spec umsetzt*. Der **Agent Chat** ist ein einzelner Assistent, der *die App selbst bedient*. Zwei verschiedene Dinge, dasselbe Wort.
+
+## So öffnest du ihn
+
+Am unteren Rand des Fensters schwebt eine **Blase** — klicke sie an, um das Panel zu öffnen, oder drücke von überall aus **⌘⇧A** (**Ctrl+Shift+A** unter Windows/Linux). Das Panel ist ein echtes Fenster, das du verschieben, in der Größe ändern, maximieren und wieder in die Blase ablegen kannst; es merkt sich, wo du es zuletzt hattest.
+
+Es ist **bewusst nicht-modal**: Das Dashboard dahinter bleibt lebendig, sodass du in Echtzeit siehst, wenn der Agent ein Rail startet oder eine Spec erstellt — du blickst nicht auf einen eingefrorenen Bildschirm.
+
+## Voraussetzung: der MCP-Server
+
+Der Agent Chat steuert die App über den eingebetteten **Specrails-MCP-Server**, der also aktiv sein muss. Ist er es nicht, öffnet sich das Panel mit einem Ein-Klick-Banner **Specrails MCP aktivieren** — drück drauf und du bist startklar (ohne Neustart). Details findest du unter [Specrails von jeder KI aus steuern](./5-mcp-server.md); es wird nichts installiert, alles läuft lokal auf deinem Rechner.
+
+## Auswählen, woran er arbeitet
+
+Die Kopfzeile hat einen **Projekt-Selektor** (wie bei Cursor). Wähle ein Projekt aus, und alles, was du fragst, bezieht sich darauf — *„Starte die mit hoher Priorität“* wird gegen dieses Projekt aufgelöst. Belässt du ihn auf **Start**, arbeitet der Agent über dein gesamtes Setup hinweg: Er kann Projekte auflisten oder anlegen und Fragen beantworten, die alles umfassen. Fragst du auf Start etwas Projektspezifisches, fragt er dich nach dem Projekt (oder bietet an, eins anzulegen), statt zu raten.
+
+Ein Projekt hier auszuwählen **verschiebt** dein Dashboard **nicht** — das Ziel des Agenten und das, was du gerade ansiehst, sind unabhängig voneinander.
+
+## Anbieter und Modell
+
+Direkt über dem Nachrichtenfeld wählst du den **Anbieter** (Claude, Codex oder Gemini) und dessen **Modell**. Jeder Anbieter hat seine eigene Modellliste, und ein Anbieterwechsel startet eine frische Sitzung mit dem Standardmodell dieses Anbieters — so kannst du etwa die App mit Claude steuern und für eine andere Unterhaltung zu Codex wechseln, ohne dass etwas durcheinandergerät.
+
+## Berechtigungsstufen — du hältst die Leine
+
+Der Agent kann die ganze App anfassen, also entscheidest du, wie viel Freiheit er hat — über eine **Stufe**, die du live mit **Shift+Tab** änderst (derselbe Zyklus wie in Claude Code). Jede Stufe schließt alles darunter mit ein:
+
+| Stufe | Was er tun kann |
+|---|---|
+| 👀 **Beobachten** | Nur lesen — Projekte, Specs, Jobs, Analytics auflisten und einsehen. Nichts ändert sich. |
+| ✍️ **Bearbeiten** | Das Obige **+** erstellen und bearbeiten (Specs, Einstellungen, Rail-Konfiguration) — umkehrbare Änderungen. |
+| ⚡ **Ausführen** | Das Obige **+** KI-Arbeit starten, die **Geld kostet** (Rails, Spec-Generierung). |
+| 🔥 **Autonom** | Das Obige **+** Dinge löschen und stoppen — unumkehrbare Aktionen. |
+
+Beginne bei **Beobachten** und erhöhe die Stufe erst, wenn der Agent handeln soll. Versucht er etwas oberhalb der aktuellen Stufe, hält er an und sagt dir genau, welche Stufe du einschalten musst — er umgeht die Grenze nie. Das ist getrennt von den Einstellungen ▸ MCP-Stufen, die *externe* Assistenten regeln; die Stufe hier gilt nur für diesen app-internen Agenten.
+
+## Ein paar Dinge, die du fragen kannst
+
+Sobald du auf **Ausführen** bist, probier:
+
+> *„Liste jede To-do-Spec im API-Projekt auf, starte dann die drei mit der höchsten Priorität auf separaten Rails und behalte sie im Auge.“*
+>
+> *„Wie viel habe ich diese Woche ausgegeben, aufgeschlüsselt nach Projekt?“*
+>
+> *„Erstelle eine Spec für einen Dark-Mode-Umschalter im Web-Projekt, mit Contract Layer.“*
+>
+> *„Im letzten Batch ist etwas schiefgegangen — finde die fehlgeschlagenen Jobs und fasse zusammen, warum.“*
+
+Antworten strömen flüssig herein und landen bereits formatiert (Überschriften, Tabellen, Listen), jede mit einem kleinen **Kopieren**-Button. Ein Status-Chip unten zeigt, was der Agent gerade tut — *Denkt nach…*, *MCP · jobs*, *Terminal* — sodass du seinen Zustand immer kennst.
+
+## Praktische Feinheiten
+
+- **Prompt-Verlauf.** Ist das Feld leer, drücke **↑**/**↓**, um durch deine früheren Fragen zu blättern (beim Scrollen abgedunkelt dargestellt); tippe los, um sie zu bearbeiten, oder drücke Enter zum Senden.
+- **Minimieren, nicht verlieren.** Klicke auf das ✕, um das Panel zurück in die Blase abzulegen — die Unterhaltung läuft weiter. Öffne es wieder und du landest bei der neuesten Nachricht; nichts muss neu getippt werden.
+- **Neue Unterhaltung.** Der **+**-Button startet einen sauberen Thread; der Verlauf lebt app-weit, oberhalb jedes einzelnen Projekts.
+
+## Ein paar Dinge, die du wissen solltest
+
+- **Ausführen und Autonom kosten Geld**, weil sie KI laufen lassen. Der Agent hebt kostenverursachende Aktionen hervor, bevor er sie ausführt; belasse die Stufe bei Beobachten oder Bearbeiten, wenn du nur schauen und aufräumen willst.
+- **Der Agent gilt app-weit**, nicht an das gerade geöffnete Projekt gebunden — deshalb hat er seinen eigenen Selektor, und sein Verlauf ist nicht pro Projekt.
+- **Er ist nur so fähig, wie es der MCP zulässt.** Wenn ein ganzer Bereich gesperrt scheint, prüfe, ob der MCP-Server aktiviert ist.

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

@@ -0,0 +1,64 @@
+# Operate Specrails by chatting (Agent Chat)
+
+The **Agent Chat** is a copilot that lives *inside* Specrails and can drive the whole app for you. Instead of clicking through projects, specs, rails and analytics, you just ask: *"how many jobs succeeded this week?"*, *"create a spec for social login in the API project"*, *"launch the three highest-priority tickets and tell me when they finish"*. It carries out the work by calling Specrails' own tools — the same ones the [MCP server](./5-mcp-server.md) exposes — while you watch the dashboard update live behind it.
+
+> **Not to be confused with the pipeline agents.** The *Agents* section (Architect → Developer → Reviewer) is about *how a rail implements a spec*. The **Agent Chat** is a single assistant that *operates the app itself*. Different thing, same word.
+
+## Opening it
+
+There's a floating **bubble** at the bottom of the window — click it to open the panel, or press **⌘⇧A** (**Ctrl+Shift+A** on Windows/Linux) from anywhere. The panel is a real window you can move, resize, maximize, and drop back to the bubble; it remembers where you left it.
+
+It's **non-modal on purpose**: the dashboard behind it stays live, so when the agent launches a rail or creates a spec you see it appear in real time — you're not looking at a frozen screen.
+
+## Prerequisite: the MCP server
+
+The Agent Chat drives the app through the embedded **Specrails MCP server**, so that has to be on. If it isn't, the panel opens with a one-click **Enable Specrails MCP** banner — press it and you're ready (no restart). See [Control Specrails from any AI](./5-mcp-server.md) for the details; nothing is installed, it's all local to your machine.
+
+## Choosing what it works on
+
+The header has a **project selector** (like Cursor's). Pick a project and everything you ask is scoped to it — *"launch the high-priority ones"* resolves against that project. Leave it on **Home** and the agent works across your whole setup: it can list or create projects and answer questions that span everything. If you ask something project-specific while on Home, it will ask you which project (or offer to create one) rather than guess.
+
+Picking a project here **does not** move your dashboard — the agent's target and what you're looking at are independent.
+
+## Provider and model
+
+Just above the message box you choose the **provider** (Claude, Codex or Gemini) and its **model**. Each provider has its own model list, and switching provider starts a fresh session with that provider's default model — so you can, say, drive the app with Claude and switch to Codex for another conversation without anything getting crossed.
+
+## Permission levels — you hold the leash
+
+The agent can touch the whole app, so you decide how much freedom it has with a **level** you change live by pressing **Shift+Tab** (the same cycle Claude Code uses). Each level includes everything below it:
+
+| Level | What it can do |
+|---|---|
+| 👀 **Observe** | Read only — list and inspect projects, specs, jobs, analytics. Nothing changes. |
+| ✍️ **Edit** | The above **+** create and edit (specs, settings, rail config) — reversible changes. |
+| ⚡ **Operate** | The above **+** launch AI work that **costs money** (rails, spec generation). |
+| 🔥 **Autonomous** | The above **+** delete and stop things — irreversible actions. |
+
+Start on **Observe** and raise the level only when you want the agent to act. If it tries something above the current level it stops and tells you exactly which level to switch on — it never works around the limit. This is separate from the Settings ▸ MCP tiers, which govern *external* assistants; the level here is just for this in-app agent.
+
+## A few things you can ask
+
+Once you're on **Operate**, try:
+
+> *"List every todo spec in the API project, then launch the three highest-priority ones on separate rails and watch them."*
+>
+> *"How much did I spend this week, broken down by project?"*
+>
+> *"Create a spec for a dark-mode toggle in the web project, with a Contract Layer."*
+>
+> *"Something failed in the last batch — find the failed jobs and summarize why."*
+
+Replies stream in smoothly and land formatted (headings, tables, lists), each with a small **copy** button. A status chip at the bottom shows what the agent is doing right now — *Thinking…*, *MCP · jobs*, *Terminal* — so you always know its state.
+
+## Handy touches
+
+- **Prompt history.** With the box empty, press **↑**/**↓** to browse what you asked before (shown dimmed while you scroll); start typing to edit it, or hit Enter to send.
+- **Minimize, don't lose.** Click the ✕ to drop the panel back to the bubble — the conversation keeps running. Reopen and you land at the latest message; nothing is re-typed.
+- **New conversation.** The **+** button starts a clean thread; the history lives app-wide, above any single project.
+
+## A few things to know
+
+- **Operate and Autonomous cost money** because they run AI. The agent surfaces cost-incurring actions before doing them; keep the level at Observe or Edit if you just want to look and tidy.
+- **The agent is app-wide**, not tied to the project you have open — that's why it has its own selector and its history isn't per-project.
+- **It's only as capable as the MCP allows.** If a whole area seems off-limits, check that the MCP server is enabled.

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

@@ -0,0 +1,64 @@
+# Maneja Specrails conversando (Agent Chat)
+
+El **Agent Chat** es un copiloto que vive *dentro* de Specrails y puede manejar toda la app por ti. En lugar de ir haciendo clic por proyectos, specs, raíles y analítica, basta con que preguntes: *«¿cuántos trabajos salieron bien esta semana?»*, *«crea una spec para el inicio de sesión social en el proyecto de la API»*, *«lanza los tres tickets de mayor prioridad y avísame cuando terminen»*. Lleva a cabo el trabajo llamando a las propias herramientas de Specrails —las mismas que expone el [servidor MCP](./5-mcp-server.md)— mientras ves el panel actualizarse en directo detrás de él.
+
+> **No lo confundas con los agentes del pipeline.** La sección *Agentes* (Architect → Developer → Reviewer) trata de *cómo un raíl implementa una spec*. El **Agent Chat** es un único asistente que *maneja la propia app*. Cosas distintas, misma palabra.
+
+## Cómo abrirlo
+
+Hay una **burbuja** flotante en la parte inferior de la ventana: haz clic en ella para abrir el panel, o pulsa **⌘⇧A** (**Ctrl+Shift+A** en Windows/Linux) desde cualquier sitio. El panel es una ventana de verdad que puedes mover, redimensionar, maximizar y devolver a la burbuja; recuerda dónde lo dejaste.
+
+Es **no modal a propósito**: el panel de detrás sigue vivo, así que cuando el agente lanza un raíl o crea una spec lo ves aparecer en tiempo real; no estás mirando una pantalla congelada.
+
+## Requisito previo: el servidor MCP
+
+El Agent Chat maneja la app a través del **servidor MCP de Specrails** integrado, así que tiene que estar activo. Si no lo está, el panel se abre con un banner de **Activar Specrails MCP** de un solo clic: púlsalo y ya está listo (sin reiniciar). Consulta [Controla Specrails desde cualquier IA](./5-mcp-server.md) para los detalles; no se instala nada, todo es local en tu máquina.
+
+## Elegir sobre qué trabaja
+
+La cabecera tiene un **selector de proyecto** (como el de Cursor). Elige un proyecto y todo lo que pidas queda acotado a él: *«lanza los de alta prioridad»* se resuelve contra ese proyecto. Déjalo en **Inicio** y el agente trabaja sobre todo tu conjunto: puede listar o crear proyectos y responder preguntas que abarquen todo. Si pides algo específico de un proyecto estando en Inicio, te preguntará cuál (o se ofrecerá a crear uno) en lugar de adivinar.
+
+Elegir un proyecto aquí **no** mueve tu panel: el objetivo del agente y lo que estás mirando son independientes.
+
+## 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.
+
+## Niveles de permiso: tú llevas las riendas
+
+El agente puede tocar toda la app, así que tú decides cuánta libertad tiene con un **nivel** que cambias en vivo pulsando **Shift+Tab** (el mismo ciclo que usa Claude Code). Cada nivel incluye todo lo que hay por debajo:
+
+| Nivel | Qué puede hacer |
+|---|---|
+| 👀 **Observa** | Solo lectura: listar e inspeccionar proyectos, specs, trabajos, analítica. No cambia nada. |
+| ✍️ **Edita** | Lo anterior **+** crear y editar (specs, ajustes, configuración de raíles): cambios reversibles. |
+| ⚡ **Opera** | Lo anterior **+** lanzar trabajo de IA que **cuesta dinero** (raíles, generación de specs). |
+| 🔥 **Autónomo** | Lo anterior **+** borrar y detener cosas: acciones irreversibles. |
+
+Empieza en **Observa** y sube el nivel solo cuando quieras que el agente actúe. Si intenta algo por encima del nivel actual, se detiene y te dice exactamente qué nivel activar; nunca sortea el límite. Esto es independiente de los niveles de Ajustes ▸ MCP, que rigen a los asistentes *externos*; el nivel de aquí es solo para este agente interno de la app.
+
+## Algunas cosas que puedes pedir
+
+Cuando estés en **Opera**, prueba con:
+
+> *«Lista todas las specs pendientes del proyecto de la API y luego lanza las tres de mayor prioridad en raíles separados y vigílalas.»*
+>
+> *«¿Cuánto he gastado esta semana, desglosado por proyecto?»*
+>
+> *«Crea una spec para un interruptor de modo oscuro en el proyecto web, con Contract Layer.»*
+>
+> *«Algo ha fallado en el último lote: encuentra los trabajos fallidos y resume por qué.»*
+
+Las respuestas llegan fluidas y ya formateadas (encabezados, tablas, listas), cada una con un pequeño botón de **copiar**. Una etiqueta de estado abajo muestra lo que el agente está haciendo ahora mismo —*Pensando…*, *MCP · jobs*, *Terminal*— para que siempre sepas en qué estado está.
+
+## Detalles prácticos
+
+- **Historial de prompts.** Con el cuadro vacío, pulsa **↑**/**↓** para recorrer lo que preguntaste antes (se muestra atenuado mientras te desplazas); empieza a escribir para editarlo, o pulsa Intro para enviarlo.
+- **Minimiza sin perder nada.** Haz clic en la ✕ para devolver el panel a la burbuja: la conversación sigue en marcha. Vuelve a abrirlo y aterrizas en el último mensaje; no hay que reescribir nada.
+- **Nueva conversación.** El botón **+** inicia un hilo limpio; el historial vive a nivel de app, por encima de cualquier proyecto concreto.
+
+## Algunas cosas que conviene saber
+
+- **Opera y Autónomo cuestan dinero** porque ejecutan IA. El agente saca a la luz las acciones que generan coste antes de hacerlas; mantén el nivel en Observa o Edita si solo quieres mirar y ordenar.
+- **El agente es de toda la app**, no está ligado al proyecto que tengas abierto; por eso tiene su propio selector y su historial no es por proyecto.
+- **Es tan capaz como le permita el MCP.** Si toda un área parece vetada, comprueba que el servidor MCP esté activado.

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

@@ -0,0 +1,64 @@
+# Pilotez Specrails en discutant (Agent Chat)
+
+L'**Agent Chat** est un copilote qui vit *à l'intérieur* de Specrails et peut piloter toute l'application à votre place. Au lieu de cliquer à travers projets, specs, rails et analyses, il vous suffit de demander : *« combien de jobs ont réussi cette semaine ? »*, *« crée une spec pour la connexion sociale dans le projet API »*, *« lance les trois tickets les plus prioritaires et préviens-moi quand ils sont finis »*. Il exécute le travail en appelant les propres outils de Specrails — les mêmes que ceux exposés par le [serveur MCP](./5-mcp-server.md) — pendant que vous voyez le tableau de bord se mettre à jour en direct derrière lui.
+
+> **À ne pas confondre avec les agents du pipeline.** La section *Agents* (Architect → Developer → Reviewer) concerne *la manière dont un rail implémente une spec*. L'**Agent Chat** est un unique assistant qui *pilote l'application elle-même*. Deux choses différentes, un même mot.
+
+## Comment l'ouvrir
+
+Une **bulle** flottante se trouve en bas de la fenêtre : cliquez dessus pour ouvrir le panneau, ou appuyez sur **⌘⇧A** (**Ctrl+Shift+A** sous Windows/Linux) depuis n'importe où. Le panneau est une vraie fenêtre que vous pouvez déplacer, redimensionner, agrandir et renvoyer dans la bulle ; il se souvient de l'endroit où vous l'avez laissé.
+
+Il est **non modal, volontairement** : le tableau de bord derrière lui reste vivant, donc quand l'agent lance un rail ou crée une spec vous le voyez apparaître en temps réel — vous ne regardez pas un écran figé.
+
+## Prérequis : le serveur MCP
+
+L'Agent Chat pilote l'application via le **serveur MCP Specrails** intégré, il faut donc que celui-ci soit actif. S'il ne l'est pas, le panneau s'ouvre avec une bannière **Activer Specrails MCP** en un clic : appuyez dessus et c'est prêt (sans redémarrage). Voir [Contrôlez Specrails depuis n'importe quelle IA](./5-mcp-server.md) pour les détails ; rien n'est installé, tout est local sur votre machine.
+
+## Choisir ce sur quoi il travaille
+
+L'en-tête comporte un **sélecteur de projet** (comme celui de Cursor). Choisissez un projet et tout ce que vous demandez s'y rapporte : *« lance ceux qui sont hautement prioritaires »* se résout pour ce projet. Laissez-le sur **Accueil** et l'agent travaille sur l'ensemble de votre configuration : il peut lister ou créer des projets et répondre à des questions qui embrassent tout. Si vous demandez quelque chose de spécifique à un projet en étant sur Accueil, il vous demandera lequel (ou proposera d'en créer un) plutôt que de deviner.
+
+Choisir un projet ici **ne déplace pas** votre tableau de bord : la cible de l'agent et ce que vous regardez sont indépendants.
+
+## 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.
+
+## Niveaux d'autorisation — c'est vous qui tenez la laisse
+
+L'agent peut toucher à toute l'application, c'est donc à vous de décider quelle liberté vous lui accordez, via un **niveau** que vous changez en direct en appuyant sur **Shift+Tab** (le même cycle que celui de Claude Code). Chaque niveau inclut tout ce qui se trouve en dessous :
+
+| Niveau | Ce qu'il peut faire |
+|---|---|
+| 👀 **Observer** | Lecture seule — lister et inspecter projets, specs, jobs, analyses. Rien ne change. |
+| ✍️ **Modifier** | Ce qui précède **+** créer et modifier (specs, réglages, configuration de rails) — changements réversibles. |
+| ⚡ **Opérer** | Ce qui précède **+** lancer du travail d'IA qui **coûte de l'argent** (rails, génération de specs). |
+| 🔥 **Autonome** | Ce qui précède **+** supprimer et arrêter des choses — actions irréversibles. |
+
+Commencez sur **Observer** et n'élevez le niveau que lorsque vous voulez que l'agent agisse. S'il tente quelque chose au-dessus du niveau actuel, il s'arrête et vous indique exactement quel niveau activer — il ne contourne jamais la limite. C'est distinct des niveaux de Réglages ▸ MCP, qui régissent les assistants *externes* ; le niveau ici ne concerne que cet agent intégré à l'application.
+
+## Quelques exemples de demandes
+
+Une fois sur **Opérer**, essayez :
+
+> *« Liste toutes les specs à faire du projet API, puis lance les trois plus prioritaires sur des rails séparés et surveille-les. »*
+>
+> *« Combien ai-je dépensé cette semaine, ventilé par projet ? »*
+>
+> *« Crée une spec pour un bouton de bascule mode sombre dans le projet web, avec une Contract Layer. »*
+>
+> *« Quelque chose a échoué dans le dernier lot — trouve les jobs en échec et résume pourquoi. »*
+
+Les réponses arrivent en flux fluide et s'affichent déjà mises en forme (titres, tableaux, listes), chacune avec un petit bouton **copier**. Une étiquette d'état en bas montre ce que fait l'agent en ce moment — *Réflexion…*, *MCP · jobs*, *Terminal* — pour que vous connaissiez toujours son état.
+
+## Petits plus pratiques
+
+- **Historique des prompts.** Avec la zone vide, appuyez sur **↑**/**↓** pour parcourir ce que vous avez demandé auparavant (affiché en grisé pendant que vous défilez) ; commencez à taper pour le modifier, ou appuyez sur Entrée pour l'envoyer.
+- **Réduire sans rien perdre.** Cliquez sur la ✕ pour renvoyer le panneau dans la bulle — la conversation continue de tourner. Rouvrez-le et vous atterrissez sur le dernier message ; rien n'est à retaper.
+- **Nouvelle conversation.** Le bouton **+** démarre un fil vierge ; l'historique vit au niveau de l'application, au-dessus de tout projet individuel.
+
+## Quelques points à savoir
+
+- **Opérer et Autonome coûtent de l'argent** car ils exécutent de l'IA. L'agent met en avant les actions génératrices de coût avant de les réaliser ; gardez le niveau sur Observer ou Modifier si vous voulez juste regarder et ranger.
+- **L'agent couvre toute l'application**, il n'est pas lié au projet que vous avez ouvert — c'est pourquoi il a son propre sélecteur et que son historique n'est pas par projet.
+- **Il n'est capable que dans la mesure où le MCP le permet.** Si tout un domaine semble interdit, vérifiez que le serveur MCP est bien activé.

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

@@ -0,0 +1,64 @@
+# Gestisci Specrails conversando (Agent Chat)
+
+L'**Agent Chat** è un copilota che vive *dentro* Specrails e può pilotare l'intera app al posto tuo. Invece di navigare a clic tra progetti, spec, binari e analisi, basta che chiedi: *«quanti job sono andati a buon fine questa settimana?»*, *«crea una spec per il login social nel progetto API»*, *«lancia i tre ticket a priorità più alta e avvisami quando finiscono»*. Porta a termine il lavoro chiamando gli strumenti stessi di Specrails — gli stessi che espone il [server MCP](./5-mcp-server.md) — mentre vedi la dashboard aggiornarsi dal vivo dietro di lui.
+
+> **Da non confondere con gli agenti della pipeline.** La sezione *Agenti* (Architect → Developer → Reviewer) riguarda *come un binario implementa una spec*. L'**Agent Chat** è un unico assistente che *gestisce l'app stessa*. Cose diverse, stessa parola.
+
+## Come aprirlo
+
+C'è una **bolla** fluttuante in fondo alla finestra: cliccala per aprire il pannello, oppure premi **⌘⇧A** (**Ctrl+Shift+A** su Windows/Linux) da qualsiasi punto. Il pannello è una finestra vera che puoi spostare, ridimensionare, massimizzare e rimettere nella bolla; ricorda dove l'hai lasciato.
+
+È **non modale di proposito**: la dashboard dietro resta viva, così quando l'agente lancia un binario o crea una spec la vedi comparire in tempo reale — non stai guardando uno schermo congelato.
+
+## Prerequisito: il server MCP
+
+L'Agent Chat gestisce l'app tramite il **server MCP di Specrails** integrato, quindi deve essere attivo. Se non lo è, il pannello si apre con un banner **Attiva Specrails MCP** con un clic: premilo e sei pronto (senza riavvio). Vedi [Controlla Specrails da qualsiasi IA](./5-mcp-server.md) per i dettagli; non viene installato nulla, è tutto locale sulla tua macchina.
+
+## Scegliere su cosa lavora
+
+L'intestazione ha un **selettore di progetto** (come quello di Cursor). Scegli un progetto e tutto ciò che chiedi è circoscritto a esso — *«lancia quelli ad alta priorità»* si risolve su quel progetto. Lascialo su **Home** e l'agente lavora sull'intera configurazione: può elencare o creare progetti e rispondere a domande che abbracciano tutto. Se chiedi qualcosa di specifico di un progetto stando su Home, ti chiederà quale (o si offrirà di crearne uno) invece di indovinare.
+
+Scegliere un progetto qui **non** sposta la tua dashboard: l'obiettivo dell'agente e ciò che stai guardando sono indipendenti.
+
+## Provider e modello
+
+Proprio sopra la casella del messaggio scegli il **provider** (Claude, Codex o Gemini) e il suo **modello**. Ogni provider ha la propria lista di modelli, e cambiare provider avvia una sessione nuova con il modello predefinito di quel provider — così puoi, ad esempio, pilotare l'app con Claude e passare a Codex per un'altra conversazione senza che nulla si incroci.
+
+## Livelli di permesso — le redini le tieni tu
+
+L'agente può toccare tutta l'app, quindi decidi tu quanta libertà ha tramite un **livello** che cambi dal vivo premendo **Shift+Tab** (lo stesso ciclo usato da Claude Code). Ogni livello include tutto ciò che sta sotto:
+
+| Livello | Cosa può fare |
+|---|---|
+| 👀 **Osserva** | Sola lettura — elencare e ispezionare progetti, spec, job, analisi. Nulla cambia. |
+| ✍️ **Modifica** | Quanto sopra **+** creare e modificare (spec, impostazioni, configurazione dei binari) — modifiche reversibili. |
+| ⚡ **Opera** | Quanto sopra **+** avviare lavoro di IA che **costa denaro** (binari, generazione di spec). |
+| 🔥 **Autonomo** | Quanto sopra **+** eliminare e fermare cose — azioni irreversibili. |
+
+Inizia da **Osserva** e alza il livello solo quando vuoi che l'agente agisca. Se prova qualcosa oltre il livello attuale, si ferma e ti dice esattamente quale livello attivare — non aggira mai il limite. Questo è distinto dai livelli di Impostazioni ▸ MCP, che regolano gli assistenti *esterni*; il livello qui riguarda solo questo agente interno all'app.
+
+## Alcune cose che puoi chiedere
+
+Una volta su **Opera**, prova:
+
+> *«Elenca ogni spec da fare nel progetto API, poi lancia le tre a priorità più alta su binari separati e tienile d'occhio.»*
+>
+> *«Quanto ho speso questa settimana, suddiviso per progetto?»*
+>
+> *«Crea una spec per un interruttore modalità scura nel progetto web, con Contract Layer.»*
+>
+> *«Qualcosa è fallito nell'ultimo lotto — trova i job falliti e riassumi il perché.»*
+
+Le risposte arrivano fluide e già formattate (titoli, tabelle, elenchi), ciascuna con un piccolo pulsante **copia**. Un'etichetta di stato in basso mostra cosa sta facendo l'agente in questo momento — *Sto pensando…*, *MCP · jobs*, *Terminal* — così conosci sempre il suo stato.
+
+## Dettagli pratici
+
+- **Cronologia dei prompt.** Con la casella vuota, premi **↑**/**↓** per scorrere ciò che hai chiesto prima (mostrato attenuato mentre scorri); inizia a scrivere per modificarlo, oppure premi Invio per inviarlo.
+- **Riduci a icona, senza perdere nulla.** Clicca la ✕ per rimettere il pannello nella bolla — la conversazione continua a girare. Riaprilo e atterri sull'ultimo messaggio; nulla viene riscritto.
+- **Nuova conversazione.** Il pulsante **+** avvia un thread pulito; la cronologia vive a livello di app, sopra qualunque singolo progetto.
+
+## Alcune cose da sapere
+
+- **Opera e Autonomo costano denaro** perché eseguono IA. L'agente mette in evidenza le azioni che generano costi prima di eseguirle; tieni il livello su Osserva o Modifica se vuoi solo guardare e mettere in ordine.
+- **L'agente vale per tutta l'app**, non è legato al progetto che hai aperto — ecco perché ha un proprio selettore e la sua cronologia non è per progetto.
+- **È capace solo quanto glielo consente l'MCP.** Se un'intera area sembra off-limits, verifica che il server MCP sia attivato.

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

@@ -0,0 +1,64 @@
+# チャットで Specrails を操作する（Agent Chat）
+
+**Agent Chat** は Specrails の*内部*に住むコパイロットで、アプリ全体をあなたの代わりに動かせます。プロジェクト、スペック、レール、分析画面をクリックで渡り歩く代わりに、ただ頼むだけです。*「今週は成功したジョブがいくつ？」*、*「API プロジェクトにソーシャルログインのスペックを作って」*、*「優先度が最も高い 3 件のチケットを起動して、終わったら教えて」*。それは Specrails 自身のツール——[MCP サーバー](./5-mcp-server.md)が公開しているのと同じもの——を呼び出して作業を進め、その裏でダッシュボードがライブに更新されていく様子をあなたは見ていられます。
+
+> **パイプラインのエージェントと混同しないでください。** *エージェント*セクション（Architect → Developer → Reviewer）は*レールがどのようにスペックを実装するか*の話です。**Agent Chat** は*アプリそのものを操作する*単一のアシスタントです。別物ですが、同じ言葉です。
+
+## 開き方
+
+ウィンドウ下部に浮かぶ**バブル**があります——クリックするとパネルが開きます。あるいはどこからでも **⌘⇧A**（Windows/Linux では **Ctrl+Shift+A**）を押してください。パネルは移動・リサイズ・最大化ができ、バブルへ戻せる本物のウィンドウで、最後に置いた場所を覚えています。
+
+これは**意図的に非モーダル**です。背後のダッシュボードは生きたままなので、エージェントがレールを起動したりスペックを作成したりすると、それがリアルタイムで現れるのが見えます——固まった画面を眺めているわけではありません。
+
+## 前提条件：MCP サーバー
+
+Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプリを操作するため、それがオンになっている必要があります。オンでない場合、パネルはワンクリックの **Specrails MCP を有効化** バナー付きで開きます——押せば準備完了です（再起動不要）。詳細は[任意の AI から Specrails を操作する](./5-mcp-server.md)を参照してください。何もインストールされず、すべてはあなたのマシン内でローカルに動きます。
+
+## 何に対して作業するかを選ぶ
+
+ヘッダーには**プロジェクトセレクター**（Cursor のようなもの）があります。プロジェクトを選ぶと、頼んだことはすべてそれに限定されます——*「優先度の高いものを起動して」*はそのプロジェクトに対して解決されます。**ホーム**のままにしておくと、エージェントはあなたの環境全体にまたがって作業します。プロジェクトを一覧表示したり作成したりでき、全体に及ぶ質問にも答えられます。ホームにいながらプロジェクト固有のことを頼むと、推測ではなくどのプロジェクトかを尋ねてきます（あるいは新規作成を提案します）。
+
+ここでプロジェクトを選んでも、あなたのダッシュボードは**動きません**——エージェントの対象と、あなたが見ているものは互いに独立しています。
+
+## プロバイダーとモデル
+
+メッセージ欄のすぐ上で、**プロバイダー**（Claude、Codex、Gemini）とその**モデル**を選びます。各プロバイダーには独自のモデル一覧があり、プロバイダーを切り替えるとそのプロバイダーの既定モデルで新しいセッションが始まります——ですから、たとえば Claude でアプリを操作しつつ、別の会話では Codex に切り替える、といったことが何も混ざらずにできます。
+
+## 権限レベル——手綱はあなたが握る
+
+エージェントはアプリ全体に触れられるので、どこまで自由を与えるかはあなたが決めます。**Shift+Tab** を押してその場で切り替える**レベル**でコントロールします（Claude Code が使うのと同じ循環です）。各レベルはその下のすべてを含みます。
+
+| レベル | できること |
+|---|---|
+| 👀 **観察** | 読み取り専用——プロジェクト、スペック、ジョブ、分析の一覧表示と確認。何も変わりません。 |
+| ✍️ **編集** | 上記 **+** 作成と編集（スペック、設定、レール構成）——元に戻せる変更。 |
+| ⚡ **操作** | 上記 **+** **料金が発生する** AI 作業の起動（レール、スペック生成）。 |
+| 🔥 **自律** | 上記 **+** 削除や停止——取り消せない操作。 |
+
+**観察**から始め、エージェントに動いてほしいときだけレベルを上げてください。現在のレベルを超えることを試みると、エージェントは止まり、どのレベルに切り替えればよいかを正確に伝えます——制限を回避することは決してありません。これは*外部*アシスタントを統制する 設定 ▸ MCP のティアとは別物で、ここのレベルはこのアプリ内エージェント専用です。
+
+## 頼めることの例
+
+**操作**にしたら、試してみてください。
+
+> *「API プロジェクトの todo スペックをすべて一覧表示して、それから優先度が最も高い 3 件を別々のレールで起動して見守って。」*
+>
+> *「今週いくら使った？プロジェクトごとに内訳を出して。」*
+>
+> *「web プロジェクトにダークモード切り替えのスペックを、Contract Layer 付きで作って。」*
+>
+> *「直近のバッチで何かが失敗した——失敗したジョブを見つけて、原因をまとめて。」*
+
+返信は滑らかにストリーミングされ、整形済みで届き（見出し、表、リスト）、それぞれに小さな**コピー**ボタンが付きます。下部のステータスチップが、エージェントが今まさに何をしているか——*考え中…*、*MCP · jobs*、*Terminal*——を示すので、その状態が常に分かります。
+
+## 気の利いた工夫
+
+- **プロンプト履歴。** 入力欄が空のとき、**↑**/**↓** を押すと以前に頼んだ内容をたどれます（スクロール中は薄く表示されます）。入力を始めれば編集でき、Enter で送信できます。
+- **最小化しても失わない。** ✕ をクリックするとパネルはバブルへ戻ります——会話はそのまま動き続けます。開き直すと最新のメッセージに着地します。何も打ち直す必要はありません。
+- **新しい会話。** **+** ボタンでまっさらなスレッドを始めます。履歴はアプリ全体にわたって存在し、個々のプロジェクトの上位にあります。
+
+## 知っておくとよいこと
+
+- **操作と自律は料金が発生します**。AI を実行するからです。エージェントは料金の発生する操作を実行する前に前面に示します。眺めて整理したいだけなら、レベルは観察か編集にしておいてください。
+- **エージェントはアプリ全体のもの**であり、開いているプロジェクトに縛られません——だからこそ独自のセレクターを持ち、その履歴はプロジェクト単位ではないのです。
+- **その能力は MCP が許す範囲までです。** ある領域が丸ごと使えないように見える場合は、MCP サーバーが有効になっているか確認してください。

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

@@ -0,0 +1,64 @@
+# Comande o Specrails conversando (Agent Chat)
+
+O **Agent Chat** é um copiloto que vive *dentro* do Specrails e pode conduzir a aplicação inteira por você. Em vez de ficar clicando por projetos, specs, trilhos e análises, basta pedir: *«quantos jobs deram certo esta semana?»*, *«cria uma spec para o login social no projeto da API»*, *«lança os três tickets de maior prioridade e me avisa quando terminarem»*. Ele realiza o trabalho chamando as próprias ferramentas do Specrails — as mesmas que o [servidor MCP](./5-mcp-server.md) expõe — enquanto você vê o painel se atualizar ao vivo por trás dele.
+
+> **Não confunda com os agentes do pipeline.** A seção *Agentes* (Architect → Developer → Reviewer) trata de *como um trilho implementa uma spec*. O **Agent Chat** é um único assistente que *opera a própria aplicação*. Coisas diferentes, mesma palavra.
+
+## Como abrir
+
+Há uma **bolha** flutuante na parte inferior da janela — clique nela para abrir o painel, ou pressione **⌘⇧A** (**Ctrl+Shift+A** no Windows/Linux) de qualquer lugar. O painel é uma janela de verdade que você pode mover, redimensionar, maximizar e devolver à bolha; ele lembra onde você o deixou.
+
+Ele é **não modal de propósito**: o painel por trás continua vivo, então quando o agente lança um trilho ou cria uma spec você o vê aparecer em tempo real — não está olhando para uma tela congelada.
+
+## Pré-requisito: o servidor MCP
+
+O Agent Chat opera a aplicação através do **servidor MCP do Specrails** integrado, então ele precisa estar ativo. Se não estiver, o painel abre com um banner de **Ativar Specrails MCP** de um clique — pressione-o e está pronto (sem reiniciar). Veja [Controle o Specrails a partir de qualquer IA](./5-mcp-server.md) para os detalhes; nada é instalado, tudo é local na sua máquina.
+
+## Escolher sobre o que ele trabalha
+
+O cabeçalho tem um **seletor de projeto** (como o do Cursor). Escolha um projeto e tudo o que você pedir fica restrito a ele — *«lança os de alta prioridade»* se resolve contra esse projeto. Deixe-o em **Início** e o agente trabalha sobre toda a sua configuração: ele pode listar ou criar projetos e responder perguntas que abrangem tudo. Se você pedir algo específico de um projeto estando em Início, ele vai perguntar qual (ou se oferecer para criar um) em vez de adivinhar.
+
+Escolher um projeto aqui **não** move o seu painel — o alvo do agente e o que você está vendo são independentes.
+
+## Provedor e modelo
+
+Logo acima da caixa de mensagem você escolhe o **provedor** (Claude, Codex ou Gemini) e o seu **modelo**. Cada provedor tem a sua própria lista de modelos, e trocar de provedor inicia uma sessão nova com o modelo padrão daquele provedor — assim você pode, por exemplo, conduzir a aplicação com o Claude e passar para o Codex em outra conversa sem que nada se misture.
+
+## Níveis de permissão — a rédea está com você
+
+O agente pode mexer na aplicação inteira, então você decide quanta liberdade ele tem por meio de um **nível** que você muda ao vivo pressionando **Shift+Tab** (o mesmo ciclo que o Claude Code usa). Cada nível inclui tudo o que está abaixo:
+
+| Nível | O que ele pode fazer |
+|---|---|
+| 👀 **Observa** | Somente leitura — listar e inspecionar projetos, specs, jobs, análises. Nada muda. |
+| ✍️ **Edita** | O acima **+** criar e editar (specs, ajustes, configuração de trilhos) — mudanças reversíveis. |
+| ⚡ **Opera** | O acima **+** lançar trabalho de IA que **custa dinheiro** (trilhos, geração de specs). |
+| 🔥 **Autônomo** | O acima **+** apagar e parar coisas — ações irreversíveis. |
+
+Comece em **Observa** e suba o nível apenas quando quiser que o agente aja. Se ele tentar algo acima do nível atual, ele para e diz exatamente qual nível ativar — nunca contorna o limite. Isso é separado dos níveis de Ajustes ▸ MCP, que regem os assistentes *externos*; o nível aqui é só para este agente interno da aplicação.
+
+## Algumas coisas que você pode pedir
+
+Quando estiver em **Opera**, experimente:
+
+> *«Lista todas as specs pendentes do projeto da API e depois lança as três de maior prioridade em trilhos separados e fica de olho nelas.»*
+>
+> *«Quanto gastei esta semana, detalhado por projeto?»*
+>
+> *«Cria uma spec para um botão de alternância de modo escuro no projeto web, com Contract Layer.»*
+>
+> *«Algo falhou no último lote — encontra os jobs que falharam e resume o porquê.»*
+
+As respostas chegam de forma fluida e já formatadas (títulos, tabelas, listas), cada uma com um pequeno botão de **copiar**. Uma etiqueta de status embaixo mostra o que o agente está fazendo agora — *Pensando…*, *MCP · jobs*, *Terminal* — para que você sempre saiba o estado dele.
+
+## Detalhes práticos
+
+- **Histórico de prompts.** Com a caixa vazia, pressione **↑**/**↓** para percorrer o que você perguntou antes (mostrado esmaecido enquanto rola); comece a digitar para editar, ou pressione Enter para enviar.
+- **Minimize sem perder nada.** Clique no ✕ para devolver o painel à bolha — a conversa continua rodando. Reabra e você chega na mensagem mais recente; nada é redigitado.
+- **Nova conversa.** O botão **+** inicia um fio limpo; o histórico vive no nível da aplicação, acima de qualquer projeto individual.
+
+## Algumas coisas para saber
+
+- **Opera e Autônomo custam dinheiro** porque executam IA. O agente destaca as ações que geram custo antes de fazê-las; mantenha o nível em Observa ou Edita se você só quer olhar e organizar.
+- **O agente é de toda a aplicação**, não está atrelado ao projeto que você tem aberto — é por isso que ele tem o próprio seletor e o histórico dele não é por projeto.
+- **Ele é tão capaz quanto o MCP permitir.** Se uma área inteira parecer bloqueada, verifique se o servidor MCP está ativado.

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

@@ -0,0 +1,64 @@
+# 用对话操作 Specrails（Agent Chat）
+
+**Agent Chat** 是一个住在 Specrails *内部*的副驾驶，可以替你驱动整个应用。你不必再在项目、规格、轨道和分析之间来回点击，只需开口就行：*「这周有多少任务成功了？」*、*「在 API 项目里为社交登录创建一份规格」*、*「启动优先级最高的三个工单，完成后告诉我」*。它通过调用 Specrails 自己的工具来完成工作——正是 [MCP 服务器](./5-mcp-server.md)所暴露的那些工具——与此同时你能看到后面的仪表盘实时更新。
+
+> **不要与流水线智能体混淆。** *智能体*板块（Architect → Developer → Reviewer）讲的是*轨道如何实现一份规格*。而 **Agent Chat** 是一个*操作应用本身*的单一助手。两回事，同一个词。
+
+## 如何打开
+
+窗口底部有一个漂浮的**气泡**——点击它即可打开面板，或在任何地方按 **⌘⇧A**（Windows/Linux 上为 **Ctrl+Shift+A**）。面板是一个真正的窗口，你可以移动、缩放、最大化，也可以把它收回气泡；它会记住你上次放的位置。
+
+它**特意设计为非模态**：后面的仪表盘保持鲜活，所以当智能体启动一条轨道或创建一份规格时，你能实时看到它出现——你面对的不是一块冻结的屏幕。
+
+## 前提条件：MCP 服务器
+
+Agent Chat 通过内嵌的 **Specrails MCP 服务器**来驱动应用，因此它必须处于开启状态。如果没有开启，面板会打开并显示一个一键式的**启用 Specrails MCP** 横幅——按一下即可就绪（无需重启）。详情见[从任意 AI 控制 Specrails](./5-mcp-server.md)；不安装任何东西，一切都在你本机本地运行。
+
+## 选择它作用的对象
+
+标题栏有一个**项目选择器**（就像 Cursor 的那样）。选定一个项目，你提出的一切都会限定在它之内——*「启动高优先级的那些」*会针对那个项目来解析。把它留在**首页**，智能体就在你的整套配置上工作：它可以列出或创建项目，并回答涵盖全局的问题。如果你在首页却问了某个项目专属的事情，它会反问你是哪个项目（或主动提议创建一个），而不是瞎猜。
+
+在这里选择项目**不会**移动你的仪表盘——智能体的目标和你正在看的内容是彼此独立的。
+
+## 提供方与模型
+
+在消息框正上方，你可以选择**提供方**（Claude、Codex 或 Gemini）及其**模型**。每个提供方都有各自的模型清单，切换提供方会以该提供方的默认模型开启一段全新会话——因此你可以，比如说，用 Claude 驱动应用，再切到 Codex 进行另一段对话，两者互不串扰。
+
+## 权限级别——缰绳在你手里
+
+智能体可以触及整个应用，因此由你来决定给它多大的自由，方法是按 **Shift+Tab** 实时切换的一个**级别**（与 Claude Code 使用的是同一套循环）。每个级别都包含其下方的一切：
+
+| 级别 | 它能做什么 |
+|---|---|
+| 👀 **观察** | 只读——列出并查看项目、规格、任务、分析。什么都不会改变。 |
+| ✍️ **编辑** | 以上 **+** 创建和编辑（规格、设置、轨道配置）——可撤销的改动。 |
+| ⚡ **操作** | 以上 **+** 启动**会产生费用**的 AI 工作（轨道、规格生成）。 |
+| 🔥 **自主** | 以上 **+** 删除和停止各种东西——不可逆的操作。 |
+
+从**观察**开始，只有当你想让智能体动手时才提升级别。如果它尝试超出当前级别的操作，它会停下来，并准确告诉你需要切换到哪个级别——它绝不会绕过限制。这与 设置 ▸ MCP 的分级是相互独立的，后者管辖的是*外部*助手；这里的级别只针对这个应用内的智能体。
+
+## 一些可以让它做的事
+
+进入**操作**后，试试：
+
+> *「列出 API 项目里所有待办规格，然后把优先级最高的三个分别放到独立的轨道上启动并盯着它们。」*
+>
+> *「我这周花了多少钱，按项目拆分一下？」*
+>
+> *「在 web 项目里为深色模式开关创建一份规格，带上 Contract Layer。」*
+>
+> *「上一批里有东西失败了——找出失败的任务并总结原因。」*
+
+回复会顺滑地流式呈现，并已排版落地（标题、表格、列表），每一段都带一个小小的**复制**按钮。底部的状态标签会显示智能体此刻正在做什么——*思考中……*、*MCP · jobs*、*Terminal*——让你随时了解它的状态。
+
+## 贴心细节
+
+- **提示词历史。** 在输入框为空时，按 **↑**/**↓** 浏览你之前问过的内容（滚动时以淡化样式显示）；开始输入即可编辑，或按回车发送。
+- **最小化，而不丢失。** 点击 ✕ 把面板收回气泡——对话仍在继续运行。重新打开时你会落在最新一条消息上；无需重新输入任何内容。
+- **新建对话。** **+** 按钮开启一段全新的线程；历史记录存在于整个应用层面，凌驾于任何单个项目之上。
+
+## 一些需要知道的事
+
+- **操作和自主会产生费用**，因为它们运行 AI。智能体会在执行会产生费用的操作前把它们摆到明面上；如果你只想查看和整理，就把级别保持在观察或编辑。
+- **智能体是全应用范围的**，并不绑定于你当前打开的项目——这正是它拥有自己的选择器、且历史记录不按项目区分的原因。
+- **它的能力上限取决于 MCP 允许的范围。** 如果整个区域看起来都被禁用，请检查 MCP 服务器是否已启用。