smfs
A filesystem designed for agents, with SOTA retrieval, automatic memory profiles, sync engine. Drop any file type (pdf, images, videos), and grep through them.
What is smfs?
A filesystem designed for agents, with SOTA retrieval, automatic memory profiles, sync engine. Drop any file type (pdf, images, videos), and grep through them.
Overview of smfs
What it is
smfs is a filesystem designed for agents, with SOTA retrieval, automatic memory profiles, and a sync engine. It exposes Supermemory containers as a local directory, allowing users to drop any file type (PDF, images, videos) and grep through them. Two access flows exist: mount it as a real local folder (works on macOS, Linux, devcontainers, Codespaces, Docker, microVMs) or plug the virtual bash tool into an agent's tool-set via a TypeScript package for runtimes without a local filesystem (Cloudflare Workers, serverless functions, edge runtimes, browser-based agents).
Key features
- Mount Supermemory containers as real local directories using FUSE (Linux) or NFS (macOS).
- Semantic search via plain
grepinside mounts after runningsmfs init; flagless grep is semantic, flagged grep is literal. - Memory generation paths: only files under specified paths are processed by Supermemory's memory pipeline for structured facts.
- Virtual bash tool (
@supermemory/bash) for AI agents in environments without a local filesystem. - Automatic sync: local writes upload in the background; remote changes pull every 30 seconds.
- Supports any file type (PDF, images, videos) and grep through them.
- Self-install via curl, supports macOS (arm64, x64) and Linux (arm64, x64).
Use cases
smfs is intended for AI agents that need to read and write memory like a local directory. It can be used by editors, scripts, and any tool that reads files. It also suits runtimes with no local filesystem, such as Cloudflare Workers, serverless functions, edge runtimes, and browser-based agents.
Getting started
shcurl -fsSL https://smfs.ai/install | bashsmfs login # one-time, stores your API keysmfs mount agent_memory # mounts the container tag at ./agent_memory/ls agent_memory/cat agent_memory/memory/notes.mdsmfs unmount agent_memory
License and pricing
The license is MIT. The project is open source (pricing_type: open_source). No other pricing information is stated.
Based on the project's public README and repository metadata.