AgentFSとは？
AgentFSは、エージェントが触れるものすべてを、同社のSQLite互換エンジンTursoの上に作られた1つのSQLiteデータベースに保存します。このファイルの中身は3つです。inodeとディレクトリエントリのテーブルとして保存されるPOSIX風のファイルシステム、状態を置くキーバリューストア、そしてツール呼び出しの追記専用ログです。1ファイルなので、スナップショットはデータベースをコピーするだけで済み、エージェントの履歴はログから組み立て直すのではなくSQLで問い合わせます。
プロジェクトはTypeScript、Python、Rust、GoのSDKと、CLIを提供します。CLIはデータベースを実際のファイルシステムとしてマウントし（LinuxはFUSE、macOSはNFS）、`agentfs run`でコピーオンライトのサンドボックス内でプログラムを動かし、`agentfs timeline`でツール呼び出しの履歴を表示し、ファイルとキーバリューストアをMCPやNFSで提供します。任意の同期機能はデータベースをTurso Cloudへ送ります。代わりにローカルの保存時暗号化も使えますが、両者は併用できません。
AgentFSは使う価値があるか？
AgentFSの価値は1つのファイルにあります。エージェントの作業ファイル、キーバリューの状態、呼び出したツールすべての記録が1つのSQLiteデータベースに入るため、失敗した実行を巻き戻すには以前のスナップショットをコピーし直せばよく、何が起きたかを調べるのもログを掘り返すのではなくSQLの問い合わせ1本で済みます。TursoのPekka EnbergとGlauber Costaが2025年11月13日に発表し、リポジトリのGitHubスターは約3,500です。
CLIはSDKだけから想像するより多くをこなします。`agentfs run`はプロジェクトのコピーオンライトのオーバーレイ上でシェルやコーディングエージェントを起動します。書き込みはデータベースに入り、元のファイルには手を付けません。Linuxではuser namespaces、macOSではAppleのサンドボックスを使います。`agentfs mount`はデータベースを普通のディレクトリとして見せるので、gitやgrepなどのツールがそのまま動きます。READMEは、git worktreesはエージェントを慣習で分けているだけで、オーバーレイはエージェントの下の層で強制されると率直に書いています。npmパッケージは2026年11月12日までの1週間に23,397回ダウンロードされました。
初期設定ではデータはローカル、プロジェクト内の.agentfs/<id>.dbに置かれます。`agentfs serve nfs`は別のアドレスにバインドしない限り127.0.0.1のポート11111で待ち受け、そのポートに届く人は誰でもファイルをマウントできます。ローカル暗号化は、自分で管理する16進数の鍵を使ってAES-256-GCMとAEGIS系の暗号に対応します。Turso Cloudとの同期を有効にすると暗号化は使えません。
注意点：成熟度です。2026年2月5日のバージョン0.6.0が最初のベータで、READMEは今もバックアップなしで本番データを任せないよう警告しています。最新リリースのv0.6.4は3月25日に出ました。メインブランチの最後のコミットは6月3日のlint修正で、トラッカーには未解決のissueが59件、オープンなプルリクエストが18件あります。スキーマ変更には`agentfs migrate`が必要で、より厳格なptraceベースのサンドボックスは実験的かつLinux専用です。
結論：取り消しと監査証跡を自前で書かずに手に入れたいエージェント基盤の開発者にとって、AgentFSは現時点で最もすっきりした設計です。ノートPC上で動かすコーディングエージェント1つなら、gitとコンテナでほぼ足ります。
真価を発揮する場面
顧客のリポジトリでコーディングエージェントを動かす会社のエンジニア
エージェントに自由にファイルを変更させ、実行が失敗したら変更を捨てる
`agentfs run`でエージェントを起動し、書き込みをオーバーレイのデータベースに集めます。終わったらそのファイルを残すか捨てるだけです。ソフトウェアは無料で、コストはベータのリスクと自社のランナーへの組み込みにかかる時間です。
エージェントが何をしたかを監査人に示す必要があるプラットフォームチーム
エージェントがどのファイルを書き、どのツールをどの順番で呼んだかに答える
SDKでツール呼び出しを記録し、追記専用ログとファイルのテーブルをSQLで問い合わせるか、`agentfs timeline`を読みます。実行ごとにデータベースファイルを保管すれば、証拠が1か所にまとまります。
サーバーレスやブラウザでエージェントを作る開発者
ディスクをマウントできない環境でエージェントにファイルシステムを持たせる
TypeScript SDKでAgentFSのデータベースを開きます。プロジェクトはCloudflare Durable ObjectsとWebAssemblyでの動作例も示しています。任意のTurso Cloud同期で状態をマシン間で運べます。
導入前に確認すること
- 導入
- リリースページのcurlインストーラーでCLIを入れ、`agentfs init my-agent`で.agentfs/my-agent.dbが作られます。SDKは`npm install agentfs-sdk`、pip、cargoで入ります。
- 連携
- Mastra、Claude Agent SDK、OpenAI Agents SDK、just-bashと組み合わせたVercel AI SDK、Cloudflare Workers、Firecrackerの例があり、MCPとNFSのサーバーはCLIに組み込まれています。
- データとプライバシー
- Turso Cloud同期を設定しない限り、すべてはローカルのSQLiteファイルに留まります。ローカルの保存時暗号化は自分で用意した鍵を使います。NFSサーバーは初期設定で127.0.0.1にバインドし、別のアドレスにバインドするとポートに届く誰にでもファイルを公開します。
- 大規模利用時のコスト
- ソフトウェアは無料です。Turso Cloud同期はTursoへの別の請求になり、ストレージはデータベースに残すファイルのバージョンとツール呼び出しの分だけ増えます。
- 制限
- ベータ版。スキーマの更新には`agentfs migrate`が必要。LinuxのFUSEとmacOSのNFSのみ。ptraceサンドボックスは実験的でLinux専用。暗号化と同期は同時に使えません。
良い点
- ファイル、キーバリューの状態、ツール呼び出しが1つのSQLiteファイルにあり、SQLで問い合わせられる
- スナップショットと巻き戻しはファイルのコピーで済む
- コピーオンライトのサンドボックスはLinuxとmacOSで実際のプロジェクトに手を付けない
- TypeScript、Python、Rust、GoのSDKに加え、MCPとNFSのサーバー
気になる点
- ベータ版で、READMEはバックアップなしの本番データ利用を警告している
- 2026年3月25日のv0.6.4以降リリースがない
- 保存時暗号化とTurso Cloud同期は併用できない
- リポジトリのルートにライセンスファイルがなく、ライセンスはREADMEとパッケージのメタデータで宣言されているだけ
おすすめの人
エージェント基盤やサンドボックスを作り、各実行を調べられてコピーできる1つのデータベースとして保存したいチーム。
AgentFSの代替
AgentFS：よくある質問
- AgentFSは使う価値があるか？
- AgentFSはエージェントのファイル、状態、ツール履歴を、問い合わせもコピーもできる1つのSQLiteファイルにまとめます。発想はすっきりしていますが、まだベータ表記のままで、春以降は動きが鈍っています。 評価は5点満点中3.7点です。
- AgentFSの料金は？
- 無料のオープンソース（READMEとパッケージのメタデータによればMIT）。任意の同期先はTurso Cloudで、Tursoが別途課金します。
- AgentFSの欠点は？
- ベータ版で、READMEはバックアップなしの本番データ利用を警告している; 2026年3月25日のv0.6.4以降リリースがない; 保存時暗号化とTurso Cloud同期は併用できない; リポジトリのルートにライセンスファイルがなく、ライセンスはREADMEとパッケージのメタデータで宣言されているだけ.
- AgentFSは誰に向いている か？
- エージェント基盤やサンドボックスを作り、各実行を調べられてコピーできる1つのデータベースとして保存したいチーム。
- チームや本番環境でAgentFSを使うと費用はいくらか？
- ソフトウェアは無料です。Turso Cloud同期はTursoへの別の請求になり、ストレージはデータベースに残すファイルのバージョンとツール呼び出しの分だけ増えます。
- AgentFSは企業データを扱っても安全か？
- Turso Cloud同期を設定しない限り、すべてはローカルのSQLiteファイルに留まります。ローカルの保存時暗号化は自分で用意した鍵を使います。NFSサーバーは初期設定で127.0.0.1にバインドし、別のアドレスにバインドするとポートに届く誰にでもファイルを公開します。
- AgentFSの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はOpenSandbox, Anthropic Sandbox Runtime (srt) 、 Beadsです。
回答確認日：2026年11月13日