Teddy012/agent-fs

agent-fs は何をしますか？

AIエージェント向けのクロスプラットフォームCLI。ローカルファイルとクラウドストレージを標準化されたJSON出力で安全かつ効率的に管理します。

概要

agent-fs は、AIエージェントがファイルシステムとクラウドストレージを操作するための統一インターフェースを提供します。すべてのコマンドはマシンパーサブルなJSONを出力するため、エージェントが出力を確実に解釈できます。

特徴

• クロスプラットフォーム: Windows、macOS、Linuxで動作
• 標準化されたJSON出力: すべてのコマンドが一貫したJSONスキーマで応答
• クラウドストレージ統合: S3、GCS、Azure Blob Storageなどの主要サービスをサポート
• 安全なファイル操作: バリデーション、トランザクション、ロールバック機能
• 軽量: 依存関係最小限で高速実行

インストール

npm install -g agent-fs
# または
pip install agent-fs

基本的な使い方

ファイルの読み取り

agent-fs read ./path/to/file.txt

出力例:

{
  "status": "success",
  "data": {
    "path": "/absolute/path/to/file.txt",
    "content": "ファイルの内容...",
    "size": 1024,
    "encoding": "utf-8"
  }
}

ファイル一覧

agent-fs ls ./directory

ファイルの書き込み

agent-fs write ./output.txt "新しい内容"

クラウドストレージへのアップロード

agent-fs upload ./local/file.txt s3://my-bucket/remote/path/

環境変数

• AGENT_FS_CLOUD_PROVIDER: クラウドプロバイダーを指定 (s3, gcs, azure)
• AGENT_FS_CLOUD_BUCKET: デフォルトのバケット名
• AGENT_FS_LOG_LEVEL: ログレベル (error, warn, info, debug)

サポートされるプラットフォーム

• Claude Code
• Cursor
• Codex
• その他任意のAIエージェント（JSON出力に対応しているもの）

ライセンス

MIT License

貢献

プルリクエストとイシュー報告は大歓迎です。詳細は CONTRIBUTING.md を参照してください。