03 · Shared drives

Locus

Locus turns the Strand + Lens stack into something that looks like a filesystem: files, directories, mounts, watchers, journal-backed governance, and permission modes. The same model powers personal drives, shared workspaces, and sync targets.

Concepts

What you’re working with.

  • 01Files, directories, mounts on top of Strand.
  • 02Watchers + journal-backed governance.
  • 03Permission modes per path.
  • 04Sync targets — local-first, replicate where you choose.
Code

A handful of lines.

use locus::{Locus, MountConfig};

let drive = Locus::mount("team/notes", MountConfig::default()).await?;
drive.write("readme.md", b"# Off-chain").await?;
let mut watch = drive.watch("/").await?;
while let Some(evt) = watch.next().await {
    println!("changed: {:?}", evt.path);
}

Ready to build?

Start with the SDK or load the agent context. Every library is independently documented and versioned.