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 grep inside mounts after running smfs 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/supermemoryaismfs.svg)](https://yunodb.com/tools/supermemoryaismfs?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/supermemoryaismfs?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/supermemoryaismfs.svg" alt="Featured on YunoDB" height="20"></a>