Skip to main content

Documentation Index

Fetch the complete documentation index at: https://supermemory.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
1. Install the binary

curl -fsSL https://smfs.ai/install | bash
Drops smfs into ~/.local/bin. Works on macOS (arm64, x64) and Linux (arm64, x64). If smfs isn’t on your PATH after install, add ~/.local/bin to your shell profile and reopen the terminal.

​
2. Log in

smfs login
One-time. Prompts you for your Supermemory API key and stores it in your global credentials. Get a key at console.supermemory.ai. You can also pass the key directly: 
smfs login --key sm_...

​
3. Mount a container

smfs mount agent_memory
agent_memory is your container tag. SMFS creates a folder named agent_memory/ in the current directory and mounts the container there. That’s it. Read it with ls, cat, grep. See Mount for memory paths, sync modes, flags, and every subcommand. To mount somewhere else, pass --path: 
smfs mount agent_memory --path ~/memory

​
Optional: refresh the semantic grep wrapper

smfs mount installs the shell wrapper automatically the first time you mount. If you ever need to force a clean reinstall (after upgrading the binary, for example): 
smfs init
It writes the wrapper into your ~/.zshrc directly. Then reopen your terminal (or source ~/.zshrc) so the new shell picks it up. Inside any mount, plain grep becomes semantic. Outside a mount, your normal grep is untouched. Pass any flag (grep -r, grep -i, anything) and you get the real grep back.

​
Refresh the binary

If anything ever feels broken: 
smfs install
Re-copies the binary into ~/.local/bin and resets permissions.