{
  "id": "knowledge-fabric-impl:supermemory.smfs",
  "_kind": "KnowledgeFabricImpl",
  "_file": "agent-stack/supermemory/supermemory-smfs.yaml",
  "_cluster": "agent-stack",
  "attributes": {
    "displayName": "SMFS -- Semantic Memory File System",
    "agentVersionId": "agentVersion:supermemory:current",
    "fabricKind": "filesystem-backed-semantic",
    "description": "Filesystem interface that exposes Supermemory containers as mountable\ndirectories. Agents interact with memory using standard POSIX operations\n(ls, cat, grep, echo >) without SDK integration or embedding knowledge.\ngrep is transparently upgraded to semantic search when called without\nflags. cat profile.md returns a live-synthesized digest of all container\nmemories. Written in pure Rust (forbidden unsafe), uses NFS on macOS\nand FUSE on Linux. Collapses four moving parts (vector DB, memory\nservice, profile store, SDK) into a single mount point.\n",
    "keyFiles": [
      "smfs binary (Rust 1.80+)",
      "@supermemory/bash (TypeScript virtual bash tool)",
      "supermemory-bash (Python virtual bash tool)"
    ],
    "mountBackends": [
      "NFS (macOS default)",
      "FUSE (Linux containers, requires /dev/fuse + SYS_ADMIN)"
    ],
    "coreCommands": [
      "smfs mount <tag> -- mount container as directory",
      "smfs grep 'query' -- semantic search (no flags) or exact match (with flags)",
      "smfs login -- one-time credential storage",
      "smfs unmount <tag> -- unmount and drain pending writes"
    ],
    "memoryPaths": "Only files under designated memory paths undergo semantic indexing.\n--memory-paths flag configures which paths are processed. Trailing\nslash = recursive folder match. No trailing slash = exact file match.\n",
    "syncBehavior": "Local changes upload asynchronously. Remote changes sync every 30s\nby default. --sync-interval adjusts pull timing. --no-sync disables\npulling while preserving uploads.\n",
    "benchmarkResults": {
      "xAFS_accuracy_10k_files": "81% vs 69% baseline",
      "cost_reduction": "55% cheaper ($946 vs $2,103)",
      "token_reduction": "53.8% fewer tokens",
      "claude_specific": "-66% tokens, -60% tool calls"
    },
    "virtualBashTool": "For serverless environments (Lambda, Workers, Vercel), the\n@supermemory/bash package provides identical semantics without\nfilesystem mounting. createBash() returns a tool with exec() method.\n",
    "ourEquivalent": "No direct equivalent. Our memory is accessed through explicit API calls\n(queryMemories, extractMemoriesFromSession). SMFS's transparent\nfilesystem approach is the primary integration opportunity -- agents\ncan write to memory paths without knowing they are using a memory\nsystem. The virtual bash tool maps naturally to our tool injection\nmodel in the genty runtime.\n"
  },
  "outgoingEdges": [
    {
      "from": "knowledge-fabric-impl:supermemory.smfs",
      "to": "layer:12-knowledge-fabric",
      "kind": "realizes",
      "attributes": {}
    },
    {
      "from": "knowledge-fabric-impl:supermemory.smfs",
      "to": "agent:supermemory",
      "kind": "part_of",
      "attributes": {}
    },
    {
      "from": "knowledge-fabric-impl:supermemory.smfs",
      "to": "tool:smfs-mount",
      "kind": "integrates_with",
      "attributes": {}
    },
    {
      "from": "knowledge-fabric-impl:supermemory.smfs",
      "to": "tool:supermemory-bash",
      "kind": "integrates_with",
      "attributes": {}
    }
  ],
  "incomingEdges": []
}