tursodatabase/agentfs
The filesystem for agents.
What it solves
AgentFS는 AI 에이전트가 상태, 파일 및 히스토리를 관리할 수 있도록 특화된 스토리지 시스템을 제공합니다. 모든 작업을 기록하고 영구적인 파일 시스템을 유지하며 에이전트 환경을 휴대 가능하고 재현 가능하게 함으로써 전통적인 파일 시스템이나 컨테이너에서 흔히 겪는 상태 관리 문제를 해결합니다.
How it works
AgentFS는 SQLite 기반 스토리지 시스템(Turso 제공)을 사용하여 에이전트가 수행하는 모든 작업을 단일 데이터베이스 파일에 저장합니다. 주요 인터페이스는 다음 세 가지입니다:
- Filesystem: 파일 및 디렉터리를 관리하는 POSIX‑유사 시스템.
- Key-Value Store: 에이전트 상태와 컨텍스트를 저장하는 방법.
- Toolcall Audit Trail: 디버깅 및 분석을 위해 에이전트가 호출한 모든 도구를 기록합니다.
사용자는 SDK(TypeScript, Python, Rust) 또는 CLI를 통해 AgentFS와 상호 작용할 수 있으며, CLI는 FUSE(Linux) 또는 NFS(macOS)를 사용해 파일 시스템을 마운트할 수 있습니다.
Who it’s for
구조화된 상태 관리, 디버깅을 위한 감사 가능성, 그리고 격리된 환경에서 에이전트를 안전하게 실행하려는 AI 에이전트 개발자를 위해 설계되었습니다.
Highlights
- Auditability: 모든 파일 작업 및 도구 호출이 SQL로 기록되어 에이전트의 히스토리를 쿼리할 수 있습니다.
- Reproducibility: 에이전트 상태를 스냅샷하고 복원하여 정확한 실행 상태를 재현하거나 실수를 롤백할 수 있습니다.
- Portability: 파일과 히스토리를 포함한 전체 런타임이 단일 SQLite 파일에 포함됩니다.
- Isolation: 파일 시스템 수준의 복사‑쓰기 격리를 제공하여 신뢰할 수 없는 에이전트를 안전하게 실행합니다.