unison-fs

Mount the Unison brain as a real local directory (FUSE on Linux, NFS on macOS) and search it semantically with sgrep - agents that understand files need no integration at all.

unison-fs

unison-fs mounts the brain as a real local directory - FUSE on Linux, embedded NFS on macOS (no kernel extension) - with a local SQLite cache and background sync. Editors, scripts, and agents that already understand files work without any integration.

curl -fsSL https://raw.githubusercontent.com/unison-labs-ai/unison-fs/main/install.sh | bash

unisonfs login                          # or: export UNISON_TOKEN=usk_live_...
unisonfs mount ~/brain
ls ~/brain/private/notes/
echo "# My Note" > ~/brain/private/notes/idea.md    # write syncs to the brain
sgrep "auth decisions"                  # semantic search from anywhere
unisonfs unmount ~/brain                # drains the push queue

Headless / CI

unisonfs provision --email agent@example.com   # OTP by email, no browser
unisonfs mount ~/brain

Rust 1.80+ to build from source. The mounted tree mirrors the path namespaces - /private/, /workspace/, plus read-only /system/. Conflicts surface as stale-hash errors rather than silent overwrites, same as the API contract.

On this page