Show HN：AIエージェント向けの永続的なファイルシステムレイヤー

SmolFS は、AIエージェントのために設計された永続的なファイルシステムレイヤーです。エージェントが短命なランタイム環境で動作する際、ファイルをプロセス間で保持できるようにします。従来、エージェントは実行ごとに新しい環境を開始するため、以前の作業成果が失われるという問題がありました。SmolFS は、マウント可能なワークスペースディレクトリを提供し、エージェントがジョブ終了後もファイルを保持し、後続のプロセスで再利用できるようにします。

SmolFS の大きな特長は、シンプルなライフサイクル管理です。コマンド一つでマシンの状態確認（doctor）、ボリュームの作成（init）、マウント（mount）、フラッシュ（flush）、アンマウント（unmount）が行えます。ローカル開発モードでは SQLite とローカルファイルを使用し、クラウドボリュームモードでは Redis（メタデータ）と S3 互換オブジェクトストレージ（ファイル内容）を利用します。クラウドモードは、同一ワークスペースを複数のマシンで共有する必要がある場合に特に有用です。

さらに、SmolFS は Python および TypeScript の SDK を提供しており、これらは同じ Rust コアを呼び出します。SDK を使うことで、エージェントツールは CLI を呼び出さずに直接 SmolFS の機能を利用できます。例えば、Python SDK の SmolFS.from_env() や ensure_volume() メソッドを使えば、数行のコードで永続ワークスペースを作成・管理できます。TypeScript SDK はネイティブ Node.js バインディングとして提供され、Linux および macOS の x86_64 と arm64 をサポートしています。

セキュリティ面では、SmolFS は明示的な設定と機密情報の非ログ記録を重視しています。クラウドストレージの認証情報は環境変数でのみ提供し、コマンド引数やログに含めないよう推奨しています。また、マウント/アンマウント操作は可能な限り冪等であり、設定不足時には明確にエラーを報告します。SmolFS はエージェントワークスペースデータをサンドボックスのライフサイクル外に保存するため、永続化インフラストラクチャとして扱う必要があります。

SmolFS は、AIエージェントのファイル永続化に対するシンプルで信頼性の高いソリューションを提供し、特に複数ランタイムにわたるエージェントワークフローにおいて価値を発揮します。ローカル開発から本番環境の分散デプロイメントまで、エージェントの作業成果を安全に保存し効率的にアクセスできます。