ThreadCells を運用する
リポジトリを掘り返さずに。

ThreadCells は、Linux マシン上で複数のコーディングエージェントを一つの協調ワークフローとして実行するセルフホスト型システムです。エージェントに実際の端末と Git worktree を与え、モデルターンをまたぐオープンなミッションを進め続け、容量、書き込みアクセス、保護された変更、最終結果をオペレーターが制御できるようにします。

これは、ソースチェックアウトからローカル ThreadCells サーバーまでの最短のサポート対象パスです。不変のローカル候補をビルドして内容を検証し、現在のリポジトリ配下にインストールして、ループバック上だけで待ち受けます。

このガイドでは、サポート対象のローカルインストール手順と、ThreadCells が検証済み候補からインストールされる理由を説明します。コマンドだけが必要な場合は、クイックセットアップを使ってください。

このチュートリアルでは、意図的に小さなエージェントを一つ起動し、その端末と結果を見つける場所を示します。先にクイックセットアップを完了し、ThreadCells サーバーを実行したままにしてください。

ThreadCells は、ネイティブのコーディングエージェント端末の周囲に構造を追加します。このページでは一度に一つの考え方を導入し、その後で各要素がどう結び付くかを示します。

ThreadCells はループバック優先です。サーバーは公開インターフェースではなく 127.0.0.1 で待ち受けるべきです。通常の Web UI はオペレーターコンソールであり、一般的なログイン境界を提供しません。

Web UI は、ThreadCells を見るオペレーターのライブビューです。ループバックリスナー向けに設計されており、ブラウザーでもインストール済みの基本的な PWA としても通常どおり機能します。インストールしても、オフラインの運用動作や新しい認証境界が追加されることはありません。

ThreadCells プロジェクトは、登録済みの Git リポジトリであり、正規のソース権限です。セッション、プロファイル、統計、ワークフローに安定した所属先を与えますが、新しい supervisor の通常の書き込み可能ディレクトリではありません。ThreadCells はリポジトリを登録しただけで安全にすることはありません。クリーンな状態から始め…

プロバイダーとは、実際にモデルターンを実行するネイティブのコーディングエージェント CLI です。ThreadCells はその CLI をアダプターで包み、起動、ターミナル状態、キャンセル、機能レポート、利用可能な使用量テレメトリーを共通の形にします。

プロファイルは、エージェント用の再利用可能な起動ポリシーです。どのプロバイダーとモデルを実行するか、どの程度の推論を使うか、どのロールと指示を受けるか、どの機能または権限を許可するかに答えます。

ワークフローは、複数のモデルターン、ターミナル、または委任されたエージェントにまたがって一貫性を保つ必要がある作業を表します。これにより、プロバイダーの最終メッセージがより大きなミッションの完了と誤認されるのを防ぎます。

Statistics は、サポート対象のプロバイダー CLI が実際に出力する使用量を要約します。どのセッション、プロファイル、プロジェクト、プロバイダーがモデルトークンを消費したかを把握する助けになります。これは請求台帳ではなく、欠けている値を作り出しません。

オペレーター認可は、Settings における機密性の高いコントロールプレーン変更を保護します。これは通常の Web UI へのアクセスとは別です。エージェント、ターミナル、ドキュメント、統計の閲覧にオペレーターシークレットは必要ありません。

ThreadCells は、1つの Telegram 宛先に低ノイズのライフサイクル通知を送信できます。これはインストール全体の ThreadCells 機能です。現在選択されているプロジェクトに属さず、そこから設定を読み取らず、依存もしません。

ThreadCells は、コーディングエージェントの作業が異なる時点でホストの異なる部分に負荷をかけるため、容量を分離しています。モデルターンはプロバイダー容量を消費し、割り当てられたコーディングコンテキストはモデルがアイドル中もアクティブなままであり、ビルドはモデル出力が停止した後にマシンを飽和させることがあります。

これは、信頼済みのプロバイダー統合を追加するメンテナー向けの高度なガイドです。組み込みプロバイダーから選ぶオペレーターは、まず プロバイダー を参照してください。

ThreadCells は、ローカル候補の schemas/v1 と wheel の cliagentorchestrator/publicschemas/v1 に、ProfileDefinition V1、ProviderConfiguration V1、AdapterManifest V1、AdapterCapabilities V1 用の JSO…

ThreadCells は、ネイティブのコーディングエージェントプロセスを取り巻くローカルコントロールプレーンです。プロバイダー端末、Git リポジトリ、永続的な協調状態、ブラウザー UI を、それぞれ明示的な境界を持つ別コンポーネントとして意図的に保ちます。

ThreadCells の日常運用では主に、実行中ビルドの識別情報、ワークフロー所有権、利用可能な容量、復旧可能な状態という四種類の事実を保つことが重要です。

Housekeeping は、ThreadCells が対象であることを証明できる場合にのみランタイム成果物を回収します。意図的に保守的です。未知、読み取り不能、アクティブ、参照中、または変更済みのリソースは、安全に削除できると推測せず保護します。

有用な ThreadCells バックアップは、永続的な協調状態と、それを解釈するために必要な設定を保存します。インストール済みコードとビルドキャッシュは通常再構築できますが、データベース、オペレーター所有の設定、プロバイダー固有の証拠はそうではない場合があります。

ThreadCells のデプロイメントは、検証済みの不変候補をローカルランタイムへ昇格します。公開、Git のプッシュ／タグ、パッケージリリース、公開ネットワーク露出を意味するものではありません。

アップグレードとは、検証済みのロールバックを伴う、制御された候補の昇格です。現在実行中のファイルをその場で上書きすることではありません。

まず証拠を保全します。現在のビルド ID、安全なエラーテキスト、影響を受けたセッション／ワークフロー、容量状態、最近のログ、Git ステータスです。永続的な操作がすでに成功したかを把握するまで、クリーンアップ、削除、やみくもな再試行を避けてください。

クリーンでコミット済みのツリーから、scripts/buildlocalcandidate.py --output <new-directory を使用して隔離されたローカル候補をビルドします。これは生成された Docs/UI とローカル wheel をパッケージ化します。SHA256SUMS を検証し、candidate-manifest.json、…

ThreadCells は、1 人または少人数の信頼できるチームが運用する、信頼できる 1 台の Linux ホストを対象としています。強力なネイティブコーディングエージェントを調整するものであり、敵対的なユーザー、プロンプト、リポジトリ、またはプロバイダープラグイン向けのサンドボックスではありません。

ThreadCells は、1 台の Linux ホスト上でコーディングエージェントを信頼できる形でローカル運用することに焦点を当てた技術プレビューです。ここに挙げる境界は意図的な製品上の事実であり、未実装のエンタープライズ機能に関する約束ではありません。

ThreadCells は、ネイティブのコーディングエージェント CLI をすでに評価しており、1 台のマシンで複数をより明確に運用したい開発者向けです。

ThreadCells は AWS Labs CLI Agent Orchestrator から派生した独立した downstream です。保持されている上流ライセンスおよび帰属表示は、ソース候補の LICENSE と NOTICE ファイルにあります。このリポジトリは、既存の動作を維持するために必要な互換性のある内部 cao 名とコマンドを保持しま…

ThreadCells の改善にご協力いただきありがとうございます。焦点が明確で、実行可能であり、公開して安全に議論できるレポートとプルリクエストを歓迎します。

英語は、ThreadCells の公開ドキュメント、ルート README、および製品上の主張における正規の権威です。翻訳では自然な表現に改善できますが、動作の省略や創作、安全境界の弱体化、制限の変更、コマンドの変更はしてはいけません。

GitHub Issues は、ThreadCells のキュレーションされた公開バックログであり、警告、監査、リリースデバッグの記録ではありません。