specrails-desktop 2.30.2 → 2.31.0

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

@@ -23,6 +23,7 @@ Das Einzige, was specrails nicht mitbringen kann, ist die **KI-Provider-CLI** se
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 Installiere die, die du nutzen möchtest, melde dich einmal über dein Terminal an – fertig. specrails erkennt automatisch, welche Provider vorhanden sind.
 

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

@@ -26,13 +26,13 @@ Die rechte Seitenleiste ist deine Schaltzentrale für das aktuelle Projekt. Fahr
 
 - **Dashboard** – das Specs-Board und die Rails (wo du gerade warst).
 - **Jobs** – jeder Pipeline-Lauf dieses Projekts, vergangen und aktuell, mit Status, Dauer und der Möglichkeit, in die Details und Logs jedes Laufs einzutauchen.
-- **Analytics** – was deine KI-Nutzung kostet. Ausgaben aufgeschlüsselt nach Tag, nach Aktivität, nach Modell und nach Ticket – damit es keine Überraschungen gibt.
-- **Agenten** – die Agent-Profile deines Projekts: welche Agenten in der Pipeline laufen und welche KI-Modelle sie nutzen. *(Nur bei Claude-betriebenen Projekten.)*
-- **Code** – ein schreibgeschützter Datei-Browser mit KI-Zusammenfassungen in einfacher Sprache und Chips, die zeigen, welche Dateien die KI angefasst hat. Ideal für Nicht-Entwickler, die mitverfolgen möchten.
+- **Analytics** – Aufrufe nach Tag, Aktivität, Modell und Ticket. Claude meldet abgerechnete Kosten, Codex/Gemini Schätzwerte; Kimi lässt nicht verfügbare Token-/USD-Felder leer.
+- **Agenten** – provider-spezifische Profile und Rollenkataloge für Claude und Kimi. Kimi-Rollen lassen sich manuell erstellen und bearbeiten; Generate, Test und AI Refine sind nicht verfügbar.
+- **Code** – ein schreibgeschützter Datei-Browser mit Chips für von der KI berührte Dateien. KI-Zusammenfassungen in einfacher Sprache erscheinen nur bei kompatiblen Providern und sind mit Kimi nicht verfügbar.
 - **Integrationen** – optionale Erweiterungen, etwa das Verbinden deiner Specs mit einem **Jira**-Board oder das Aktivieren zusätzlicher Werkzeuge für die KI.
 - **Einstellungen** – projektspezifische Optionen (Telemetrie, Budgets, Provider-Konfiguration und mehr).
 
-> Manche Abschnitte erscheinen nur, wenn sie für die gewählten Provider sinnvoll sind – zum Beispiel ist **Agenten** spezifisch für Claude. Siehst du einen Abschnitt nicht, gilt er für das Setup dieses Projekts schlicht nicht.
+> Abschnitte und Aktionen richten sich nach den Fähigkeiten des effektiven Providers. Profile funktionieren etwa mit Claude und Kimi; Agent Studios KI-Aktionen werden mit Kimi dagegen sicher abgelehnt.
 
 ## Die Statusleiste
 

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

@@ -1,16 +1,21 @@
-# KI-Anbieter (Claude, Codex, Gemini)
+# KI-Anbieter (Claude, Codex, Gemini, Kimi)
 
-Specrails ist nicht an eine einzige KI gebunden. Jeder Teil der App, der mit einer KI spricht — Explore Spec, Quick-Spec, Rails, Chat, AI Edit, der „Open AI CLI“-Button im Terminal — kann über einen von drei vollwertigen Anbietern laufen. Du legst fest, welche ein Projekt verwendet, und kannst sogar pro Aufgabe umschalten.
+Specrails ist nicht an eine einzige KI gebunden. Claude, Codex, Gemini und
+Kimi sind vollwertige Anbieter; jede Oberfläche zeigt nur Engines, deren
+Fähigkeiten ihren Vertrag erfüllen.
 
-## Die drei Anbieter
+## Die vier Anbieter
 
 | Anbieter | CLI | Hersteller | Hinweise |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | Der mit Abstand umfangreichste. Der einzige Anbieter für Agents (Profile), Freestyle-Rails und Contract Refine. |
+| **Claude** | `claude` | Anthropic | Native Kosten und persistenter interaktiver Transport. |
 | **Codex** | `codex` | OpenAI | Benötigt codex `0.128.0+`. Liest seine MCP-Server aus deiner globalen `~/.codex/config.toml`. |
 | **Gemini** | `gemini` | Google | Benötigt gemini `0.11.0+`. Nutzt native Telemetrie und eine `GEMINI.md`-Instruktionsdatei. |
+| **Kimi Code** | `kimi` | Moonshot AI | Benötigt Kimi `0.27.0+`. Desktop startet die externe CLI mit `-p`; kein Server wird installiert oder gestartet. |
 
-Alle drei sind **standardmäßig aktiviert**. Ein Anbieter taucht in **Projekt hinzufügen** auf, sobald seine CLI installiert ist und in deinem `PATH` liegt. Der erste Schritt ist also immer derselbe: Installiere die gewünschte CLI und melde dich damit an — genau so, wie es in der jeweiligen Dokumentation des Tools beschrieben ist. Sobald `claude --version` (oder `codex` bzw. `gemini`) in deinem Terminal funktioniert, kann Specrails es nutzen.
+Alle vier sind **standardmäßig aktiviert**. Ein Anbieter erscheint, wenn seine
+CLI im `PATH` liegt. Für Kimi: `kimi --version` prüfen und `kimi login`
+ausführen.
 
 ## Einen Anbieter für ein Projekt installieren
 
@@ -25,40 +30,46 @@ Du kannst **mehr als einen** Anbieter in dasselbe Projekt installieren — zum B
 Ein paar Dinge, die du über Multi-Anbieter-Projekte wissen solltest:
 
 - **Ein einzelner Anbieter verhält sich genau wie zuvor.** Hat ein Projekt nur einen einzigen Anbieter, siehst du nirgendwo eine Anbieterauswahl — die App bleibt schlank und einfach.
-- **Die rechte Seitenleiste zeigt nur Bereiche, die jeder installierte Anbieter unterstützt.** Da Agents (Profile) ein reines Claude-Konzept ist, verschwindet der Bereich **Agents** in dem Moment, in dem ein Projekt einen Nicht-Claude-Anbieter enthält. Alles andere (Specs, Code, Analytics, Integrationen, Terminal, Chat) bleibt erhalten.
+- **Fähigkeiten steuern die UI.** Claude und Kimi unterstützen getrennte
+  provider-spezifische Profile; Codex und Gemini laufen im Legacy-Modus.
 - **Die Anbieterwahl ist nach dem Anlegen festgelegt.** In dieser Version wählst du deine Anbieter beim Hinzufügen des Projekts, und sie lassen sich später nicht mehr über die Einstellungen ändern. Brauchst du eine andere Kombination, ist das ein neues Projekt.
 
 ## Pro Aufruf einen Anbieter wählen
 
 Der eigentliche Gewinn eines Multi-Anbieter-Projekts liegt darin, für jede Aufgabe die richtige KI zu wählen — ohne irgendeine globale Einstellung zu ändern. Überall dort, wo eine KI läuft, erscheint eine kleine Anbieterauswahl (nur, wenn das Projekt mehr als einen Anbieter hat):
 
-- **Spec hinzufügen** — über die Engine-Auswahl kannst du eine Spec mit dem Anbieter deiner Wahl per Explore oder Quick erzeugen.
+- **Spec hinzufügen** — Explore unterstützt Kimi; Quick Spec zeigt nur
+  Provider mit einer sicheren Pure-Output-Grenze und daher kein Kimi.
 - **Rail-Kopf** — wähle die Engine für genau diese Rail, bevor du sie startest.
 - **Terminal** — der „Open AI CLI“-Button (Sparkles) öffnet ein Anbietermenü, über das du in jede installierte CLI im Verzeichnis dieses Projekts springen kannst.
 
 Deine Wahl wird pro Projekt gemerkt und fällt standardmäßig auf den primären Anbieter zurück — du musst also nicht jedes Mal neu wählen.
 
-## Was nur Claude kann
+## Unterschiede der Fähigkeiten
 
-Eine Handvoll Funktionen sind ihrer Natur nach Claude-spezifisch und werden daher ausgeblendet oder übersprungen, wenn ein anderer Anbieter im Spiel ist:
+Kimi unterstützt Project/Agent Chat, Explore/Proposals, Quick Launcher
+(`/opsx:ff`), Rails, Freestyle, Loops ohne Decider, Profile/manuelle Rollen,
+MCP, Serena, Terminal und Anhänge.
 
-- **Agents (Profile)** — der projektbezogene Agenten-Katalog und das Modell-Routing. Auf jedem Projekt ausgeblendet, das einen Nicht-Claude-Anbieter enthält.
-- **Freestyle-Rails** — laufen immer auf Claude.
-- **Contract Refine** — der zusätzliche „Contract Layer“-Durchlauf auf einer committeten Spec läuft nur, wenn der Anbieter der Konversation Claude ist.
-- **Erweiterte Modi bei „Spec hinzufügen“** (SMASH / Contract Layer) — bei Nicht-Claude-Engines ausgeblendet.
-
-Alles andere — Explore, Quick-Spec, die vollständige Rails-Pipeline, AI Edit, Chat, Kosten-Analytics — funktioniert über alle drei hinweg.
+`kimi -p` genehmigt Tools automatisch und kann keine No-Tools/Read-only-Grenze
+erzwingen. Vor dem Spawn abgelehnt werden daher Quick Spec, AI Edit, Contract
+Refine, SMASH/Re-SMASH, Project-Builder-Blueprint/Milestone-Generierung, Loop
+Decider, Datei-Zusammenfassungen/Construction Story und Agent-Studio-
+Automatisierung. Auto-Title nutzt einen deterministischen Fallback. Siehe
+[Kimi-Guide](../../../kimi.md).
 
 ## Kostenverfolgung über alle Anbieter hinweg
 
-Die **Analytics**-Seite erfasst jeden abrechenbaren Aufruf unabhängig vom Anbieter. Auf Multi-Anbieter-Projekten ergänzt sie Engine-Filter-Chips, mit denen du die Ausgaben pro Anbieter vergleichen kannst. Claude meldet seine eigenen exakten Kosten; für Codex und Gemini schätzt Specrails die Kosten anhand einer eingebauten Preistabelle — die Zahlen sind also gute Näherungswerte, keine tatsächlich abgerechneten Beträge.
+**Analytics** erfasst tatsächlich gestartete Aufrufe. Claude meldet Kosten,
+Codex/Gemini werden geschätzt. Kimi meldet keine autoritativen Tokens oder
+USD-Kosten; diese Felder bleiben leer.
 
 ## Fehlerbehebung
 
-- **Ein installierter Anbieter wird nicht angeboten.** Stelle sicher, dass die CLI in deinem `PATH` liegt (probiere `claude --version` / `codex --version` / `gemini --version` in einem frischen Terminal). Die App prüft Anbieter-CLIs über deinen System-`PATH`.
+- **Ein installierter Anbieter wird nicht angeboten.** Prüfe `claude --version` / `codex --version` / `gemini --version` / `kimi --version` in einem frischen Terminal.
 - **Codex-MCP-Server werden im Chat nicht geladen.** Codex liest MCP-Server aus deiner globalen `~/.codex/config.toml` — registriere sie dort mit `codex mcp add`.
 - **Notabschaltung.** Ein Anbieter lässt sich app-weit über eine Umgebungsvariable abschalten (`SPECRAILS_CODEX_BETA=0` oder `SPECRAILS_GEMINI_BETA=0`). Das blendet den Anbieter nur aus der *Auswahl* aus; es wird selten gebraucht.
 
 ## Siehe auch
 
-Die dedizierten Anbieter-Guides gehen tiefer auf jede CLI ein: Der Codex-Guide und der Gemini-Guide behandeln jeweils Einrichtung, Funktionsumfang und anbieterspezifische Besonderheiten.
+Siehe die dedizierten Guides für [Kimi](../../../kimi.md), Codex und Gemini.

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

@@ -21,7 +21,7 @@ Das Vorzeige-Plugin ist:
 3. Klicke in das Plugin hinein, um die **Installation vorab anzusehen** — das zeigt dir genau, welche Dateien sich ändern werden, bevor irgendetwas passiert.
 4. Klicke auf **Installieren**. Du siehst den Fortschritt live, während es eingerichtet wird.
 
-Im Hintergrund läuft die Installation *chirurgisch und additiv* ab: Sie fügt der `.mcp.json` deines Projekts nur ihre eigenen Einträge hinzu (und bei manchen Plugins eine Fragment-Datei im geschützten `.claude/agents/`-Namensraum). Sie schreibt deine Konfiguration nie komplett neu, und ein zweites Plugin kann das erste niemals stören. Kann sich eine Installation nicht als fehlerfrei verifizieren, wird sie sauber zurückgerollt.
+Im Hintergrund läuft die Installation *chirurgisch und additiv*: Sie ergänzt nur die native MCP-Konfiguration des gewählten Providers (und bei manchen Claude-Installationen ein Fragment unter `.claude/agents/`). Sie schreibt die Konfiguration nie komplett neu und rollt bei fehlgeschlagener Verifikation sauber zurück.
 
 ## Installierte Plugins verwalten
 
@@ -37,8 +37,8 @@ Im Hintergrund läuft die Installation *chirurgisch und additiv* ab: Sie fügt d
 
 ## Anbieterhinweise
 
-Plugins sind anbieterbewusst. Serena und ähnliche MCP-Plugins greifen bei Anbietern, die MCP über die `.mcp.json` des Projekts registrieren (Claude und Gemini). Bei Codex-Projekten werden MCP-Server stattdessen über Codex' eigene globale Konfiguration verwaltet, sodass Plugin-Einträge in **Integrationen** entsprechend gefiltert werden. Die Jira-Karte in den Integrationen ist anbieterunabhängig und erscheint für alle — siehe den Jira-Guide.
+Plugins sind anbieterbewusst. Serena unterstützt Claude über `.mcp.json`, Codex über `codex mcp add` mit isoliertem `CODEX_HOME` pro Projekt und Kimi über `.kimi-code/mcp.json`. Ein Plugin erscheint nur, wenn sein Manifest den Provider deklariert; Serena wird daher für Gemini nicht angeboten. Die Jira-Karte ist providerunabhängig.
 
 ## Reservierte Dateien
 
-Plugins verwalten eine kleine, klar abgegrenzte Menge an Dateien in deinem Projekt: deine `.mcp.json` (chirurgisch zusammengeführt), etwas Zustand unter `.specrails/plugins/` sowie pro Plugin Agenten-Fragmente unter `.claude/agents/custom-<plugin>.md`. Das sind committbare Team-Assets, falls du eine Integration mit deinen Teamkolleg:innen teilen möchtest — die App überschreibt sie nie blind.
+Plugins verwalten die native MCP-Konfiguration des Providers, Zustand unter `.specrails/plugins/` und nur bei Bedarf für Claude Fragmente unter `.claude/agents/custom-<plugin>.md`. Kimi-Einträge liegen in `.kimi-code/mcp.json`; die App schreibt keine Claude-Fragmente für Kimi und überschreibt Konfigurationen nie blind.

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

@@ -22,7 +22,14 @@ Ein Projekt hier auszuwählen **verschiebt** dein Dashboard **nicht** — das Zi
 
 ## 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.
+Direkt über dem Nachrichtenfeld wählst du den **Anbieter** (Claude, Codex,
+Gemini oder Kimi) und dessen **Modell**. Ein Anbieterwechsel startet eine
+getrennte Sitzung.
+
+Bei Kimi begrenzen die Stufen Specrails-MCP-Tools, machen `kimi -p` aber nicht
+zum Sandbox-Prozess: native Kimi-Tools werden automatisch genehmigt. Unsichere
+Pure-Output-Aktionen werden vor dem Spawn abgelehnt; siehe
+[Kimi-Matrix](../../../kimi.md).
 
 ## Berechtigungsstufen — du hältst die Leine
 

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

@@ -35,8 +35,8 @@ Das war's. Die rail startet einen KI-CLI-Prozess im richtigen Ausführungskontex
 | **Status-Pill** | `idle`, `running` oder `failed`. Es gibt kein eigenes „completed“ — eine rail kehrt auf `idle` zurück, wenn ihr Job sauber durchläuft. |
 | **Spec-Liste** | Die IDs, die dieser rail zugewiesen sind. Zieh weitere hinein oder heraus, um sie wieder zu lösen. |
 | **Loop-Auswahl** | Der Loop, den diese rail ausführt — ein eingebauter (`Implement` / `Batch` / `Freestyle`) oder ein eigener Loop. Siehe Tabelle unten. Pro rail gespeichert. |
-| **Profil-Auswahl** | Welches Agent-Profil läuft (nur bei Claude-rails). Erscheint erst, wenn das Projekt mindestens ein Profil hat. |
-| **Engine-Auswahl** | Welcher installierte Provider diese rail ausführt — Claude, Codex oder Gemini. Wird nur angezeigt, wenn das Projekt mehr als einen Provider hat. Siehe [Engine pro Rail wählen](picking-an-engine-per-rail). |
+| **Profil-Auswahl** | Welches Provider-Profil läuft (Claude- und Kimi-Rails). |
+| **Engine-Auswahl** | Welcher Provider die Rail ausführt — Claude, Codex, Gemini oder Kimi. |
 | **▶ Play / ■ Stop** | Starten oder abbrechen. |
 
 ### Was eine rail ausführt: Loops
@@ -47,9 +47,11 @@ Eine rail führt einen **Loop** aus — das Rezept für die Arbeit. Drei Loops s
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Ein Job für alle Specs auf der rail. Durchläuft die komplette Pipeline Architect → Developer → Reviewer → Ship. Der Alltagsstandard. |
 | **Batch** | `/specrails:batch-implement` | Ein Job, der die Specs der rail nacheinander abarbeitet — in abhängigkeitsbewussten Wellen. Ideal für mehrere zusammenhängende Specs. |
-| **Freestyle** | Freestyle | Claude implementiert jede Spec eigenständig und **umgeht** dabei die Pipeline. Ein unabhängiger Job pro Spec. Nur Claude. |
+| **Freestyle** | Freestyle | Claude oder Kimi implementiert jede Spec eigenständig und **umgeht** dabei die Pipeline. |
 
-Freestyle ist der Sonderfall: Es überspringt die Agent-Kette und übergibt Claude die rohe Spec, an der es mit seinen nativen Tools arbeitet. Das ist offen angelegt, deshalb öffnet Play zuerst eine Bestätigung, und eine Modell-Auswahl pro rail lässt dich zwischen Haiku / Sonnet / Opus wählen. Es erscheint nur, wenn die Engine der rail Claude ist. Ein Freestyle-Lauf ist außerdem der einzige Job, der **für dich offen bleibt**: Chatte mit ihm über den Composer der Job-Detail-Ansicht und klicke auf **Finalize**, wenn du zufrieden bist (alle anderen Jobs schließen sich selbst ab).
+Freestyle nutzt native Tools und Modelle des Providers. Claude hat persistenten
+interaktiven Transport; Kimi nutzt einen agentischen `kimi -p`-Prozess ohne
+persistentes stdin.
 
 Über die eingebauten Loops hinaus kannst du **deine eigenen Loops bauen** — einen verify → fix → verify-Zyklus wiederholen, bis ein Ziel erreicht ist, Shell-Befehle zwischen KI-Schritten verketten und mehr. Diese eigenen Loops erscheinen in derselben Loop-Auswahl. Das ist die nächste große Idee: [Der Loop Builder](the-loop-builder).
 
@@ -81,7 +83,8 @@ Klick im rail-Header auf **■ Stop**. Die App sendet `SIGTERM` an den Subprozes
 
 ## Wenn eine Rail nicht starten will
 
-Wenn du eine Engine wählst, deren CLI nicht auf deinem Rechner installiert ist, **schlägt der Start sofort fehl**, anstatt einen kaputten Job zu starten — es wird nichts gestartet. Installiere die fehlende Provider-CLI ([Codex verwenden](../integrations/using-codex), [Gemini verwenden](../integrations/using-gemini)) und starte erneut. Ein fehlendes Claude oder Codex liefert eine präzise „*<provider> CLI not found*“-Meldung; ein fehlendes Gemini zeigt heute eine generische Startfehlermeldung, aber das Ergebnis ist dasselbe.
+Fehlt die gewählte CLI, schlägt der Start vor dem Spawn fehl. Für Kimi:
+`kimi` 0.27+ installieren/anmelden; Desktop startet keinen Server.
 
 ## Alles stoppen
 
@@ -96,4 +99,4 @@ Wenn etwas nicht stimmt:
 - [Der Loop Builder](the-loop-builder) — was eine rail ausführt und wie du deine eigenen Loops baust.
 - [Die Job-Detail-Ansicht](the-job-detail-view) — Phasen, Live-Metriken, Ticket-Karten.
 - [Batch implement & Multi-Feature](batch-implement-and-multi-feature) — mehrere Specs auf einmal ausführen.
-- [Engine pro Rail wählen](picking-an-engine-per-rail) — Claude vs. Codex vs. Gemini.
+- [Engine pro Rail wählen](picking-an-engine-per-rail) — Claude, Codex, Gemini oder Kimi.

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

@@ -94,7 +94,9 @@ Ein paar Dinge, die man wissen sollte:
 - **Die Summenzeile ist echt.** Der Composer zeigt eine Live-Zusammenfassung `N Turns · $X`, aufsummiert aus dem tatsächlichen Verbrauch jedes abgeschlossenen Turns — konsistent mit dem Versprechen dieser Seite, nichts zu raten.
 - **Zwei Arten, wie eine Session endet.** Die meisten Jobs **schließen sich selbst ab**: Sobald ein Turn ohne wartende Nachrichten endet, setzt sich die Session zur Ruhe und der Job ist fertig — deine Nachrichten sind optionale Lenkung, nie eine Pflicht. Eine dezente Aktion **Jetzt abschließen** beendet sie früher, mit allem, was bis dahin entstanden ist. **Freestyle**-Jobs sind die Ausnahme: Sie warten zwischen den Turns, bis du auf **Finalize** klickst — das ist ihr Design, eine Hin-und-her-Session, die du schließt, wenn du fertig bist.
 - **Bei Loop-Läufen geht die Nachricht an den aktiven Schritt.** In einem eingebauten oder eigenen Loop erreicht deine Nachricht den **gerade laufenden KI-Schritt**. Zwischen den Schritten (während der Loop Decider nachdenkt oder ein Shell-Befehl läuft) zeigt der Composer kurz *„Warte auf den nächsten Schritt…"* — dein Entwurf bleibt erhalten, und das Senden wird wieder aktiv, sobald der nächste KI-Schritt startet. **Diesen Schritt abschließen** beendet den aktuellen Schritt vorzeitig und lässt den Loop mit dem Erreichten weiterziehen.
-- **Vorerst nur Claude.** Codex- und Gemini-Jobs laufen wie bisher als One-Shot — es erscheint kein Composer. (Server-Betreiber können das ganze Feature mit `SPECRAILS_INTERACTIVE_JOBS=false` abschalten.)
+- **Persistente Interaktion gibt es nur bei Claude.** Codex, Gemini und Kimi
+  laufen One-Shot; Kimi setzt Chats nach einem Resume Hint mit einem neuen
+  `kimi --session=<id> -p` fort.
 
 ## Diagnose-Export
 

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

@@ -81,4 +81,4 @@ Es gibt kein globales Parallelitäts-Limit, das du einstellen musst. Öffne die
 
 - [Rails & Jobs](rails-and-jobs) — das Queue-Modell im Detail.
 - [Die Job-Detail-Ansicht](the-job-detail-view) — einem Batch-Lauf live zusehen.
-- [Engine pro Rail wählen](picking-an-engine-per-rail) — beachte: Batch läuft auf jedem Provider; Freestyle gibt es nur bei Claude.
+- [Engine pro Rail wählen](picking-an-engine-per-rail) — Batch läuft auf jedem Provider; Freestyle gibt es mit Claude und Kimi.

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

@@ -1,6 +1,7 @@
 # Engine pro Rail wählen
 
-Specrails desktop behandelt **Claude Code**, **Codex CLI** und **Gemini CLI** als gleichwertige Engines. Ein Projekt kann eine, zwei oder alle drei installiert haben — und wenn mehr als eine vorhanden ist, wählst du, welche Engine jede Rail ausführt. Diese Seite zeigt die Engine-Auswahl pro Rail und wann du zu welcher greifst.
+Specrails desktop behandelt **Claude Code**, **Codex CLI**, **Gemini CLI** und
+**Kimi Code** als gleichwertige Engines. Jede kompatible Kombination ist möglich.
 
 ## Wann die Auswahl erscheint
 
@@ -13,30 +14,27 @@ Wenn sie erscheint, gilt deine Wahl **pro Rail und pro Start** — verschiedene
 ## So wählst du eine Engine
 
 1. Vergewissere dich, dass die Engine-Auswahl der Rail sichtbar ist (Projekt hat 2+ Provider).
-2. Klick darauf und wähle **Claude**, **Codex** oder **Gemini**.
+2. Klick darauf und wähle **Claude**, **Codex**, **Gemini** oder **Kimi**.
 3. Starte die Rail mit **▶ Play**.
 
 Die ausgewählte Engine führt jede Phase der Pipeline dieser Rail aus. Ist die CLI der gewählten Engine nicht installiert, schlägt der Start sofort fehl — es wird nichts gestartet. Installiere die fehlende CLI und versuch es erneut.
 
 ## Wofür jede Engine gut ist
 
-Alle drei führen die Standard-Pipelines **Implement** und **Batch** aus. Hier ein praktischer Leitfaden zur Auswahl:
+Alle vier führen **Implement** und **Batch** aus:
 
 | Engine | Greif dazu, wenn… | Hinweise |
 |--------|--------------------|-------|
-| **Claude** | Du den vollen Funktionsumfang willst: Agent-Profile, Freestyle, native Kostenmeldung, die umfangreichste Tool-Unterstützung. Der Standard für die meiste Arbeit. | Die einzige Engine, die **Agent-Profile**, **Freestyle** und ein paar Claude-exklusive Spec-Features (Contract Layer, SMASH) unterstützt. |
+| **Claude** | Du native Kosten, persistente Interaktion oder strikte Tool-Policies brauchst. | Profile, Freestyle und strukturierte Transforms. |
 | **Codex** | Du die OpenAI Codex CLI bevorzugst oder Implementierungen über verschiedene Provider hinweg vergleichen willst. | `codex` ≥ 0.128.0. Keine native Kostenmeldung — die App ergänzt die Kosten aus ihrer Preistabelle. Profile gelten nicht. |
 | **Gemini** | Du Googles Gemini CLI, native Telemetrie oder einen günstigeren Lauf für Routine-Specs willst. | `gemini` ≥ 0.11.0 (setze `GEMINI_API_KEY`). Native OTLP-Telemetrie. Profile gelten nicht. |
+| **Kimi** | Du agentisches Kimi für Implement, Batch, Freestyle oder Loops ohne Decider willst. | Externes `kimi` ≥ 0.27.0; Profile/Rollen, Effort nur K3; Tokens/Kosten nicht verfügbar. |
 
-### Die Claude-exklusiven Features
+### Fähigkeitsunterschiede
 
-Ein paar Dinge funktionieren nur auf Claude-Rails — wähle Claude, wenn du sie brauchst:
-
-- **Agent-Profile** — Modell-Routing pro Agent. Auf Codex- oder Gemini-Rails läuft der Lauf immer im Legacy-Modus, und ein ausgewähltes Profil wird **ignoriert**. Die Profil-Auswahl ist für Nicht-Claude-Engines ausgeblendet.
-- **Freestyle** — der autonome, pipeline-umgehende Modus. Das `Freestyle`-Segment und seine Haiku/Sonnet/Opus-Modell-Auswahl erscheinen nur, wenn die Engine der Rail Claude ist.
-- **Contract Layer & SMASH** — Claude-exklusive Features zur Spec-Verfeinerung (das sind Add-Spec-Optionen, keine Rail-Optionen, aber dieselbe Einschränkung gilt).
-
-Wenn ein Projekt Engines mischt, zeigt die rechte Seitenleiste nur Bereiche, die **jeder** installierte Provider unterstützt — der **Agents**-Bereich verschwindet also komplett bei einem Projekt, das irgendeinen Nicht-Claude-Provider enthält, weil Profile Claude-spezifisch sind.
+Claude und Kimi unterstützen Profile/Freestyle; Codex/Gemini laufen legacy.
+Kimi lehnt Loop Decider und die Pure-Output-Transforms im
+[Kimi-Guide](../../../kimi.md) ab. Claude/Kimi-Profile sind getrennt.
 
 ## Ein praktischer Workflow
 
@@ -49,12 +47,14 @@ Multi-Provider-Projekte spielen ihre Stärken aus, wenn du **vergleichen** oder
 ## Worauf du achten solltest
 
 - **Die Provider-Wahl ist nach dem Anlegen des Projekts unveränderlich** (v1). Du wählst die installierten Provider beim Hinzufügen des Projekts; es gibt keinen Einstellungs-Schalter, um später einen hinzuzufügen oder zu entfernen.
-- **Kosten werden immer verfolgt**, auch für Engines ohne native Kostenmeldung — die App greift auf eine Preistabelle zurück, sodass auch Codex- und Gemini-Läufe in den [Analysen](../analytics/tracking-cost) auftauchen.
+- **Verfügbare Metriken werden erfasst.** Kimi liefert keine autoritativen
+  Tokens/USD-Kosten; die Felder bleiben leer.
 - **Der „Open AI CLI“-Button im Terminal** bietet bei Multi-Provider-Projekten ebenfalls eine Provider-Auswahl, falls du eine CLI lieber von Hand bedienst.
 
 ## Wie es weitergeht
 
 - [Codex verwenden](../integrations/using-codex) — installieren und anmelden.
 - [Gemini verwenden](../integrations/using-gemini) — installieren, `GEMINI_API_KEY`, Telemetrie.
+- [Kimi verwenden](../../../kimi.md) — Installation und vollständige Matrix.
 - [Rails & Jobs](rails-and-jobs) — die Queue und der Start-Flow.
 - [Kosten verfolgen](../analytics/tracking-cost) — Kostenaufschlüsselung pro Engine.

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

@@ -17,7 +17,7 @@ Ein **Loop** ist das *Rezept* für die Arbeit; eine **rail** ist die *Spur*, die
 
 - Loops leben im **Loops**-Bereich (linke Seitenleiste, neben deinen Projekten) — sie sind **global**, projektübergreifend geteilt.
 - Eine rail **wählt einen Loop** in ihrem Header (der Loop-Picker) und führt ihn aus, wenn du Play drückst.
-- Die **rail** entscheidet über Provider, Modell und Reasoning-Aufwand — *nicht* die Schritte des Loops. Derselbe Loop läuft auf Claude, Codex oder Gemini, je nach rail.
+- Die **rail** wählt Provider, Modell und kompatiblen Aufwand. Ein kompatibler Loop läuft auf Claude, Codex, Gemini oder Kimi.
 
 Also: Bau einen Loop einmal, dann wähl ihn auf jeder rail in jedem Projekt.
 
@@ -41,6 +41,10 @@ Ein Loop ist ein Graph aus **Knoten**, verbunden durch **Kanten** (die Pfeile).
 
 Kanten verbinden die Schritte der Reihe nach. Der **Loop Decider** hat zwei beschriftete Ausgänge — **continue** und **stop** — also verdrahtest du „noch nicht fertig" zurück in die Arbeit und „fertig" hinaus zu einem End.
 
+> **Kimi führt Loops mit AI-/Shell-Schritten aus, aber nicht mit Loop
+> Decider.** Das Urteil ist Pure-Output; `kimi -p` kann die No-Tools-Grenze
+> nicht erzwingen. Der Run wird vor dem ersten Schritt abgelehnt.
+
 ### Schritt-Text schreiben
 
 Innerhalb jedes AI Step oder Decider kannst du referenzieren:
@@ -57,7 +61,7 @@ Ein Loop, der nie stoppt, würde ewig Geld verbrennen, also hat jeder Lauf drei
 |-------|--------------|
 | **Max iterations** | Harte Obergrenze, wie oft der Decider zurückschleifen darf, unabhängig von seinem Urteil. |
 | **Timeout (min)** | Echtzeit-Limit für den gesamten Lauf. |
-| **Max cost ($)** | *Optional.* Stoppt den Loop, sobald die aufgelaufenen Kosten dein Budget überschreiten. Wird **zwischen Schritten** geprüft (die Kosten eines Schritts sind erst bekannt, wenn er fertig ist), kann also um einen Schritt überschießen. Auf Claude sind die Kosten exakt; auf Codex und Gemini sind sie eine Schätzung. Lass es leer für keine Obergrenze. |
+| **Max cost ($)** | *Optional.* Claude meldet Kosten; Codex/Gemini werden geschätzt. Kimi meldet keine autoritativen USD-Kosten. |
 
 ## Mit Sicherheit bauen
 

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

@@ -2,6 +2,10 @@
 
 Der Quick-Modus ist für die Momente gedacht, in denen du bereits weißt, was du willst. Du tippst deine Idee ein, die KI schreibt die vollständige Spec, und sie landet als **To-do** auf deinem Board. Kein Hin und Her – einfach beschreiben und los.
 
+> **Kimi ist für Quick Spec nicht verfügbar.** `kimi -p` kann die
+> Pure-Output-Grenze dieses Formulars nicht erzwingen. Die Anfrage wird vor
+> dem Spawn abgelehnt; nutze Explore, Raw oder Quick Launcher (`/opsx:ff`).
+
 ## Eine Spec im Quick-Modus erstellen
 
 So erstellst du schnell eine Spec:
@@ -19,7 +23,8 @@ Das ist der ganze Ablauf. Alles Weitere unten ist optionale Feinjustierung.
 
 **Modell** – standardmäßig wählt die KI ein sinnvolles Modell. Du kannst es pro Spec über die Modellauswahl überschreiben, wenn du ein schnelleres oder leistungsfähigeres möchtest.
 
-**Engine** – wenn in deinem Projekt mehr als ein KI-Provider installiert ist (irgendeine Mischung aus Claude, Codex und Gemini), sitzt oben im Dialog eine Engine-Auswahl, mit der du festlegst, welche diese Spec generiert. Deine Wahl wird pro Projekt gemerkt. Projekte mit nur einem Provider zeigen das nicht – es gibt ja nichts zu wählen.
+**Engine** – die Auswahl zeigt nur **kompatible** Provider; Kimi ist bei Quick
+Spec ausgeschlossen.
 
 **Kontext** – der Quick-Modus läuft meist als einzelner Durchgang, weil er deine Codebasis nicht lesen muss, um aus deiner Beschreibung eine Spec zu schreiben. Aber ein Kontext-Schieberegler erlaubt dir, ihm mehr an die Hand zu geben:
 

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

@@ -37,7 +37,13 @@ That's the whole flow: choose a profile, launch, done. Concurrent rails in the s
 
 ## When the Agents section is quiet
 
-Profiles are a Claude capability. On a project that includes a non-Claude provider (Codex or Gemini), the Agents section is hidden and rails run without profiles — that's expected, not a bug. Profiles also require a recent enough `specrails-core` in the project; if it's older, you'll see a yellow banner. Profiles you create still **save** — they just don't affect the pipeline until core is updated. Update with the command shown in the banner to unlock them.
+Profiles are provider-scoped. Claude and Kimi support role/profile execution;
+Codex and Gemini rails use legacy mode. A mixed project keeps independent
+Claude and Kimi profile files/models, so identically named profiles cannot
+silently cross providers. Kimi also supports manual `custom-*` role
+creation/editing/execution, while Agent Studio generation, smoke test, and AI
+Refine fail closed. Profiles require a recent enough `specrails-core`; Kimi's
+framework target requires Core 4.12.0 or newer.
 
 ## Where to go next
 

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

@@ -11,21 +11,34 @@ Each catalog entry shows what the agent is for and its default model, so you can
 
 ## Adding a custom agent
 
-Custom agents are plain Markdown files in your repository under `.claude/agents/`, named `custom-<something>.md`. The file contains the agent's instructions (its system prompt) and a small frontmatter header that includes a default `model:`.
+Custom roles are provider-native Markdown assets. Claude uses
+`.claude/agents/custom-<something>.md`; Kimi uses
+`.kimi-code/skills/custom-<something>/SKILL.md` with valid Skill
+frontmatter. The catalog/profile editor scopes models and paths to the selected
+provider.
 
-Once the file exists in the project, it appears in the catalog as a custom agent, and you can add its id to any profile's agent chain (and route tasks to it). The id must match the filename — an entry for `custom-docs` maps to `.claude/agents/custom-docs.md`.
+Once the asset exists, it appears in that provider's catalog and can be added
+to a matching profile. A Kimi role is never resolved through
+`.claude/agents`, and same-named Claude/Kimi roles remain independent.
 
 Because they live in your repo, custom agents are **committable team assets**: commit the file and your whole team gets the agent. This mirrors the core idea throughout the Agents section —
 
 > **Agent definitions are shared (they live in the repo and travel with `git`). Model configuration is per-project (it lives in profiles).**
 
-The `custom-*` namespace is reserved and protected: `specrails-core`'s `init` and `update` commands never touch `.claude/agents/custom-*.md`, so your custom agents survive core upgrades untouched. (The same protection covers plugin-contributed fragments like `custom-serena.md`.)
+The `custom-*` namespace is reserved and protected: `specrails-core` never
+overwrites Claude custom files or Kimi custom skill directories.
+
+Kimi supports manual blank/template/duplicate/edit and execution. Agent Studio
+generation, smoke Test, and AI Refine are unavailable for Kimi because
+`kimi -p` cannot enforce their no-tools/read-only boundary; direct requests
+fail before spawn.
 
 ## Putting a custom agent to work
 
 The typical flow:
 
-1. Write `.claude/agents/custom-<name>.md` with instructions and a default model.
+1. Create the provider-native Claude agent file or Kimi Skill directory with
+   instructions and a valid provider model.
 2. Confirm it shows up in **Agents → Catalog** under Custom.
 3. In **Agents → Profiles**, add the agent to a profile's chain (optionally overriding its model for that profile).
 4. Add a routing rule so tasks with the right tags reach it — or rely on the chain order.

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

@@ -36,6 +36,7 @@ Specrails works with the major AI coding CLIs:
 - **Claude** (Claude Code)
 - **Codex** (Codex CLI)
 - **Gemini** (Gemini CLI)
+- **Kimi** (Kimi Code)
 
 Pick whichever you already use — or install more than one and choose per task. A project can run on a single provider or several at once, so you're never locked in.
 
@@ -46,4 +47,4 @@ Pick whichever you already use — or install more than one and choose per task.
 - **Your machine, your code** — everything runs locally against your real repository.
 - **One place for everything** — specs, jobs, chat, a built-in terminal, and cost tracking, all in a single window.
 
-Ready to get going? Next up: [Installing & first run](installing-and-first-run).
+Ready to get going? Next up: [Installing & first run](installing-and-first-run).

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

@@ -23,6 +23,7 @@ The one thing specrails can't bundle is the **AI provider CLI** itself. You'll n
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 Install whichever you plan to use, sign in to it once from your terminal, and you're set. Specrails detects which providers are present automatically.
 
@@ -39,4 +40,4 @@ You'll see:
 
 That's the whole onboarding — no account to create, no sign-up. Specrails works entirely on your machine.
 
-Click **Add your first project** and continue to [Adding your first project](adding-your-first-project).
+Click **Add your first project** and continue to [Adding your first project](adding-your-first-project).

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

@@ -26,13 +26,13 @@ The right sidebar is your switchboard for the current project. Hover it to expan
 
 - **Dashboard** — the specs board and rails (where you just were).
 - **Jobs** — every pipeline run for this project, past and present, with status, duration, and the ability to dig into any run's detail and logs.
-- **Analytics** — what your AI usage is costing. Spending broken down by day, by activity, by model, and by ticket — so there are no surprises.
-- **Agents** — your project's agent profiles: which agents run in the pipeline and which AI models they use. *(Claude-powered projects only.)*
-- **Code** — a read-only file browser with plain-language AI summaries, and chips showing which files the AI has touched. Great for non-developers who want to follow along.
+- **Analytics** — invocations broken down by day, activity, model, and ticket. Claude reports billed cost, Codex/Gemini use estimates, and Kimi leaves unavailable token/USD fields blank.
+- **Agents** — provider-scoped profiles and role catalogs for Claude and Kimi. Kimi roles can be created and edited manually; Generate, Test, and AI Refine are unavailable.
+- **Code** — a read-only file browser and chips showing which files the AI has touched. Plain-language AI summaries appear only for providers that support that transform; they are unavailable with Kimi.
 - **Integrations** — optional add-ons, like connecting your specs to a **Jira** board or enabling extra tooling for the AI.
 - **Settings** — per-project options (telemetry, budgets, provider configuration, and more).
 
-> Some sections only appear when they make sense for the providers you chose — for example, **Agents** is specific to Claude. If you don't see a section, it simply doesn't apply to this project's setup.
+> Sections and actions appear only when they make sense for the effective provider. For example, profiles are available for Claude and Kimi, while Kimi's Agent Studio AI actions fail closed.
 
 ## The status bar
 
@@ -50,4 +50,4 @@ A thin strip runs along the very bottom of the window. It's small but handy:
 
 ## Where to go next
 
-That's the lay of the land. From here, the natural first move is to **add a spec** and launch it on a rail — watch the pipeline run end to end, then check **Analytics** to see what it cost. Welcome aboard.
+That's the lay of the land. From here, the natural first move is to **add a spec** and launch it on a rail — watch the pipeline run end to end, then check **Analytics** to see what it cost. Welcome aboard.

package/docs/guide/en/insights/3-code-explorer.md

@@ -31,6 +31,11 @@ Since editing isn't part of this version, the viewer offers an **Edit in externa
 
 Above the code you'll see a **plain-language summary** of the file — what it's for, what it does — written so a non-developer can follow along. These are generated for you and cached, so opening a file you've looked at before is instant.
 
+Kimi does not generate these summaries. File summary and construction-story
+explanation are read-only transforms, but Kimi 0.27 `-p` cannot enforce a
+read-only tool boundary. The controls are unavailable for Kimi; existing
+provenance facts, diffs, and previously generated text remain readable.
+
 Summaries are smart about staying fresh: they're keyed to the file's contents, so when a file genuinely changes the summary is regenerated, but unchanged files don't get re-summarised needlessly. If you edit a file yourself, its summary is marked as stale rather than silently regenerated — you stay in control of when it's refreshed. There's a **regenerate** action when you want a fresh take on demand.
 
 A couple of guardrails keep costs sane: summary generation runs within a **monthly budget** (a few dollars by default, configurable in Settings), and there are caps on how many summaries a single job will kick off. If a summary is skipped, the app tells you why — budget reached, a per-job cap, or the file simply not being found.