FonaTech/Clouds-Coder

Clouds Coder – これは何ですか

Clouds Coder は、Pythonベースのランタイムで、ローカルまたはクラウドホスト上でコマンドラインツール（CLI実行平面）を実行しつつ、豊富なブラウザベースのIDE（Webユーザー平面）を通じてプロセスと対話できます。これは、汎用AIエージェントを基盤としており、LAN全体のコラボレーションモードを追加することで、複数のユーザーとそのプライベートエージェントが、互いの作業を干渉せずに同じプロジェクトに取り組めるようにします。

コアのアイデアは、重い処理（例：git、make、docker、カスタムスクリプト）をユーザーインターフェースから分離することです。これにより、以下の利点が得られます：

• 観察可能で再現可能な実行（完全なログ、デバッグコンソール、ターミナル出力）；
• ファイルレベルの履歴を持つバージョン管理されたワークスペース；
• ユーザーのリクエストをエージェント向けのより豊かで、深さ予算付きの計画に拡張する「プロンプトエンハンサー」；
• 細かいセキュリティ — すべてのツール呼び出しは、特定のワークスペースで実行される前に管理者による承認が必要です。

---

主要なコンポーネント（READMEに記載）

コンポーネント	機能
ランタイム（CLI実行平面）	任意のコマンドを実行し、Python debugpy や pdb を使ってデバッグを行い、結果をUIにフィードバックします。
ブラウザIDE	Monacoベースのエディタ、ファイルエクスプローラ、ターミナル、デバッグコンソール、および エージェントチャット、タスクブラックボード、診断用パネルを備えます。
Liquid Kernel	変更不可能な制御平面で、署名済みのツールポリシー、プロンプトポリシー、ライフサイクルフック（before_run、before_round、after_tool_results）を格納します。カナリーロールアウトとロールバックを処理します。
コラボレーションモード（LAN）	デフォルトで P+7 を使用する別途のリスナー。管理されたプロジェクトワークスペースをホストします。承認済みデバイスはパスワード + デバイスキーのフローで参加し、24時間のHttpOnlyセッションを取得。リビジョン付きファイル、存在状態、共有タスクブラックボードを確認できます。
エージェントオーケストレーション	セッション内ではエージェントが役割（manager、explorer、developer、reviewer）を担います。プロジェクト全体では、コーディネーターエージェントが作業を分割し、コントリビューターエージェントが重複しないスライスを実行します。
プロンプトエンハンサー	深さ予算（Low → XHigh）を設定可能なワンショットまたは永続的プロンプティング。LLMにリクエストを送信する前に、ワークスペースの認識とオプションのスキルオーケストレーションを追加します。
セキュリティと信頼境界	管理者がデバイスを承認し、どのMCP（モデル制御プロセス）コマンドが許可されるかを定義し、SQLiteに格納されたレジストリに署名します。承認済み構成が変更されると、既存の承認は無効になります。
リビジョン対応書き込みプロトコル	テキスト編集には操作変換を使用；バイナリ/全体ファイル書き込みには楽観的排他制御；シェル/エージェントプロセスは変更リースを取得して、複数ファイルの原子的更新を保証します。

---

一般的なワークフロー

1. ランタイムの起動 – python Clouds_Coder.py --host 0.0.0.0 --port 8080（ランタイムは8080、IDEは8085、コラボレーションは8087）。
2. IDEを開く – http://127.0.0.1:8085 にアクセス。IDEはセッションワークスペース、エディタ、ターミナル、および エージェントチャット パネルを表示します。
3. エージェントに依頼する – 高レベルな目標（例：「Docker付きFlaskプロジェクトをセットアップ」）を入力。プロンプトエンハンサーがリクエストを拡張し、エージェントがステップを計画。ランタイムがCLIコマンドを実行し、IDEにストリーミング出力を送信します。
4. コラボレーション – --enable_collaboration を有効化。管理者UI（/admin → Collaboration）でチームメイトを招待。デバイス承認後、チームメイトはプロジェクトURL（P+7）を開き、同じリビジョン付きファイル、共有ブラックボード、および互いの存在状態を確認できます。
5. 競合の解決 – 2つのエージェントが同じファイルを編集しようとした場合、システムは候補ブランチを作成し、ベースラインをロックし、マージ前に2人の異なるメンバーによるレビューを強制します。
6. 監査とロールバック – すべてのアクションは署名され、変更不可能なSQLite監査チェーンに保存されます。管理者はカーネルバージョンをロールバックしたり、以前のプロジェクトスナップショットを復元できます。

---

どんな人が使うべきか？

• CLIを駆動するエージェントをテストするためのAIエージェント開発者。
• コマンドを観察可能かつ監査可能に保ちつつ、低負荷でLAN限定のコラボレーティブIDEを必要とする開発チーム。
• 「バイブコーディング」（AIをコード作業に導きながら、ターミナルとファイル変更をリアルタイムで観察する）を教える教育者／ラボ。
• すべてのツール呼び出しに明示的な承認を要求し、完全な監査トレールを必要とするセキュリティ意識の高い組織。

---

インストールとクイックスタート（READMEから）

pip install clouds-coder   # 最新のPyPIリリースを取得
# ポート8080でランタイムを起動（IDEは8085、コラボレーションは8087）
python Clouds_Coder.py \
  --host 0.0.0.0 \
  --port 8080 \
  --enable_collaboration \
  --collab_host 0.0.0.0 \
  --collab_port 8087

• IDEは http://127.0.0.1:8085 で開きます。
• 管理者UI http://127.0.0.1:8080/admin でプロジェクトを作成し、パスワードを設定、デバイスを承認します。
• 本番LAN環境では、--collab_tls_cert/--collab_tls_key を指定するか、HTTPSリバースプロキシを設置してください。

---

詳細情報の入手先

• 変更履歴 – 詳細な機能履歴は log/CHANGELOG‑*.md に記録されています（例：2026-09-12の「Liquid Kernel & Scalable Session Runtime」変更履歴）。
• LLM設定テンプレート – LLM.config.json は、サーバーサイドLLMプロファイル、スキル、RAGリソースを統合する方法を示しています。
• アーキテクチャ図 – READMEには、ランタイム、制御平面、コラボレーション境界を示すMermaidフローチャートが含まれています。

---

まとめ

Clouds Coderは、実用的で本番環境対応のプラットフォームです。AI駆動のCLIエグゼキュータとWebベースのIDE、および管理されたLANコラボレーションレイヤーを統合しています。複雑なCLIタスクを、複数の人が観察可能で再現可能かつ安全に実行できるようにすることを目的としています。