最終更新：2026年8月8日。AgentVFS 公式ドキュメント、Factory AgentFS、AIGNE AFS を基に整理しています。
コーディングエージェントを本番リポジトリに接続するとき、モデルはパスと diff を見る一方、実行は Docker・リモート Runner・別 Mac の Xcode プロジェクトに散らばります。その間をつなぐ AI Virtual File System が、2026年の Agent 基盤では実質必須になりつつあります。
代表例は AgentVFS、Factory の AgentFS、AIGNE の AFS。名称は似ていますが、単一 Agent サンドボックス向け、proxy 多租户、checkpoint 主導など設計の重心が異なります。本記事では用語を揃え、日本の開発チームが AgentVFS・AgentFS・AFS を実務で選べる軸を示します。
はじめに
RAG はベクトル庫に知識を置きますが、コーディング Agent は ファイルツリー に知識を置きます。Tool で read/write するたびに権限・同時書き込み・未コミット変更・試行錯誤の巻き戻しが発生します。ホスト直マウントは危険、純メモリ FS は npm/cargo/xcodebuild と相性が悪い。vault・fork・checkpoint・proxy・FUSE で「普通のパス」に見せかけつつ監査可能にする層が VFS です。
ファイル状態はセマンティックメモリと連動します。checkpoint の境界はツールセッションの境界に対応しがちです。Redis・PostgreSQL・TencentDB AI Memory 選定ガイド と併読すると全体像が掴みやすくなります。
AI Virtual File System が解く課題
- 隔離不足：
~/.sshや本番設定の誤上書き； - ロールバック困難：十ファイル変更後にテスト全滅、手動 git reset；
- 環境不一致：ローカルパスと CI パスの乖離、Tool 分岐の増殖。
fork 内で実験し、失敗なら checkpoint 破棄、成功なら vault へマージ。24/7 Gateway では クラウド Mac 上の proxy に実体を置き、ノート PC は薄いクライアントにできます。長時間タスクでは PDF を AI 知識庫に：Book to Skill ガイド のようなループ検知とセットで設計してください。
核心概念
vault は管理対象ファイル集合の根。fork はそこから分岐した作業コピー。checkpoint は fork 内の時点印。proxy はリモート操作の統一 API。FUSE は OS に仮想ツリーをマウントし既存 CLI をそのまま使う仕組みです。各プロジェクトの差はこの組み合わせの重み付けです。
AgentVFS
AgentVFS はドキュメントと vault 中心。監査要件が強い企業向け coding Agent に向きます。タスクごとに vault → fork 編集 → checkpoint → テスト後 commit の流れが明文化されています。
AgentFS
AgentFS は Factory スタックへの薄い組み込みと、試行錯誤ループでの checkpoint が強み。大規模リファクタを繰り返す Agent に適します。
AFS
AFS は 複数 Agent の並列編集 と FUSE を前面に。サブ Agent ごとに fork を切り、proxy がマージを調整します。OpenClaw 型の多役分担と相性が良いです。
比較マトリクス
| 観点 | AgentVFS | AgentFS | AFS |
|---|---|---|---|
| 重心 | vault・監査 | 軽量サンドボックス | 並列 Agent・FUSE |
| checkpoint | セッション監査 | 試行錯誤デフォルト | 並列 fork マージ |
| proxy | 企業ゲートウェイ | Factory 埋め込み | マルチ vault |
シナリオ別
個人プロトタイプ：AgentFS または AFS の単一 FUSE。企業：AgentVFS + クラウド Mac 上 proxy。多 Agent：AFS。Factory 既存：AgentFS 優先。
実装の要点
- vault 境界（読み取り専用・ignore ルール）；
- checkpoint 粒度（Tool 毎 vs タスク毎）；
- proxy（TLS・認証・レート制限）；
- CI でマウント→編集→テスト→ロールバック；
- checkpoint ID をログと Redis・PostgreSQL・TencentDB AI Memory 選定ガイド の長期記憶に紐付け。
fork 数・checkpoint 容量・proxy 遅延・ロールバック回数を監視。PDF を AI 知識庫に：Book to Skill ガイド と連動したサーキットブレーカーも検討してください。
FAQ
git worktree との違いは？
git は履歴、VFS は Agent サンドボックス語彙とリモート proxy。併用が一般的です。
クラウド Mac の利点？
Gateway と vault を 24/7 同居。スリープで fork が消えません。Apple 向けビルド Agent に有効です。
まとめ
- AI Virtual File System は coding Agent の隔離・巻き戻し・リモート実行層。
- AgentVFS＝監査と vault、AgentFS＝Factory 内試行錯誤、AFS＝並列と FUSE。
- 用語を揃えてから選ぶこと。裸ディスクのまま Agent を伸ばすのは限界があります。
クラウドMacでエージェントワークスペースを常時運用
どの VFS を選んでも ロールバック可能で監査可能な実行ノード が必要。Kvmkit クラウド Mac mini で Vault マウントと OpenClaw を24/7運用。