specrails-desktop 2.30.2 → 2.31.0

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

@@ -1,16 +1,20 @@
-# AI プロバイダー（Claude、Codex、Gemini）
+# AI プロバイダー（Claude、Codex、Gemini、Kimi）
 
-Specrails は特定の AI に縛られません。アプリの中で AI とやり取りするすべての部分 — Explore Spec、クイックスペック、レール、チャット、AI 編集、ターミナルの「Open AI CLI」ボタン — は、3 つのファーストクラスなプロバイダーのいずれかを通して動かせます。プロジェクトごとにどのプロバイダーを使うかを選べますし、タスク単位で切り替えることもできます。
+Specrails は特定の AI に縛られません。Claude、Codex、Gemini、Kimi
+はファーストクラスのプロバイダーで、各画面には必要な capability
+を満たすエンジンだけが表示されます。
 
-## 3 つのプロバイダー
+## 4 つのプロバイダー
 
 | プロバイダー | CLI | 提供元 | 備考 |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | 最も機能が充実しています。エージェント（プロファイル）と Freestyle レール、そして Contract Refine を使えるのは Claude だけです。 |
+| **Claude** | `claude` | Anthropic | ネイティブコストと永続的な対話 transport。 |
 | **Codex** | `codex` | OpenAI | codex `0.128.0+` が必要です。MCP サーバーはグローバルな `~/.codex/config.toml` から読み込みます。 |
 | **Gemini** | `gemini` | Google | gemini `0.11.0+` が必要です。ネイティブのテレメトリと `GEMINI.md` 指示ファイルを使用します。 |
+| **Kimi Code** | `kimi` | Moonshot AI | Kimi `0.27.0+` が必要です。Desktop は外部 CLI を `-p` で起動し、server をインストール・起動しません。 |
 
-3 つとも**デフォルトで有効**です。プロバイダーは、その CLI がインストールされていて `PATH` 上にあれば **Add Project** に表示されます。ですので、最初のステップはいつも同じです。使いたい CLI をインストールし、そのツール自身のドキュメントの手順どおりにログインしてください。ターミナルで `claude --version`（または `codex`、`gemini`）が動くようになれば、Specrails はそれを使えるようになります。
+4 つとも**デフォルトで有効**です。CLI が `PATH` にあれば表示されます。
+Kimi は `kimi --version` を確認し、`kimi login` を実行してください。
 
 ## プロジェクトに 1 つのプロバイダーをインストールする
 
@@ -25,40 +29,46 @@ Specrails は特定の AI に縛られません。アプリの中で AI とや
 マルチプロバイダーのプロジェクトについて、知っておくとよいことがいくつかあります。
 
 - **プロバイダーが 1 つなら、これまでとまったく同じ挙動です。** プロジェクトにプロバイダーが 1 つしかなければ、プロバイダーの選択 UI はどこにも表示されません — アプリはすっきりシンプルなままです。
-- **右サイドバーには、インストール済みのすべてのプロバイダーが対応しているセクションだけが表示されます。** エージェント（プロファイル）は Claude 専用の概念なので、プロジェクトに Claude 以外のプロバイダーが含まれた瞬間に **Agents** セクションは消えます。それ以外（Specs、Code、Analytics、Integrations、Terminal、Chat）はそのまま残ります。
+- **UI は capability に従います。** Claude と Kimi はプロバイダー別の
+  profile に対応し、Codex と Gemini は legacy mode で実行します。
 - **プロバイダーの選択は作成後に固定されます。** このバージョンでは、プロジェクトを追加するときにプロバイダーを選び、あとから設定で変更することはできません。別の組み合わせが必要になったら、新しいプロジェクトを作成してください。
 
 ## 呼び出しごとにプロバイダーを選ぶ
 
 マルチプロバイダーのプロジェクトの真価は、グローバル設定を一切変えずに、タスクごとに最適な AI を選べることにあります。AI が動くところには、小さなプロバイダー選択 UI が現れます（プロジェクトに複数のプロバイダーがあるときだけです）。
 
-- **Add Spec** — エンジンセレクターで、好きなプロバイダーを使ってスペックを Explore したりクイック生成したりできます。
+- **Add Spec** — Explore は Kimi に対応します。Quick Spec は安全な
+  pure-output 境界を持つプロバイダーだけを表示するため、Kimi は除外されます。
 - **レールのヘッダー** — その特定のレールを起動する前に、使うエンジンを選べます。
 - **ターミナル** — 「Open AI CLI」（Sparkles）ボタンを押すとプロバイダーメニューが開き、そのプロジェクトのディレクトリで任意のインストール済み CLI に入れます。
 
 選んだエンジンはプロジェクトごとに記憶され、デフォルトはプライマリプロバイダーです。毎回選び直す必要はありません。
 
-## Claude だけができること
+## Capability の違い
 
-いくつかの機能はその性質上 Claude 専用なので、ほかのプロバイダーが使われているときは非表示になるかスキップされます。
+Kimi は Project/Agent Chat、Explore/proposal、Quick Launcher
+(`/opsx:ff`)、rail、Freestyle、Decider のない loop、profile/手動 role、
+MCP、Serena、terminal、attachment に対応します。
 
-- **エージェント（プロファイル）** — プロジェクトごとのエージェントカタログとモデルルーティング。Claude 以外のプロバイダーを含むプロジェクトでは非表示になります。
-- **Freestyle レール** — 常に Claude で実行されます。
-- **Contract Refine** — コミット済みスペックに対する「Contract Layer」の追加パスは、会話のプロバイダーが Claude のときだけ実行されます。
-- **Add Spec の高度なモード**（SMASH / Contract Layer） — Claude 以外のエンジンでは非表示になります。
-
-それ以外 — Explore、クイックスペック、レールパイプライン全体、AI 編集、チャット、コストのアナリティクス — は 3 つすべてで動作します。
+`kimi -p` は tool を自動承認し、no-tools/read-only 境界を強制できません。
+そのため Quick Spec、AI Edit、Contract Refine、SMASH/Re-SMASH、
+Project Builder の blueprint/milestone 生成、Loop Decider、file summary/
+construction story、Agent Studio automation は spawn 前に拒否されます。
+AI auto-title は deterministic fallback を使います。詳細は
+[Kimi guide](../../../kimi.md) を参照してください。
 
 ## プロバイダー横断のコスト追跡
 
-**Analytics** ページは、プロバイダーに関係なく、課金対象となるすべての呼び出しを追跡します。マルチプロバイダーのプロジェクトでは、エンジンのフィルターチップが追加され、プロバイダーごとに支出を比較できます。Claude は自身の正確なコストを報告しますが、Codex と Gemini については、Specrails が組み込みの料金表からコストを推定します。そのため、これらの数値は請求額そのものではなく、おおよその近似値です。
+**Analytics** は実際に起動した invocation を記録します。Claude は
+cost を報告し、Codex/Gemini は推定値です。Kimi は authoritative な
+token/USD cost を報告しないため、その項目は空欄です。
 
 ## トラブルシューティング
 
-- **インストールしたプロバイダーが表示されない。** その CLI が `PATH` 上にあるか確認してください（新しいターミナルで `claude --version` / `codex --version` / `gemini --version` を試してみてください）。アプリはシステムの `PATH` を通してプロバイダー CLI を検出します。
+- **インストールしたプロバイダーが表示されない。** `claude --version` / `codex --version` / `gemini --version` / `kimi --version` を確認してください。
 - **チャットで Codex の MCP サーバーが読み込まれない。** Codex は MCP サーバーをグローバルな `~/.codex/config.toml` から読み込みます — `codex mcp add` でそこに登録してください。
 - **緊急時の無効化。** プロバイダーは環境変数（`SPECRAILS_CODEX_BETA=0` または `SPECRAILS_GEMINI_BETA=0`）でアプリ全体から無効にできます。これはプロバイダーを*選択肢*から隠すだけで、めったに必要にはなりません。
 
 ## 関連項目
 
-各 CLI をさらに詳しく解説した専用のプロバイダーガイドがあります。Codex ガイドと Gemini ガイドでは、それぞれセットアップ方法、使える機能、プロバイダー固有のクセを取り上げています。
+[Kimi guide](../../../kimi.md)、Codex guide、Gemini guide を参照してください。

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

@@ -21,7 +21,7 @@
 3. プラグインをクリックして**インストールのプレビュー**を確認します — 何かが起こる前に、どのファイルが変更されるのかを正確に確認できます。
 4. **Install** をクリックします。セットアップの進行状況がリアルタイムで表示されます。
 
-内部的には、インストールは*外科的かつ追加的*です。プロジェクトの `.mcp.json`（および一部のプラグインでは、保護された `.claude/agents/` 名前空間内のフラグメントファイル）に、自分自身のエントリだけを追加します。設定全体を書き換えることは決してなく、2 つ目のプラグインを追加しても 1 つ目を乱すことはありません。インストールが自身の正常性を検証できなかった場合は、きれいにロールバックされます。
+内部のインストールは*外科的かつ追加的*です。選択 provider の native MCP 設定（Claude の一部では `.claude/agents/` の fragment も）に自分の entry だけを加えます。設定全体は書き換えず、検証に失敗すれば clean に rollback します。
 
 ## インストール済みプラグインを管理する
 
@@ -37,8 +37,8 @@
 
 ## プロバイダーに関する注意
 
-プラグインはプロバイダーを意識します。Serena のような MCP プラグインは、プロジェクトの `.mcp.json` を通して MCP を登録するプロバイダー（Claude と Gemini）で解決されます。Codex のプロジェクトでは、MCP サーバーは Codex 自身のグローバル設定で管理されるため、**Integrations** 内のプラグインエントリはそれに応じてフィルタリングされます。Integrations 内の Jira カードはプロバイダーに依存せず、誰にでも表示されます — Jira ガイドを参照してください。
+Plugin は provider-aware です。Serena は Claude の `.mcp.json`、project ごとに分離した `CODEX_HOME` での `codex mcp add`、Kimi の `.kimi-code/mcp.json` をサポートします。Manifest が provider を宣言したときだけ表示されるため、Gemini には Serena は提供されません。Jira card は provider 非依存です。
 
 ## 予約ファイル
 
-プラグインは、プロジェクト内の小さく明確に定義されたファイル群を管理します。`.mcp.json`（外科的にマージされます）、`.specrails/plugins/` 配下の一部の状態、そして `.claude/agents/custom-<plugin>.md` にあるプラグインごとのエージェントフラグメントです。インテグレーションをチームと共有したい場合、これらはコミットできるチーム資産です — アプリがこれらを無造作に上書きすることは決してありません。
+Plugin は provider の native MCP 設定、`.specrails/plugins/` の state、必要な Claude plugin の `.claude/agents/custom-<plugin>.md` だけを管理します。Kimi entry は `.kimi-code/mcp.json` に置かれ、Kimi に Claude-only fragment を書いたり設定を無造作に上書きしたりしません。

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

@@ -22,7 +22,13 @@ Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプ
 
 ## プロバイダーとモデル
 
-メッセージ欄のすぐ上で、**プロバイダー**（Claude、Codex、Gemini）とその**モデル**を選びます。各プロバイダーには独自のモデル一覧があり、プロバイダーを切り替えるとそのプロバイダーの既定モデルで新しいセッションが始まります——ですから、たとえば Claude でアプリを操作しつつ、別の会話では Codex に切り替える、といったことが何も混ざらずにできます。
+メッセージ欄のすぐ上で、**プロバイダー**（Claude、Codex、Gemini、
+Kimi）とその**モデル**を選びます。切り替えると別 session が開始します。
+
+Kimi では level は Specrails MCP tool を制限しますが、`kimi -p` 自体を
+sandbox にはしません。native tool は自動承認されます。安全でない
+pure-output action は spawn 前に拒否されます。詳細は
+[Kimi matrix](../../../kimi.md) を参照してください。
 
 ## 権限レベル——手綱はあなたが握る
 

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

@@ -35,8 +35,8 @@ SpecsBoard（左）            レール（右）
 | **ステータスピル** | `idle`、`running`、`failed` のいずれか。「completed」という別ステータスはありません — ジョブがきれいに完了すると、レールは `idle` に戻ります。 |
 | **スペック一覧** | このレールに割り当てられた ID。さらにドラッグして追加したり、ドラッグして外したりできます。 |
 | **Loop ピッカー** | このレールが実行する Loop — 組み込み（`Implement` / `Batch` / `Freestyle`）かカスタム Loop。下の表を参照してください。レールごとに保持されます。 |
-| **プロファイルピッカー** | どのエージェントプロファイルを実行するか（Claude レール限定）。プロジェクトにプロファイルが 1 つ以上あるときだけ表示されます。 |
-| **エンジンセレクター** | このレールをどのインストール済みプロバイダーで実行するか — Claude、Codex、Gemini。プロジェクトに複数のプロバイダーがある場合だけ表示されます。[レールごとのエンジン選択](picking-an-engine-per-rail) を参照してください。 |
+| **プロファイルピッカー** | 実行する provider profile（Claude/Kimi rail）。 |
+| **エンジンセレクター** | rail を実行する provider — Claude、Codex、Gemini、Kimi。 |
 | **▶ Play / ■ Stop** | 開始またはキャンセル。 |
 
 ### レールが実行するもの: Loop
@@ -47,9 +47,11 @@ SpecsBoard（左）            レール（右）
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | レール上のすべてのスペックをまとめた 1 つのジョブ。Architect → Developer → Reviewer → Ship のフルパイプラインを実行します。日常的に使うデフォルトです。 |
 | **Batch** | `/specrails:batch-implement` | レール上のスペックを、依存関係を考慮したウェーブで順番に処理する 1 つのジョブ。関連する複数のスペックに最適です。 |
-| **Freestyle** | Freestyle | Claude が各スペックをパイプラインを**バイパス**して自律的に実装します。スペックごとに独立したジョブが 1 つずつ作られます。Claude 専用。 |
+| **Freestyle** | Freestyle | Claude または Kimi が pipeline を**バイパス**して自律的に実装します。 |
 
-Freestyle は少し毛色が違います。エージェントチェーンを飛ばし、生のスペックを Claude に渡してネイティブツールで作業させます。自由度が高いぶん、Play を押すとまず確認ダイアログが開き、レールごとのモデルピッカーで Haiku / Sonnet / Opus を選べます。Freestyle はレールのエンジンが Claude のときだけ表示されます。さらに Freestyle の実行は、**あなたを待って開き続ける**唯一のジョブでもあります。ジョブ詳細のコンポーザーから会話し、満足したら **Finalize** をクリックしてください（それ以外のジョブはすべて自分で締めくくります）。
+Freestyle は provider の native tool/model を使います。Claude は
+persistent interactive transport、Kimi は persistent stdin のない agentic
+`kimi -p` process を使います。
 
 組み込みのほかにも、**自分だけの Loop を作る** ことができます — verify → fix → verify のサイクルを目標が達成されるまで繰り返したり、AI ステップの間にシェルコマンドを連ねたり、さらにいろいろなことができます。そうしたカスタム Loop は同じ Loop ピッカーに表示されます。それが次の大きなアイデア、[Loop Builder](the-loop-builder) です。
 
@@ -81,7 +83,8 @@ git のないプロジェクトでは worktree 隔離も PR 継続も使えま
 
 ## レールが起動しないとき
 
-CLI がマシンにインストールされていないエンジンを選ぶと、起動は壊れたジョブを始めるのではなく **即座に失敗** します — 何も生成されません。足りないプロバイダー CLI をインストールして（[Codex を使う](../integrations/using-codex)、[Gemini を使う](../integrations/using-gemini)）、もう一度起動してください。Claude や Codex が見つからない場合は「*<provider> CLI not found*」という正確なメッセージが出ます。Gemini が見つからない場合は現時点では一般的な起動エラーが表示されますが、結果は同じです。
+選択した CLI がなければ spawn 前に失敗します。Kimi は `kimi`
+0.27+ を install/login してください。Desktop は server を起動しません。
 
 ## すべてを止める
 
@@ -96,4 +99,4 @@ CLI がマシンにインストールされていないエンジンを選ぶと
 - [Loop Builder](the-loop-builder) — レールが実行するもの、そして自分だけの Loop を作る方法。
 - [ジョブ詳細ビュー](the-job-detail-view) — フェーズ、ライブメトリクス、チケットカード。
 - [バッチ実装とマルチフィーチャー](batch-implement-and-multi-feature) — 複数のスペックをまとめて実行する。
-- [レールごとのエンジン選択](picking-an-engine-per-rail) — Claude / Codex / Gemini の使い分け。
+- [レールごとのエンジン選択](picking-an-engine-per-rail) — Claude / Codex / Gemini / Kimi。

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

@@ -94,7 +94,9 @@ Architect ──► Developer ──► Reviewer ──► Ship
 - **合計の行は本物です。** コンポーザーはライブの `N ターン · $X` サマリーを表示します。完了した各ターンの実際の使用量を合算したもので、このページの「推測しない」という約束と一貫しています。
 - **セッションの終わり方は 2 通り。** ほとんどのジョブは**自分で締めくくります**。キューにメッセージが残っていない状態でターンが終わった瞬間、セッションは自ら落ち着き、ジョブは完了します — あなたのメッセージは任意の舵取りであって、義務ではありません。控えめな**今すぐ締めくくる**アクションで、それまでの成果を保ったまま早めに終わらせることもできます。**Freestyle** ジョブだけは例外です。ターンの合間で待機し、あなたが **Finalize** をクリックするまで開き続けます — あなたが閉じる往復のセッション、それが Freestyle の設計です。
 - **Loop 実行では、メッセージはアクティブなステップに届きます。** 組み込みでもカスタムでも、Loop 上ではメッセージは**いままさに実行中の AI ステップ**に届きます。ステップの合間（Loop Decider が考えている間や、シェルコマンドの実行中）には、コンポーザーは*「次のステップを待っています…」*という短い待機状態を表示します — 下書きのテキストは保持され、次の AI ステップが始まると送信が再び有効になります。**このステップを確定**すると現在のステップを早めに終わらせ、その成果とともに Loop を先へ進められます。
-- **今のところ Claude のみ。** Codex と Gemini のジョブは従来どおりワンショットで実行されます — コンポーザーは表示されません。（サーバー運用者は `SPECRAILS_INTERACTIVE_JOBS=false` で機能全体を無効化できます。）
+- **persistent interaction は Claude のみです。** Codex、Gemini、Kimi は
+  one-shot です。Kimi chat は resume hint 後に新しい `kimi --session=<id> -p` で
+  resume します。
 
 ## 診断のエクスポート
 

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

@@ -81,4 +81,4 @@ Batch モードは、関連するスペックを*順番に処理する*一番す
 
 - [レールとジョブ](rails-and-jobs) — キューモデルを掘り下げて。
 - [ジョブ詳細ビュー](the-job-detail-view) — バッチ実行をライブで見守る。
-- [レールごとのエンジン選択](picking-an-engine-per-rail) — Batch はどのプロバイダーでも動きますが、Freestyle は Claude 専用である点に注意。
+- [レールごとのエンジン選択](picking-an-engine-per-rail) — Batch はすべてのプロバイダーで動き、Freestyle は Claude と Kimi で利用できます。

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

@@ -1,6 +1,8 @@
 # レールごとのエンジン選択
 
-Specrails desktop は **Claude Code**、**Codex CLI**、**Gemini CLI** をいずれも一級のエンジンとして扱います。プロジェクトには 1 つ、2 つ、あるいは 3 つすべてをインストールできます — そして複数がある場合は、各レールをどのエンジンで実行するかをあなたが選びます。このページでは、レールごとのエンジンセレクターと、それぞれをどんなときに選ぶべきかを扱います。
+Specrails desktop は **Claude Code**、**Codex CLI**、**Gemini CLI**、
+**Kimi Code** を一級の engine として扱います。compatible な組み合わせを
+install できます。
 
 ## セレクターが現れるとき
 
@@ -13,30 +15,27 @@ Specrails desktop は **Claude Code**、**Codex CLI**、**Gemini CLI** をいず
 ## エンジンの選び方
 
 1. レールのエンジンセレクターが表示されていることを確認します（プロジェクトにプロバイダーが 2 つ以上）。
-2. クリックして **Claude**、**Codex**、**Gemini** のいずれかを選びます。
+2. **Claude**、**Codex**、**Gemini**、**Kimi** を選びます。
 3. **▶ Play** でレールを起動します。
 
 選んだエンジンが、そのレールのパイプラインの全フェーズを実行します。選んだエンジンの CLI がインストールされていない場合、起動は即座に失敗します — 何も生成されません。足りない CLI をインストールして、もう一度試してください。
 
 ## それぞれのエンジンが得意なこと
 
-3 つすべてが、標準の **Implement** と **Batch** のパイプラインを実行します。選び方の実用的なガイドはこちらです。
+4 つすべてが **Implement** と **Batch** を実行します。
 
 | エンジン | こんなときに | 補足 |
 |--------|--------------------|-------|
-| **Claude** | フルの機能セットがほしいとき: エージェントプロファイル、Freestyle、ネイティブのコスト報告、最も充実したツールサポート。たいていの作業のデフォルト。 | **エージェントプロファイル**、**Freestyle**、いくつかの Claude 専用スペック機能（Contract Layer、SMASH）をサポートする唯一のエンジン。 |
+| **Claude** | native cost、persistent interaction、strict tool policy が必要。 | Profile、Freestyle、structured transform。 |
 | **Codex** | OpenAI Codex CLI を好むとき、あるいはプロバイダー間で実装を比べたいとき。 | `codex` ≥ 0.128.0。ネイティブのコスト報告なし — アプリが料金表からコストを補います。プロファイルは適用されません。 |
 | **Gemini** | Google の Gemini CLI を使いたいとき、ネイティブのテレメトリがほしいとき、あるいは日常的なスペックを安く実行したいとき。 | `gemini` ≥ 0.11.0（`GEMINI_API_KEY` を設定）。ネイティブの OTLP テレメトリ。プロファイルは適用されません。 |
+| **Kimi** | Implement、Batch、Freestyle、Decider のない loop に agentic Kimi を使う。 | 外部 `kimi` ≥ 0.27.0。Profile/role、effort は K3 のみ。token/cost は unavailable。 |
 
-### Claude 専用の機能
+### Capability の違い
 
-いくつかの機能は Claude レールでしか動きません — 必要なら Claude を選んでください。
-
-- **エージェントプロファイル** — エージェントごとのモデルルーティング。Codex や Gemini のレールでは、実行は常にレガシーモードになり、選んだプロファイルは **無視されます**。プロファイルピッカーは Claude 以外のエンジンでは非表示になります。
-- **Freestyle** — 自律的でパイプラインをバイパスするモード。`Freestyle` セグメントと、その Haiku/Sonnet/Opus のモデルピッカーは、レールのエンジンが Claude のときだけ表示されます。
-- **Contract Layer と SMASH** — Claude 専用のスペック改良機能（これらはレールのオプションではなく Add-Spec のオプションですが、同じ制約が当てはまります）。
-
-プロジェクトが複数のエンジンを混在させると、右サイドバーにはインストール済みの **すべての** プロバイダーがサポートするセクションだけが表示されます — つまり、Claude 以外のプロバイダーを含むプロジェクトでは **エージェント** セクションがまるごと消えます。プロファイルは Claude 固有のものだからです。
+Claude/Kimi は Profile と Freestyle、Codex/Gemini は legacy。Kimi は
+Loop Decider と [Kimi guide](../../../kimi.md) の pure-output transform
+を拒否します。Claude/Kimi Profile は分離されます。
 
 ## 実用的なワークフロー
 
@@ -49,12 +48,14 @@ Specrails desktop は **Claude Code**、**Codex CLI**、**Gemini CLI** をいず
 ## 覚えておきたいこと
 
 - **プロバイダーの選択はプロジェクト作成後は変更できません**（v1）。インストールするプロバイダーはプロジェクトを追加するときに選びます。あとから追加・削除する設定トグルはありません。
-- **コストは常に追跡されます。** ネイティブのコスト報告を持たないエンジンでも、アプリが料金表にフォールバックするので、Codex や Gemini の実行も [分析](../analytics/tracking-cost) に表示されます。
+- **available metrics は記録されます。** Kimi は authoritative token/
+  USD cost を報告しないため空欄です。
 - **ターミナルの「Open AI CLI」ボタン** も、複数プロバイダーのプロジェクトではプロバイダーピッカーを表示します。自分の手で CLI を動かしたいときにどうぞ。
 
 ## 次に読むもの
 
 - [Codex を使う](../integrations/using-codex) — インストールとサインイン。
 - [Gemini を使う](../integrations/using-gemini) — インストール、`GEMINI_API_KEY`、テレメトリ。
+- [Kimi を使う](../../../kimi.md) — install と capability matrix。
 - [レールとジョブ](rails-and-jobs) — キューと起動の流れ。
 - [コストの追跡](../analytics/tracking-cost) — エンジンごとのコスト内訳。

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

@@ -17,7 +17,7 @@
 
 - Loop は **Loops** セクション（左サイドバー、プロジェクトの隣）にあります — これらは **グローバル** で、すべてのプロジェクトで共有されます。
 - レールはヘッダー（Loop ピッカー）で **Loop を選び**、Play を押すとそれを実行します。
-- プロバイダー、モデル、推論の労力（reasoning effort）を決めるのは **レール** であって、Loop のステップではありません。同じ Loop が、レール次第で Claude、Codex、Gemini のいずれでも実行されます。
+- provider、model、compatible effort は **rail** が決めます。compatible な Loop は Claude、Codex、Gemini、Kimi で実行できます。
 
 つまり、Loop を一度作ってしまえば、どのプロジェクトのどのレールでもそれを選べます。
 
@@ -41,6 +41,10 @@ Loop は **ノード** を **エッジ**（矢印）でつないだグラフで
 
 エッジはステップを順番につなぎます。**Loop Decider** には **continue** と **stop** という 2 つのラベル付き出力があるので、「まだ終わっていない」を作業へ配線して戻し、「終わった」を End へ配線して出します。
 
+> **Kimi は AI/shell step の loop に対応しますが、Loop Decider には
+> 対応しません。** verdict は pure-output で、`kimi -p` は no-tools
+> 境界を強制できません。run は最初の step より前に拒否されます。
+
 ### ステップのテキストを書く
 
 AI Step や Decider の中では、次のものを参照できます。
@@ -57,7 +61,7 @@ AI Step や Decider の中では、次のものを参照できます。
 |-------|--------------|
 | **Max iterations** | Decider が判断にかかわらずループバックできる回数のハードキャップ。 |
 | **Timeout (min)** | 実行全体に対する実時間（壁時計）の上限。 |
-| **Max cost ($)** | *任意。* 累積コストが予算を超えた時点で Loop を停止します。**ステップとステップの間** でチェックされるため（あるステップのコストはそれが終わってからしかわかりません）、1 ステップ分だけオーバーシュートすることがあります。Claude ではコストは正確で、Codex と Gemini では見積もりです。上限を設けないなら空のままにしておきます。 |
+| **Max cost ($)** | *任意。* Claude は cost、Codex/Gemini は estimate。Kimi は authoritative USD cost を報告しません。 |
 
 ## 自信を持って組み立てる
 

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

@@ -2,6 +2,10 @@
 
 クイックモードは、やりたいことがすでにわかっているときのためのモードです。アイデアを入力すれば AI がスペック全文を書き上げ、**Todo** としてボードに着地します。やり取りは不要。記述したら、あとは進むだけです。
 
+> **Kimi は Quick Spec では利用できません。** `kimi -p` はこの
+> pure-output 境界を強制できないため、spawn 前に拒否されます。Explore、
+> Raw、または Quick Launcher（`/opsx:ff`）を使ってください。
+
 ## クイックモードでスペックを作成する
 
 すばやくスペックを作成するには、次の手順で進めます。
@@ -19,7 +23,8 @@
 
 **モデル** — デフォルトでは AI が手頃なモデルを選びます。より速いモデルやより高性能なモデルを使いたい場合は、モデルピッカーからスペックごとに上書きできます。
 
-**エンジン** — プロジェクトに複数の AI プロバイダー（Claude・Codex・Gemini のいずれかの組み合わせ）がインストールされている場合、ダイアログ上部にエンジンセレクターが現れ、このスペックをどのエンジンで生成するか選べます。選んだ内容はプロジェクトごとに記憶されます。プロバイダーが 1 つだけのプロジェクトでは、選ぶ余地がないため表示されません。
+**エンジン** — セレクターには **compatible** なプロバイダーだけが
+表示され、Quick Spec では Kimi は除外されます。
 
 **コンテキスト** — クイックモードは通常 1 ターンで動きます。あなたの説明からスペックを書くだけなら、コードベースを読む必要がないからです。ただし、コンテキストスライダーを使えば、AI が参照できる材料を増やせます。
 

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

@@ -37,7 +37,11 @@ A seleção do perfil acontece mesmo onde lança — no **cabeçalho do rail**,
 
 ## Quando a secção Agentes está silenciosa
 
-Os perfis são uma capacidade do Claude. Num projeto que inclua um provider que não seja o Claude (Codex ou Gemini), a secção Agentes fica oculta e os rails correm sem perfis — isso é esperado, não é um bug. Os perfis também exigem uma versão suficientemente recente do `specrails-core` no projeto; se for mais antiga, verá um banner amarelo. Os perfis que criar continuam a ser **guardados** — apenas não afetam o pipeline até o core ser atualizado. Atualize com o comando indicado no banner para os desbloquear.
+Os perfis são separados por provider. Claude e Kimi suportam perfis/roles;
+Codex e Gemini usam modo legacy. Em projetos mistos o mesmo nome não atravessa
+Claude/Kimi. Kimi permite roles manuais, mas generation, smoke test e AI
+Refine do Agent Studio são recusados antes do spawn. Kimi exige
+`specrails-core` 4.12.0 ou mais recente.
 
 ## Para onde ir a seguir
 

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

@@ -11,21 +11,24 @@ Cada entrada do catálogo mostra para que serve o agente e o seu modelo predefin
 
 ## Adicionar um agente personalizado
 
-Os agentes personalizados são simples ficheiros Markdown no seu repositório, em `.claude/agents/`, com o nome `custom-<algo>.md`. O ficheiro contém as instruções do agente (o seu system prompt) e um pequeno cabeçalho de frontmatter que inclui um `model:` predefinido.
+Roles são assets nativos do provider: Claude usa
+`.claude/agents/custom-<nome>.md`; Kimi usa
+`.kimi-code/skills/custom-<nome>/SKILL.md`.
 
-Assim que o ficheiro existe no projeto, aparece no catálogo como agente personalizado, e pode adicionar o seu id à cadeia de agentes de qualquer perfil (e encaminhar tarefas para ele). O id tem de coincidir com o nome do ficheiro — uma entrada para `custom-docs` corresponde a `.claude/agents/custom-docs.md`.
+Quando o asset existe, aparece no catálogo desse provider e o seu id pode ser adicionado a um perfil do mesmo provider. `custom-docs` corresponde a `.claude/agents/custom-docs.md` em Claude ou `.kimi-code/skills/custom-docs/SKILL.md` em Kimi; ambos ficam separados.
 
 Como vivem no seu repositório, os agentes personalizados são **ativos de equipa que se podem committar**: faça commit do ficheiro e toda a equipa fica com o agente. Isto espelha a ideia central de toda a secção Agentes —
 
 > **As definições dos agentes são partilhadas (vivem no repositório e viajam com o `git`). A configuração dos modelos é por projeto (vive nos perfis).**
 
-O namespace `custom-*` é reservado e protegido: os comandos `init` e `update` do `specrails-core` nunca tocam em `.claude/agents/custom-*.md`, por isso os seus agentes personalizados sobrevivem intactos às atualizações do core. (A mesma proteção cobre fragmentos contribuídos por plugins, como o `custom-serena.md`.)
+Core protege ambos os formatos. Kimi permite criação/edição manual e execução;
+Generate, Test e AI Refine são recusados antes do spawn.
 
 ## Pôr um agente personalizado a trabalhar
 
 O fluxo típico:
 
-1. Escreva `.claude/agents/custom-<nome>.md` com instruções e um modelo predefinido.
+1. Crie o asset Claude ou Skill Kimi nativo com instruções/modelo válidos.
 2. Confirme que aparece em **Agentes → Catálogo** em Personalizados.
 3. Em **Agentes → Perfis**, adicione o agente à cadeia de um perfil (substituindo opcionalmente o seu modelo para esse perfil).
 4. Adicione uma regra de encaminhamento para que as tarefas com as tags certas cheguem até ele — ou confie na ordem da cadeia.

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

@@ -36,6 +36,7 @@ O specrails funciona com as principais CLIs de programação com IA:
 - **Claude** (Claude Code)
 - **Codex** (Codex CLI)
 - **Gemini** (Gemini CLI)
+- **Kimi** (Kimi Code)
 
 Escolha aquela que já usa — ou instale mais do que uma e escolha por tarefa. Um projeto pode correr num único fornecedor ou em vários ao mesmo tempo, por isso nunca fica preso a um só.
 

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

@@ -23,6 +23,7 @@ A única coisa que o specrails não consegue incluir é a própria **CLI do forn
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 Instale aquela que planeia usar, inicie sessão nela uma vez a partir do seu terminal, e está tudo a postos. O specrails deteta automaticamente quais os fornecedores presentes.
 

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

@@ -26,13 +26,13 @@ A barra lateral direita é o seu painel de comutação para o projeto atual. Pas
 
 - **Dashboard** — o quadro de specs e os rails (onde estava agora mesmo).
 - **Jobs** — todas as execuções do pipeline deste projeto, passadas e presentes, com estado, duração e a possibilidade de aprofundar o detalhe e os logs de qualquer execução.
-- **Analytics** — quanto lhe está a custar a utilização de IA. Gastos divididos por dia, por atividade, por modelo e por ticket — para que não haja surpresas.
-- **Agentes** — os perfis de agentes do seu projeto: que agentes correm no pipeline e que modelos de IA usam. *(Apenas projetos com Claude.)*
-- **Code** — um explorador de ficheiros só de leitura com resumos de IA em linguagem simples, e etiquetas a mostrar que ficheiros a IA tocou. Ótimo para quem não programa mas quer acompanhar.
+- **Analytics** — invocações por dia, atividade, modelo e ticket. Claude comunica custo faturado, Codex/Gemini usam estimativas e Kimi deixa vazios os campos de tokens/custo USD indisponíveis.
+- **Agentes** — perfis e catálogos de roles por provider para Claude e Kimi. Com Kimi, os roles são criados/editados manualmente; Generate, Test e AI Refine não estão disponíveis.
+- **Code** — um explorador de ficheiros só de leitura com etiquetas dos ficheiros tocados pela IA. Os resumos em linguagem simples só aparecem com providers compatíveis e não estão disponíveis com Kimi.
 - **Integrações** — extras opcionais, como ligar as suas specs a um quadro do **Jira** ou ativar ferramentas adicionais para a IA.
 - **Definições** — opções por projeto (telemetria, orçamentos, configuração de fornecedores e muito mais).
 
-> Algumas secções só aparecem quando fazem sentido para os fornecedores que escolheu — por exemplo, **Agentes** é específico do Claude. Se não vir uma secção, é simplesmente porque não se aplica à configuração deste projeto.
+> Secções e ações seguem as capacidades do provider efetivo. Por exemplo, os perfis funcionam com Claude e Kimi, mas as ações de IA do Agent Studio falham de forma fechada com Kimi.
 
 ## A barra de estado
 

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

@@ -1,16 +1,20 @@
-# Providers de IA (Claude, Codex, Gemini)
+# Providers de IA (Claude, Codex, Gemini, Kimi)
 
-O Specrails não está preso a uma única IA. Todas as partes da app que falam com uma IA — Explore Spec, spec rápida (Quick), rails, chat, AI Edit, o botão "Open AI CLI" do terminal — podem correr através de qualquer um dos três providers de primeira linha. Você escolhe quais é que cada projeto usa e pode até alternar tarefa a tarefa.
+O Specrails não está preso a uma única IA. Claude, Codex, Gemini e Kimi são
+providers de primeira linha; cada superfície mostra apenas motores com as
+capabilities exigidas pelo seu contrato.
 
-## Os três providers
+## Os quatro providers
 
 | Provider | CLI | Feito por | Notas |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | O mais completo. O único provider para Agentes (perfis) e rails Freestyle, e para o Contract Refine. |
+| **Claude** | `claude` | Anthropic | Custo nativo e transporte interativo persistente. |
 | **Codex** | `codex` | OpenAI | Requer codex `0.128.0+`. Lê os seus servidores MCP a partir do `~/.codex/config.toml` global. |
 | **Gemini** | `gemini` | Google | Requer gemini `0.11.0+`. Usa telemetria nativa e um ficheiro de instruções `GEMINI.md`. |
+| **Kimi Code** | `kimi` | Moonshot AI | Requer Kimi `0.27.0+`. O Desktop lança o CLI externo com `-p`; não instala nem inicia um servidor. |
 
-Os três estão **ativados por omissão**. Um provider aparece em **Adicionar Projeto** sempre que o seu CLI estiver instalado e no seu `PATH`. Por isso o primeiro passo é sempre o mesmo: instale o CLI que quer e autentique-se com ele, exatamente como a documentação dessa ferramenta descreve. Assim que `claude --version` (ou `codex`, ou `gemini`) funcionar no seu terminal, o Specrails consegue usá-lo.
+Os quatro estão **ativados por omissão**. O provider aparece quando o CLI está
+no `PATH`; para Kimi, confirme `kimi --version` e execute `kimi login`.
 
 ## Instalar um provider para um projeto
 
@@ -25,40 +29,46 @@ Pode instalar **mais do que um** provider no mesmo projeto — por exemplo Claud
 Algumas coisas que vale a pena saber sobre projetos multi-provider:
 
 - **Com um só provider, tudo se comporta exatamente como antes.** Se um projeto tiver apenas um provider, nunca verá um seletor de provider em lado nenhum — a app mantém-se limpa e simples.
-- **A barra lateral direita só mostra as secções que todos os providers instalados suportam.** Como os Agentes (perfis) são um conceito exclusivo do Claude, a secção **Agentes** desaparece assim que um projeto inclui qualquer provider que não seja Claude. Todo o resto (Specs, Código, Analytics, Integrações, Terminal, Chat) permanece.
+- **As capabilities controlam a UI.** Claude e Kimi suportam perfis separados
+  por provider; Codex e Gemini usam modo legacy.
 - **A escolha de providers fica fixada após a criação.** Nesta versão escolhe os seus providers quando adiciona o projeto e não podem ser alterados mais tarde nas Definições. Se precisar de uma combinação diferente, isso é um projeto novo.
 
 ## Escolher um provider a cada invocação
 
 A grande vantagem de um projeto multi-provider é poder escolher a IA certa para cada tarefa — sem mexer em nenhuma definição global. Sempre que uma IA corre, aparece um pequeno seletor de provider (apenas quando o projeto tem mais do que um):
 
-- **Adicionar Spec** — um seletor de motor permite-lhe Explorar ou gerar rapidamente (Quick) uma spec com o provider que preferir.
+- **Adicionar Spec** — Explore suporta Kimi; Quick Spec mostra apenas
+  providers com um limite pure-output seguro e exclui Kimi.
 - **Cabeçalho do rail** — escolha o motor para esse rail específico antes de o lançar.
 - **Terminal** — o botão "Open AI CLI" (Sparkles) abre um menu de providers para que possa entrar em qualquer CLI instalado na diretoria desse projeto.
 
 A sua escolha é guardada por projeto, predefinida para o provider primário, para que não tenha de a repetir de cada vez.
 
-## O que só o Claude consegue fazer
+## Diferenças de capability
 
-Algumas funcionalidades são, por natureza, específicas do Claude, por isso ficam escondidas ou são ignoradas quando outro provider está em jogo:
+Kimi suporta Project/Agent Chat, Explore/propostas, Quick Launcher
+(`/opsx:ff`), rails, Freestyle, loops sem Decider, perfis/roles manuais, MCP,
+Serena, terminal e anexos.
 
-- **Agentes (perfis)** — o catálogo de agentes por projeto e o roteamento de modelos. Escondido em qualquer projeto que inclua um provider que não seja Claude.
-- **Rails Freestyle** — correm sempre no Claude.
-- **Contract Refine** — a passagem extra de "Contract Layer" sobre uma spec confirmada só corre quando o provider da conversa é o Claude.
-- **Modos avançados de Adicionar Spec** (SMASH / Contract Layer) — escondidos para motores que não sejam Claude.
-
-Todo o resto — Explore, spec rápida (Quick), o pipeline completo de rails, AI Edit, chat, analytics de custos — funciona nos três.
+`kimi -p` aprova ferramentas automaticamente e não consegue impor um limite
+no-tools/read-only. São recusados antes do spawn: Quick Spec, AI Edit,
+Contract Refine, SMASH/Re-SMASH, geração de blueprint/milestone no Project
+Builder, Loop Decider, resumos/construction story e automação do Agent Studio.
+Auto-title usa um fallback determinístico. Consulte o
+[guia Kimi](../../../kimi.md).
 
 ## Acompanhamento de custos entre providers
 
-A página **Analytics** acompanha cada invocação faturável, independentemente do provider. Em projetos multi-provider acrescenta chips de filtro por motor para que possa comparar o gasto por provider. O Claude reporta o seu próprio custo exato; para o Codex e o Gemini, o Specrails estima o custo a partir de uma tabela de preços incorporada, por isso os valores são aproximações próximas e não montantes faturados.
+**Analytics** regista invocações realmente iniciadas. Claude reporta custo;
+Codex/Gemini usam estimativas. Kimi não reporta tokens ou custo USD
+autoritativos, portanto os campos ficam vazios.
 
 ## Resolução de problemas
 
-- **Um provider que instalei não aparece.** Confirme que o CLI está no seu `PATH` (experimente `claude --version` / `codex --version` / `gemini --version` num terminal novo). A app sonda os CLIs dos providers através do `PATH` do seu sistema.
+- **Um provider que instalei não aparece.** Confirme `claude --version` / `codex --version` / `gemini --version` / `kimi --version`.
 - **Os servidores MCP do Codex não carregam no chat.** O Codex lê os servidores MCP a partir do `~/.codex/config.toml` global — registe-os aí com `codex mcp add`.
 - **Desativar em emergência.** Um provider pode ser desligado em toda a app através de uma variável de ambiente (`SPECRAILS_CODEX_BETA=0` ou `SPECRAILS_GEMINI_BETA=0`). Isto só esconde o provider da *seleção*; raramente é necessário.
 
 ## Ver também
 
-Os guias dedicados a cada provider aprofundam cada CLI: o guia do Codex e o guia do Gemini cobrem cada um a configuração, o que funciona e as particularidades específicas de cada provider.
+Consulte os guias dedicados a [Kimi](../../../kimi.md), Codex e Gemini.

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

@@ -21,7 +21,7 @@ O plugin de destaque é:
 3. Clique no plugin para **pré-visualizar a instalação** — isto mostra-lhe exatamente que ficheiros vão mudar antes de qualquer coisa acontecer.
 4. Clique em **Instalar**. Verá o progresso em tempo real à medida que tudo é configurado.
 
-Nos bastidores, a instalação é *cirúrgica e aditiva*: só acrescenta as suas próprias entradas ao `.mcp.json` do seu projeto (e, para alguns plugins, um ficheiro de fragmento no namespace protegido `.claude/agents/`). Nunca reescreve a sua configuração por inteiro, e adicionar um segundo plugin nunca pode perturbar o primeiro. Se a instalação não conseguir verificar-se como saudável, é revertida de forma limpa.
+Nos bastidores, a instalação é *cirúrgica e aditiva*: só acrescenta entradas à configuração MCP nativa do provider escolhido (e, em algumas instalações Claude, um fragmento em `.claude/agents/`). Nunca reescreve toda a configuração e faz rollback limpo se a verificação falhar.
 
 ## Gerir plugins instalados
 
@@ -37,8 +37,8 @@ Nos bastidores, a instalação é *cirúrgica e aditiva*: só acrescenta as suas
 
 ## Notas sobre providers
 
-Os plugins têm consciência do provider. O Serena e plugins MCP semelhantes resolvem-se para providers que registam MCP através do `.mcp.json` do projeto (Claude e Gemini). Para projetos Codex, os servidores MCP são geridos através da própria configuração global do Codex, por isso as entradas de plugins em **Integrações** são filtradas em conformidade. O cartão do Jira em Integrações é agnóstico ao provider e aparece para toda a gente — consulte o guia do Jira.
+Os plugins têm consciência do provider. O Serena suporta Claude via `.mcp.json`, Codex via `codex mcp add` com `CODEX_HOME` isolado por projeto e Kimi via `.kimi-code/mcp.json`. Um plugin só aparece se o manifesto declarar o provider; por isso Serena não é oferecido para Gemini. O cartão Jira é agnóstico ao provider.
 
 ## Ficheiros reservados
 
-Os plugins gerem um conjunto pequeno e bem definido de ficheiros no seu projeto: o seu `.mcp.json` (fundido cirurgicamente), algum estado em `.specrails/plugins/` e fragmentos de agente por plugin em `.claude/agents/custom-<plugin>.md`. Estes são ativos de equipa que pode versionar se quiser partilhar uma integração com os seus colegas — a app nunca os sobrescreve às cegas.
+Os plugins gerem a configuração MCP nativa do provider, estado em `.specrails/plugins/` e, apenas quando Claude precisa, fragmentos em `.claude/agents/custom-<plugin>.md`. As entradas Kimi ficam em `.kimi-code/mcp.json`; a app não escreve fragmentos exclusivos de Claude para Kimi nem sobrescreve configurações às cegas.

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

@@ -22,7 +22,13 @@ Escolher um projeto aqui **não** move o seu painel — o alvo do agente e o que
 
 ## 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.
+Logo acima da caixa de mensagem escolhe o **provider** (Claude, Codex, Gemini
+ou Kimi) e o seu **modelo**. Trocar de provider inicia uma sessão separada.
+
+Com Kimi, os níveis limitam as ferramentas MCP Specrails, mas não transformam
+`kimi -p` numa sandbox: ferramentas nativas são aprovadas automaticamente.
+Ações pure-output inseguras são recusadas antes do spawn; consulte a
+[matriz Kimi](../../../kimi.md).
 
 ## Níveis de permissão — a rédea está com você
 

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

@@ -35,8 +35,8 @@ Você pode ter vários rails para organizar o trabalho em pistas nomeadas (uma p
 | **Pílula de status** | `idle`, `running` ou `failed`. Não há um "completed" separado — um rail volta para `idle` quando seu job termina sem erros. |
 | **Lista de specs** | Os IDs atribuídos a este rail. Arraste mais para dentro, arraste para fora para desanexar. |
 | **Seletor de Loop** | O Loop que este rail roda — um embutido (`Implement` / `Batch` / `Freestyle`) ou um loop personalizado. Veja a tabela abaixo. Persistido por rail. |
-| **Seletor de perfil** | Qual perfil de agente roda (apenas rails Claude). Só aparece quando o projeto tem ao menos um perfil. |
-| **Seletor de motor** | Qual provedor instalado roda este rail — Claude, Codex ou Gemini. Só é renderizado quando o projeto tem mais de um provedor. Veja [Escolhendo um motor por rail](picking-an-engine-per-rail). |
+| **Seletor de perfil** | Qual perfil do provider corre (rails Claude e Kimi). |
+| **Seletor de motor** | Qual provider corre o rail — Claude, Codex, Gemini ou Kimi. |
 | **▶ Play / ■ Stop** | Iniciar ou cancelar. |
 
 ### O que um rail roda: Loops
@@ -47,9 +47,11 @@ Um rail roda um **Loop** — a receita do trabalho. Três loops são **embutidos
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Um job cobrindo todas as specs do rail. Roda o pipeline completo Architect → Developer → Reviewer → Ship. O padrão do dia a dia. |
 | **Batch** | `/specrails:batch-implement` | Um job que percorre as specs do rail sequencialmente, em ondas que respeitam as dependências. Melhor para várias specs relacionadas. |
-| **Freestyle** | Freestyle | O Claude implementa cada spec de forma autônoma, **ignorando** o pipeline. Um job independente por spec. Apenas Claude. |
+| **Freestyle** | Freestyle | Claude ou Kimi implementa cada spec de forma autónoma, **ignorando** o pipeline. |
 
-O Freestyle é o caso atípico: ele pula a cadeia de agentes e entrega a spec crua ao Claude para trabalhar com suas ferramentas nativas. É aberto, então apertar Play abre primeiro uma confirmação, e um seletor de modelo por rail deixa você escolher Haiku / Sonnet / Opus. Ele só aparece quando o motor do rail é o Claude. Uma execução Freestyle é também o único job que **fica aberto esperando por você**: converse com ele pelo compositor do detalhe do job e clique em **Finalize** quando estiver satisfeito (todos os outros jobs terminam sozinhos).
+Freestyle usa ferramentas e modelos nativos do provider. Claude tem transport
+interativo persistente; Kimi usa um processo agentic `kimi -p` sem stdin
+persistente.
 
 Além dos embutidos, você pode **construir seus próprios loops** — repetir um ciclo verify → fix → verify até atingir uma meta, encadear comandos de shell entre AI Steps e muito mais. Esses loops personalizados aparecem no mesmo seletor de Loop. Essa é a próxima grande ideia: [O Loop Builder](the-loop-builder).
 
@@ -81,7 +83,8 @@ Clique em **■ Stop** no cabeçalho do rail. A app envia `SIGTERM` ao subproces
 
 ## Se um rail não lançar
 
-Se você escolher um motor cuja CLI não está instalada na sua máquina, o lançamento **falha rápido** em vez de iniciar um job quebrado — nada é spawnado. Instale a CLI do provedor que falta ([Usando Codex](../integrations/using-codex), [Usando Gemini](../integrations/using-gemini)) e lance de novo. Claude ou Codex ausentes dão uma mensagem precisa "*<provider> CLI not found*"; o Gemini ausente exibe um erro genérico de lançamento por enquanto, mas o resultado é o mesmo.
+Se faltar o CLI escolhido, o lançamento falha antes do spawn. Para Kimi,
+instale/autentique `kimi` 0.27+; Desktop não inicia um server.
 
 ## Parando tudo
 
@@ -96,4 +99,4 @@ Se algo parecer errado:
 - [O Loop Builder](the-loop-builder) — o que um rail roda, e como construir seus próprios loops.
 - [A vista de detalhe do job](the-job-detail-view) — fases, métricas ao vivo, cartões de ticket.
 - [Batch implement e multi-feature](batch-implement-and-multi-feature) — rode várias specs de uma vez.
-- [Escolhendo um motor por rail](picking-an-engine-per-rail) — Claude vs Codex vs Gemini.
+- [Escolhendo um motor por rail](picking-an-engine-per-rail) — Claude, Codex, Gemini ou Kimi.