A proof-of-concept showing how to use FUSE to expose arbitrary data (in this case, emails from a database) as a filesystem for an AI agent.

Read the full writeup: FUSE is all you need

• A FUSE filesystem that maps email folders and messages from a database to files and directories
• A simple agent loop using the Anthropic Agent SDK that can navigate and organize emails via standard Unix commands

You'll need Docker

# Set your API key
export ANTHROPIC_API_KEY=sk-...

# Run it
pnpm start

This builds the container, mounts the FUSE filesystem at /workspace, seeds some example emails, and drops you into an agent chat.

src/
  main.ts          # Entry point: mounts FS, seeds DB, starts agent
  agent.ts         # Agent loop with Bash/Read/Glob tools
  db/              # Database schema and seed data (PGlite + Drizzle)
  fuse/
    ops/           # FUSE operations: readdir, read, rename, etc.
    helpers.ts     # Utilities for path parsing, virtual folders