specrails-desktop 2.58.1 → 2.59.0

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

@@ -1,69 +1 @@
-# AI プロバイダー（Claude、Codex、Gemini、Kimi）
-
-Specrails は特定の AI に縛られません。Claude、Codex、Gemini、Kimi
-はファーストクラスのプロバイダーで、各画面には必要な capability
-を満たすエンジンだけが表示されます。
-
-## 4 つのプロバイダー
-
-| プロバイダー | CLI | 提供元 | 備考 |
-|---|---|---|---|
-| **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 をインストール・起動しません。 |
-
-4 つとも**デフォルトで有効**です。CLI が `PATH` にあれば表示されます。
-Kimi は `kimi --version` を確認し、`kimi login` を実行してください。
-
-## プロバイダーは自動検出されます
-
-プロジェクトごとにプロバイダーを選ぶことはもうありません。specrails はマシンにインストールされたすべてのプロバイダー CLI を検出し、**すべて**のプロジェクトで常に**全部**を利用できるようにします。その上で各サーフェスがプロバイダーの公表するケイパビリティを確認します。Kimi の正確なマトリクスは[Kimi を使う](../../../kimi.md)を参照してください。
-
-使いたいプロバイダーがどこにも現れない場合、ほぼ確実に CLI が未インストールか `PATH` にないためです。インストールしてログインし、アプリに戻ってください — ウィンドウのフォーカス時に検出が再実行され、プロバイダーは自動であらゆる場所に現れ、その workspace サーフェスもバックグラウンドで組み立てられます。インストール済みでも未ログインのプロバイダーは、エンジンセレクターに*未ログイン*バッジ付きで表示されます。
-
-複数プロバイダーのマシンについて知っておくと良いこと：
-
-- **プロバイダーが 1 つだけなら挙動は以前とまったく同じです。** 1 つしか検出されなければ、プロバイダーピッカーはどこにも表示されません — アプリはすっきりシンプルなままです。
-- **ケイパビリティがサイドバーを決めます。** 検出済みプロバイダーの少なくとも 1 つが対応していればセクションは表示され、その中のエンジン関連の操作は対応プロバイダーだけを提示します。Kimi はプロファイル、カスタムロール、Freestyle を公表しますが、強制可能なノーツール境界を要する構造化アクションは公表しません。
-- **何もロックされません。** プロバイダー CLI の追加や削除はすべてのプロジェクトに自動反映されます — 管理すべきプロジェクトごとのプロバイダー設定は存在しません。
-
-## 呼び出しごとにプロバイダーを選ぶ
-
-マルチプロバイダーのプロジェクトの真価は、グローバル設定を一切変えずに、タスクごとに最適な AI を選べることにあります。AI が動くところには、小さなプロバイダー選択 UI が現れます（プロジェクトに複数のプロバイダーがあるときだけです）。
-
-- **Add Spec** — Explore は Kimi に対応します。Quick Spec は安全な
-  pure-output 境界を持つプロバイダーだけを表示するため、Kimi は除外されます。
-- **レールのヘッダー** — その特定のレールを起動する前に、使うエンジンを選べます。
-- **ターミナル** — 「Open AI CLI」（Sparkles）ボタンを押すとプロバイダーメニューが開き、そのプロジェクトのディレクトリで任意のインストール済み CLI に入れます。
-
-選んだエンジンはプロジェクトごとに記憶され、デフォルトはプライマリプロバイダーです。毎回選び直す必要はありません。
-
-## Capability の違い
-
-Kimi は Project/Agent Chat、Explore/proposal、Quick Launcher
-(`/opsx:ff`)、rail、Freestyle、Decider のない loop、profile/手動 role、
-MCP、Serena、terminal、attachment に対応します。
-
-`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** は実際に起動した invocation を記録します。Claude は
-cost を報告し、Codex/Gemini は推定値です。Kimi は authoritative な
-token/USD cost を報告しないため、その項目は空欄です。
-
-## トラブルシューティング
-
-- **インストールしたプロバイダーが表示されない。** `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`）でアプリ全体から無効にできます。これはプロバイダーを*選択肢*から隠すだけで、めったに必要にはなりません。
-
-## 関連項目
-
-[Kimi guide](../../../kimi.md)、Codex guide、Gemini guide を参照してください。
+# AI プロバイダー（Claude、Codex、、）

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

@@ -34,11 +34,3 @@
 - **レール。** レールが走る前に、Specrails はどのプラグインがインストールされていて正常かを確認し、そのジョブのエージェントにそれらのツールを利用可能にします。劣化したプラグインはその実行ではスキップされるだけで、レールは通常どおり起動します。各ジョブは、どのプラグインが有効だったかのスナップショットを記録し、ジョブの診断エクスポートで確認できます。
 - **チャット。** チャットはプロジェクトの MCP 設定を自動的に取り込むので、インストール済みのプラグインはそこでも利用できます。
 - **セットアップ。** プロジェクトのセットアップ中はプラグインは無視されます — プロジェクトの準備が整ってから登場します。
-
-## プロバイダーに関する注意
-
-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 非依存です。
-
-## 予約ファイル
-
-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/5-mcp-server.md

@@ -1,6 +1,6 @@
 # 任意の AI から Specrails を操作する（MCP サーバー）
 
-> **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude, Codex, Kimi and Gemini. It includes verified bridge discovery, registration and read-only checks.
+> **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude and Codex. It includes verified bridge discovery, registration and read-only checks.
 
 Specrails は、[Model Context Protocol](https://modelcontextprotocol.io) を話す任意の AI アシスタント（Claude Desktop、Claude Code、Cursor、Cline、あるいは自作のエージェント）に対して、**自分自身**を公開できます。これをオンにしてアシスタントを Specrails に向ければ、チャットするだけでアプリ全体を操作できます。たとえば *「プロジェクト一覧を見せて」「API プロジェクトにソーシャルログインのスペックを作って」「レール 0 を起動して、終わったら教えて」「今週はいくら使った？」* といった具合です。あなたがあちこちクリックする代わりに、アシスタントが裏側で Specrails のツールを呼び出します。
 
@@ -33,19 +33,6 @@ Claude Desktop や Cursor のようなクライアントでは、設定は次の
 
 リモートの HTTP MCP サーバーに対応しているクライアントなら、代わりにパネルのトークンを使って `http://127.0.0.1:4200/api/mcp` を直接指すこともできます。
 
-### ターミナルから: Claude Code、Gemini CLI、Codex CLI
-
-**設定 ▸ MCP ▸ トークンをコピー** からトークンをコピーして、次を実行します:
-
-```bash
-# Claude Code
-claude mcp add --transport http specrails http://localhost:4200/api/mcp \
-  --header "X-Desktop-Token: <あなたのトークン>"
-
-# Gemini CLI
-gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
-  --header "X-Desktop-Token: <あなたのトークン>"
-
 # Codex CLI (stdio — 設定 ▸ MCP に表示されるブリッジコマンドを登録)
 codex mcp add specrails -- <設定 ▸ MCP のブリッジコマンド>
 ```

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

@@ -20,16 +20,6 @@ Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプ
 
 ここでプロジェクトを選んでも、あなたのダッシュボードは**動きません**——エージェントの対象と、あなたが見ているものは互いに独立しています。
 
-## プロバイダーとモデル
-
-メッセージ欄のすぐ上で、**プロバイダー**（Claude、Codex、Gemini、
-Kimi）とその**モデル**を選びます。切り替えると別 session が開始します。
-
-Kimi では level は Specrails MCP tool を制限しますが、`kimi -p` 自体を
-sandbox にはしません。native tool は自動承認されます。安全でない
-pure-output action は spawn 前に拒否されます。詳細は
-[Kimi matrix](../../../kimi.md) を参照してください。
-
 ## 権限レベル——手綱はあなたが握る
 
 エージェントはアプリ全体に触れられるので、どこまで自由を与えるかはあなたが決めます。**Shift+Tab** を押してその場で切り替える**レベル**でコントロールします（Claude Code が使うのと同じ循環です）。各レベルはその下のすべてを含みます。

package/docs/guide/ja/integrations/7-local-engines.md

@@ -24,10 +24,6 @@
 
 > ミッションにはサーバー側に**大きなコンテキストウィンドウ**（64k トークン以上）が必要です。オペレータープロンプトと Specrails ツールのスキーマは大きいためです。チャットと Explore は 32k で十分です。ターンが *exceeds the available context size* で失敗する場合は、ウィンドウを拡大してください（Ollama `OLLAMA_CONTEXT_LENGTH`、llama.cpp `-c`、LM Studio *Context Length*）。
 
-## ローカルエンジンしかない場合は？
-
-設定は不要です。Specrails はマシンが実際に実行できるエンジンだけを提示し、既定値はどこでも同じ規則で選びます。インストール済み CLI（Claude → Codex → Gemini → Kimi）、なければエンドポイントが応答する最初のローカルエンジンです。ローカルエンドポイントしかないマシンでは、レール、Add Spec、チャット、**エージェントのミッションと Project Builder** がそのままそのエンジンで始まり、セレクターに触れる必要はありません。サーバーが停止しているエンジンは、再び応答するまで提示されません。既存のミッションは作成時のエンジンを保持し、セレクターで切り替えることもできます。
-
 ## モデルの選び方
 
 品質は Specrails ではなくモデル次第です。レールには 30B パラメータ以上のツール呼び出し対応コーダーモデルを使ってください。小さな instruct モデルはチャット、Explore、Quick スペックには十分です。新しいモデルに implement レール全体を任せる前に、**Freestyle** か Explore セッションで試してください。

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

@@ -35,8 +35,6 @@ SpecsBoard（左）            レール（右）
 | **ステータスピル** | `idle`、`running`、`failed` のいずれか。「completed」という別ステータスはありません — ジョブがきれいに完了すると、レールは `idle` に戻ります。 |
 | **スペック一覧** | このレールに割り当てられた ID。さらにドラッグして追加したり、ドラッグして外したりできます。 |
 | **Loop ピッカー** | このレールが実行する Loop — 組み込み（`Implement` / `Freestyle` / `SDD Quick (OpenSpec)`）かカスタム Loop。下の表を参照してください。レールごとに保持されます。 |
-| **プロファイルピッカー** | 実行する provider profile（Claude/Kimi rail）。 |
-| **エンジンセレクター** | rail を実行する provider — Claude、Codex、Gemini、Kimi。 |
 | **▶ Play / ■ Stop** | 開始またはキャンセル。 |
 
 ### レールが実行するもの: Loop
@@ -46,14 +44,9 @@ SpecsBoard（左）            レール（右）
 | 組み込み Loop | コマンド | 役割 |
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | レール上のすべてのスペックをまとめた 1 つのジョブ。Architect → Developer → Reviewer → Ship のフルパイプラインを実行します。日常的に使うデフォルトです。 |
-| **Freestyle** | Freestyle | Claude または Kimi が pipeline を**バイパス**して自律的に実装します。 |
 
 複数のスペックを実行するには、関連するもの（最大 3 件）を 1 本のレールに載せる（`Implement` がまとめて 1 つのジョブとして実行します）か、独立したスペックを複数のレールに分けます。git 管理のレールはそれぞれ専用の分離された worktree で並行して動きます。
 
-Freestyle は provider の native tool/model を使います。Claude は
-persistent interactive transport、Kimi は persistent stdin のない agentic
-`kimi -p` process を使います。
-
 組み込み Loop も編集できます。Loop Builder で編集して公開すると、それを選んでいるすべてのレールがあなたのバージョンを実行します（戻すには **元に戻す** を使います）。
 
 組み込みのほかにも、**自分だけの Loop を作る** ことができます — verify → fix → verify のサイクルを目標が達成されるまで繰り返したり、AI ステップの間にシェルコマンドを連ねたり、さらにいろいろなことができます。そうしたカスタム Loop は同じ Loop ピッカーに表示されます。それが次の大きなアイデア、[Loop Builder](the-loop-builder) です。
@@ -84,11 +77,6 @@ git のないプロジェクトでは worktree 隔離も PR 継続も使えま
 
 レールヘッダーの **■ Stop** をクリックします。アプリはサブプロセスに `SIGTERM` を送り、**5 秒間** クリーンな終了を待ってから `SIGKILL` します。中途半端に生成されたものが残ることはありません。
 
-## レールが起動しないとき
-
-選択した CLI がなければ spawn 前に失敗します。Kimi は `kimi`
-0.27+ を install/login してください。Desktop は server を起動しません。
-
 ## すべてを止める
 
 何かおかしいと感じたら、
@@ -101,4 +89,3 @@ git のないプロジェクトでは worktree 隔離も PR 継続も使えま
 
 - [Loop Builder](the-loop-builder) — レールが実行するもの、そして自分だけの Loop を作る方法。
 - [ジョブ詳細ビュー](the-job-detail-view) — フェーズ、ライブメトリクス、チケットカード。
-- [レールごとのエンジン選択](picking-an-engine-per-rail) — Claude / Codex / Gemini / Kimi。

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

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

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

@@ -1,9 +1,5 @@
 # レールごとのエンジン選択
 
-Specrails desktop は **Claude Code**、**Codex CLI**、**Gemini CLI**、
-**Kimi Code** を一級の engine として扱います。compatible な組み合わせを
-install できます。
-
 ## セレクターが現れるとき
 
 **エンジンセレクター** はレールヘッダーの、モードコントロールのすぐ隣にあります。プロジェクトに **複数の** プロバイダーがインストールされているときだけ表示されます。
@@ -14,10 +10,6 @@ install できます。
 
 ## エンジンの選び方
 
-1. レールのエンジンセレクターが表示されていることを確認します（プロジェクトにプロバイダーが 2 つ以上）。
-2. **Claude**、**Codex**、**Gemini**、**Kimi** を選びます。
-3. **▶ Play** でレールを起動します。
-
 選んだエンジンが、そのレールのパイプラインの全フェーズを実行します。選んだエンジンの CLI がインストールされていない場合、起動は即座に失敗します — 何も生成されません。足りない CLI をインストールして、もう一度試してください。
 
 ## それぞれのエンジンが得意なこと
@@ -28,34 +20,21 @@ install できます。
 |--------|--------------------|-------|
 | **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、Freestyle、Decider のない loop に agentic Kimi を使う。 | 外部 `kimi` ≥ 0.27.0。Profile/role、effort は K3 のみ。token/cost は unavailable。 |
-
-### Capability の違い
-
-Claude/Kimi は Profile と Freestyle、Codex/Gemini は legacy。Kimi は
-Loop Decider と [Kimi guide](../../../kimi.md) の pure-output transform
-を拒否します。Claude/Kimi Profile は分離されます。
 
 ## 実用的なワークフロー
 
 複数プロバイダーのプロジェクトは、**比較** や **コスト調整** をしたいときに真価を発揮します。
 
 - **実装を比較する。** 同じスペックを 2 つのレールに乗せ、一方を Claude、もう一方を Codex に設定して両方を起動し（プロジェクトをまたいで、あるいは同じプロジェクトのキューで一つずつ）、ジョブページの **比較** ボタンで結果を差分表示します。
-- **スペック単位でコスト調整する。** 重要なスペックは `max` プロファイルの Claude で、日常的なクリーンアップ系のスペックは Gemini で実行して支出を抑えます。`/analytics` をエンジンで絞り込めば、内訳が見られます。
 - **賢くデフォルトを決める。** 一番よく使うエンジンをプロジェクトの主エンジンに設定してレールがそれを既定にするようにし、特定のスペックが別のエンジンを必要とするときだけレールごとに切り替えます。
 
 ## 覚えておきたいこと
 
 - **プロバイダーの選択はプロジェクト作成後は変更できません**（v1）。インストールするプロバイダーはプロジェクトを追加するときに選びます。あとから追加・削除する設定トグルはありません。
-- **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

@@ -26,7 +26,6 @@
 
 - Loop は **Loops** セクション（左サイドバー、プロジェクトの隣）にあります — これらは **グローバル** で、すべてのプロジェクトで共有されます。
 - レールはヘッダー（Loop ピッカー）で **Loop を選び**、Play を押すとそれを実行します。
-- provider、model、compatible effort は **rail** が決めます。compatible な Loop は Claude、Codex、Gemini、Kimi で実行できます。
 
 つまり、Loop を一度作ってしまえば、どのプロジェクトのどのレールでもそれを選べます。
 
@@ -50,10 +49,6 @@ 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 の中では、次のものを参照できます。
@@ -70,7 +65,6 @@ AI Step や Decider の中では、次のものを参照できます。
 |-------|--------------|
 | **Max iterations** | Decider が判断にかかわらずループバックできる回数のハードキャップ。 |
 | **Timeout (min)** | 実行全体に対する実時間（壁時計）の上限。 |
-| **Max cost ($)** | *任意。* Claude は cost、Codex/Gemini は estimate。Kimi は authoritative USD cost を報告しません。 |
 
 ## 自信を持って組み立てる
 

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

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

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

@@ -35,14 +35,6 @@ A seleção do perfil acontece mesmo onde lança — no **cabeçalho do rail**,
 
 É todo o fluxo: escolha um perfil, lance, pronto. Rails concorrentes no mesmo batch podem levar cada um o seu próprio perfil, por isso uma correção rápida e uma funcionalidade pesada podem correr lado a lado com configurações diferentes.
 
-## Quando a secção Agentes está silenciosa
-
-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
 
 - [Personalizar modelos por agente](customizing-models-per-agent) — construa perfis `fast` e `max`.

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

@@ -11,29 +11,14 @@ Cada entrada do catálogo mostra para que serve o agente e o seu modelo predefin
 
 ## Adicionar um agente personalizado
 
-Roles são assets nativos do provider: Claude usa
-`.claude/agents/custom-<nome>.md`; Kimi usa
-`.kimi-code/skills/custom-<nome>/SKILL.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).**
 
-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. 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.
-5. Lance um rail com esse perfil a partir do cabeçalho do rail.
-
 ## Acompanhar o desempenho dos perfis
 
 A secção Agentes tem também um separador **Utilização** — uma análise por perfil de quantos jobs correram sob cada perfil numa janela selecionada. É uma forma rápida de confirmar que a sua divisão `fast`/`max` está mesmo a ser usada como pretendia, e de detetar para que perfil a sua equipa tende a gravitar.

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

@@ -35,8 +35,6 @@ 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

@@ -22,8 +22,6 @@ 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/3-adding-your-first-project.md

@@ -20,10 +20,6 @@ Um rótulo amigável mostrado na barra lateral. Se deixar em branco, o specrails
 
 É todo o formulário — clique em **Adicionar** e está feito.
 
-## Os fornecedores de IA são detetados automaticamente
-
-Já não escolhe fornecedores. O specrails deteta cada CLI de IA instalado na sua máquina — **Claude**, **Codex**, **Gemini**, **Kimi** — e todos os projetos podem usá-los todos, sempre. Se instalar um fornecedor novo mais tarde, ele aparece em todo o lado por si próprio na próxima vez que focar a app; sem reconfiguração, sem ajustes por projeto. Se um fornecedor estiver instalado mas sem sessão iniciada, o seu seletor mostra um distintivo subtil *Sem sessão iniciada*.
-
 ## A configuração acontece em silêncio
 
 Não há assistente de configuração. No momento em que clica em **Adicionar**, o projeto fica registado e aparece na barra lateral — pode abri-lo de imediato. Em segundo plano, o specrails monta o workspace do projeto (poucos segundos, totalmente offline): um pequeno ponto a pulsar na linha do projeto mostra que está a trabalhar, e desaparece quando tudo está pronto. Se algo falhar para um fornecedor, o projeto continua a funcionar com os restantes — aparece um ponto âmbar e clicar nele tenta de novo.

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

@@ -26,14 +26,9 @@ 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** — 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).
 
-> 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
 
 Uma faixa fina percorre o fundo da janela. É pequena, mas prática:

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

@@ -1,28 +1,14 @@
-# Providers de IA (Claude, Codex, Gemini, Kimi)
+# Providers de IA (Claude, Codex)
 
-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 quatro providers
+## Os dois providers
 
 | Provider | CLI | Feito por | Notas |
 |---|---|---|---|
 | **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 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`.
 
 ## Os providers são detetados automaticamente
 
-Nunca escolhes providers por projeto. O specrails deteta cada CLI de provider
-instalado na tua máquina e disponibiliza **todos** a **todos** os projetos,
-sempre. Cada superfície verifica depois as capacidades anunciadas pelo
-provider. Vê [Usar o Kimi](../../../kimi.md) para a matriz exata do Kimi.
-
 Se um provider que queres não aparece em lado nenhum, é quase sempre porque o
 CLI não está instalado ou não está no teu `PATH`. Instala-o, inicia sessão e
 volta à app — a deteção corre de novo ao focar a janela e o provider aparece
@@ -33,11 +19,6 @@ aparecer, com um distintivo *Sem sessão iniciada* nos seletores de motor.
 Algumas coisas úteis sobre máquinas multi-provider:
 
 - **Um único provider comporta-se exatamente como antes.** Se só um for detetado, nunca verás um seletor de provider — a app mantém-se limpa e simples.
-- **As capabilities comandam a barra lateral.** Uma secção é visível quando pelo
-  menos um provider detetado a suporta; lá dentro, as ações por motor só
-  oferecem os providers capazes. O Kimi anuncia perfis, roles personalizados e
-  Freestyle; não anuncia ações estruturadas que exijam uma fronteira sem
-  ferramentas aplicável.
 - **Nada fica bloqueado.** Instalar ou remover um CLI de provider atualiza todos
   os projetos automaticamente — não há definição de provider por projeto para gerir.
 
@@ -45,38 +26,11 @@ Algumas coisas úteis sobre máquinas multi-provider:
 
 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** — 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.
 
-## Diferenças de capability
-
-Kimi suporta Project/Agent Chat, Explore/propostas, Quick Launcher
-(`/opsx:ff`), rails, Freestyle, loops sem Decider, perfis/roles manuais, MCP,
-Serena, terminal e anexos.
-
-`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
-
-**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 `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
-
-Consulte os guias dedicados a [Kimi](../../../kimi.md), Codex e Gemini.

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

@@ -34,11 +34,3 @@ Nos bastidores, a instalação é *cirúrgica e aditiva*: só acrescenta entrada
 - **Rails.** Antes de um rail correr, o Specrails verifica quais os plugins instalados e saudáveis e disponibiliza essas ferramentas ao agente para esse trabalho. Um plugin degradado é simplesmente ignorado nessa execução — o rail é lançado normalmente. Cada trabalho regista um instantâneo de quais os plugins que estavam ativos, que pode consultar na exportação de diagnóstico do trabalho.
 - **Chat.** O chat recolhe automaticamente a configuração MCP do seu projeto, por isso os plugins instalados também ficam disponíveis aí.
 - **Configuração.** Os plugins são ignorados enquanto um projeto ainda está a ser configurado — entram em ação assim que o projeto fica pronto.
-
-## Notas sobre providers
-
-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 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/5-mcp-server.md

@@ -1,6 +1,6 @@
 # Controlar o Specrails a partir de qualquer IA (servidor MCP)
 
-> **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude, Codex, Kimi and Gemini. It includes verified bridge discovery, registration and read-only checks.
+> **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude and Codex. It includes verified bridge discovery, registration and read-only checks.
 
 O Specrails pode expor-se **a si próprio** a qualquer assistente de IA que fale o [Model Context Protocol](https://modelcontextprotocol.io) — Claude Desktop, Claude Code, Cursor, Cline ou o seu próprio agente. Ative-o, aponte o seu assistente para o Specrails e poderá conduzir a app inteira conversando: *"lista os meus projetos", "cria uma spec para login social no projeto da API", "lança o rail 0 e avisa-me quando terminar", "quanto gastei esta semana?"*. O seu assistente invoca as ferramentas do Specrails nos bastidores em vez de ser você a clicar por toda a parte.
 
@@ -33,19 +33,6 @@ Num cliente como o Claude Desktop ou o Cursor, a configuração tem este aspeto:
 
 Os clientes que suportam servidores MCP HTTP remotos podem, em alternativa, apontar diretamente para `http://127.0.0.1:4200/api/mcp` com o token do painel.
 
-### Pelo terminal: Claude Code, Gemini CLI, Codex CLI
-
-Copie seu token em **Configurações ▸ MCP ▸ Copiar token** e depois:
-
-```bash
-# Claude Code
-claude mcp add --transport http specrails http://localhost:4200/api/mcp \
-  --header "X-Desktop-Token: <seu token>"
-
-# Gemini CLI
-gemini mcp add --transport http specrails http://localhost:4200/api/mcp \
-  --header "X-Desktop-Token: <seu token>"
-
 # Codex CLI (stdio — registre o comando do bridge mostrado em Configurações ▸ MCP)
 codex mcp add specrails -- <comando do bridge de Configurações ▸ MCP>
 ```

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

@@ -20,16 +20,6 @@ O cabeçalho tem um **seletor de projeto** (como o do Cursor). Escolha um projet
 
 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 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ê
 
 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:

package/docs/guide/pt/integrations/7-local-engines.md

@@ -24,10 +24,6 @@ Indisponível em motores locais: perfis de agente e papéis personalizados, enri
 
 > Missões precisam de uma **janela de contexto grande** no servidor (64k tokens ou mais): o prompt do operador mais os schemas de ferramentas do Specrails são grandes. Chat e Explore funcionam bem com 32k. Se um turno falhar com *exceeds the available context size*, aumente a janela (Ollama `OLLAMA_CONTEXT_LENGTH`, llama.cpp `-c`, LM Studio *Context Length*).
 
-## Só tem um motor local?
-
-Nada a configurar. O Specrails oferece os motores que sua máquina realmente consegue executar e escolhe o padrão com uma única regra em todo lugar: um CLI instalado (Claude → Codex → Gemini → Kimi) ou, se não houver, o primeiro motor local cujo endpoint responda. Em uma máquina só com um endpoint local, rails, Add Spec, chat, **missões do agente e o Project Builder** começam nele — sem tocar em nenhum seletor. Um motor cujo servidor está fora do ar simplesmente não é oferecido até voltar a responder. Missões existentes mantêm o motor com que foram criadas; o seletor continua permitindo trocar.
-
 ## Escolher um modelo
 
 A qualidade depende do modelo, não do Specrails. Para rails use um modelo de código ajustado para tool calling com 30B parâmetros ou mais; modelos instruct menores servem para chat, Explore e specs Quick. Experimente **Freestyle** ou uma sessão Explore antes de confiar um rail implement completo a um modelo novo.

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

@@ -35,8 +35,6 @@ 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` / `Freestyle` / `SDD Quick (OpenSpec)`) ou um loop personalizado. Veja a tabela abaixo. Persistido por 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
@@ -46,14 +44,9 @@ Um rail roda um **Loop** — a receita do trabalho. Dois loops são **embutidos*
 | Loop embutido | Comando | O que faz |
 |------|---------|--------------|
 | **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. |
-| **Freestyle** | Freestyle | Claude ou Kimi implementa cada spec de forma autónoma, **ignorando** o pipeline. |
 
 Para rodar várias specs, coloque as relacionadas (até 3) num único rail — o `Implement` executa-as como um só job agregado — ou distribua specs independentes por vários rails: cada rail com git roda em paralelo na sua própria worktree isolada.
 
-Freestyle usa ferramentas e modelos nativos do provider. Claude tem transport
-interativo persistente; Kimi usa um processo agentic `kimi -p` sem stdin
-persistente.
-
 Os embutidos também são editáveis: edite um no Loop Builder e publique-o, e todos os rails que o escolhem rodam a sua versão (use **Restaurar original** para voltar atrás).
 
 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).
@@ -84,11 +77,6 @@ Clique em qualquer cartão para abrir a **vista de detalhe do Job**, onde ficam
 
 Clique em **■ Stop** no cabeçalho do rail. A app envia `SIGTERM` ao subprocesso, espera **5 segundos** por uma saída limpa e então faz `SIGKILL`. Nada fica spawnado pela metade.
 
-## Se um rail não lançar
-
-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
 
 Se algo parecer errado:
@@ -101,4 +89,3 @@ 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.
-- [Escolhendo um motor por rail](picking-an-engine-per-rail) — Claude, Codex, Gemini ou Kimi.

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

@@ -94,8 +94,6 @@ Algumas coisas que vale a pena saber:
 - **A linha de totais é real.** O compositor mostra um resumo ao vivo `N turnos · $X`, somado a partir do uso real de cada turno concluído — coerente com a promessa desta página de nunca adivinhar.
 - **Duas formas de uma sessão terminar.** A maioria dos jobs **termina sozinha**: assim que um turno acaba sem mensagens em fila, a sessão assenta e o job conclui — as suas mensagens são orientação opcional, nunca uma obrigação. Uma ação discreta **Concluir agora** termina-a mais cedo com tudo o que foi produzido até então. Os jobs **Freestyle** são a exceção: ficam à espera entre turnos até que clique em **Finalize** — é esse o seu desenho, uma sessão de ida e volta que fecha quando terminar.
 - **Nas execuções de loop, as mensagens vão para o passo ativo.** Num loop embutido ou personalizado, a sua mensagem chega ao **passo de IA que está a correr nesse momento**. Entre passos (enquanto o Loop Decider pensa, ou um comando de shell corre) o compositor mostra um breve estado *«À espera do próximo passo…»* — o texto rascunhado mantém-se, e o envio reativa-se quando o próximo passo de IA arranca. **Assentar este passo** termina o passo atual mais cedo e deixa o loop avançar com o que ele produziu.
-- **Interação persistente é só Claude.** Codex, Gemini e Kimi correm one-shot;
-  Kimi retoma o chat com novo `kimi --session=<id> -p` depois de um resume hint.
 
 ## Exportação de diagnóstico