supermemoryai/smfs

What it solves

일반적으로 API를 통해 액세스하는 Supermemory 컨테이너 스토리지를 로컬 파일 시스템으로 노출합니다. 이를 통해 사용자와 AI 에이전트가 커스텀 API 통합 코드를 작성할 필요 없이 표준 Unix 도구(ls, cat, grep 등)와 에디터를 사용하여 메모리 데이터와 상호작용할 수 있습니다.

How it works

이 프로젝트는 두 가지 주요 액세스 방법을 제공합니다:

1. Filesystem Mount: 커널이 있는 환경(macOS, Linux, Docker)에서는 FUSE 또는 NFS를 사용하여 Supermemory 컨테이너를 실제 로컬 디렉터리로 마운트합니다. 변경 사항은 양방향으로 동기화됩니다: 로컬 쓰기는 클라우드로 업로드되고, 원격 변경 사항은 30초마다 가져옵니다.
2. Virtual Bash Tool: 로컬 파일 시스템이이 없는 서버리스 또는 에지 환경(Cloudflare Workers, 브라우저 에이전트)에서는 bash 환경을 시뮬레이션하는 TypeScript 패키지(@supermemory/bash)를 제공하여, 에이전트가 Unix 명령 및 시맨틱 검색을을 수행할 수 있게 합니다.

또한, 마운트 내부에서 표준 grep 명령어를 오버라이드하여, 단순한 문자열 매칭이 아닌 Supermemory의 인덱스를 통한 시맨틱 검색을 수행하도록 하는 쉘 래퍼(shell wrapper)가 포함되어 있습니다.

Who it’s for

• Developers：AI 메모리 컨테이너를 로컬 폴더처럼 관리하고 싶은 개발자.
• AI Agent creators：AI 에이전트에게 장기 메모리를 읽고, 쓰고, 검색할 수 있는 친숙한 Unix-like 인터페이스를 제공하고 싶은 제작자.

Who it’s for

• Developers：AI 메모리 컨테이너를 로컬 폴더처럼 관리하고 싶은 개발자.
• AI Agent creators：

Highlights

• Semantic Grep: 마운트 내에서 사용 시 표준 grep command를 시맨틱 검색 도구로 변환합니다.

• Semantic Grep: 마운트 내에서 사용 시 표준 grep command를를 수행합니다.

• Bidirectional Sync: 로컬 마운트와 Supermemory 클라우드 간의 자동 백그라운드 동기화.

• Flexible Runtimes: 네이티브 OS 마운트와 서버리스/에지 함수를 위한 가상화된 bash 환경을 모두 지원합니다.

• Configurable Memory Paths: 사용자가 마운트 내의 어떤 디렉터리 또는 파일이 시맨틱 인덱싱을 위한 메모리 파이프라인에 의해 처리될지 지정할 수 있습니다.