Release Notes

Added

• agentfs run command with overlay filesystem for sandboxed execution.
• agentfs diff command to show filesystem changes.
• Multi-session support with --session flag and AGENTFS_SESSION environment variable.
• --allow flag for specifying writable directories in sandbox.
• macOS Sandbox support for filesystem isolation.
• NFS-based agentfs run support for macOS.
• Linux ARM64 support.
• TypeScript SDK: FileSystem interface for filesystem operations.
• TypeScript SDK: New APIs (access, copyFile, rmdir, rename).
• TypeScript SDK: agentfs() convenience function for just-bash integration.
• Python SDK: Python 3.10+ support.
• Rust SDK: base option for agentfs::open.
• Rust SDK: VFS-style File trait for efficient file handle operations.
• Rust SDK: get_runtime() helper for runtime initialization.
• FUSE: Symlink support.
• FUSE: readdir_plus optimization to eliminate N+1 queries.
• Database: nlink column for O(1) link count lookups.
• Sandbox: Intercept chmod system call.
• --version flag using git tags.
• Firecracker + AgentFS example.
• AI SDK + just-bash example with AgentFS integration.

Changed

• Default shell is now bash on Linux, zsh on macOS.
• /tmp is writable by default in sandbox.
• ~/.bun added to default allowed directories.
• npm local registry added to allowlist.
• AGENTFS_SANDBOX environment variable is more descriptive.
• FUSE optimizations: async read, parallel directory operations, symlink/directory caching.
• Rust SDK: Configure busy timeout instead of failing immediately.

Fixed

• Overlay filesystem nested pwrite().
• O_APPEND not appending to file.
• FUSE error handling.
• Execute permissions in FUSE mount.
• SSH inside user namespace by bypassing system configs.
• Symlink handling in FUSE and overlay filesystem.
• Rust SDK: pread() for sparse files.
• Rust SDK: pwrite() buffer flushing before returning.
• Rust SDK: resolve to prioritize agent ID over file path.
• agentfs init --force to reinitialize agent filesystem.
• Overlay mount I/O error by unifying whiteout schema in SDK.
• UID/GID mapping to use current user instead of root.

Removed

• macFUSE support on macOS (replaced by NFS).

Install agentfs 0.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/tursodatabase/agentfs/releases/download/v0.4.0/agentfs-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/tursodatabase/agentfs/releases/download/v0.4.0/agentfs-installer.ps1 | iex"

Download agentfs 0.4.0