What is agent-share
agent-share shares a folder with peers. A peer mounts that folder on its own machine and reads it like a local directory. The mount is read-only.
The producer serves file bytes on demand over an iroh QUIC connection. The consumer mounts them through a loopback NFSv3 bridge. The bridge uses the built-in NFS client of the operating system, so there is no FUSE and no kernel extension.
No server, no daemon
The two peers connect directly. There is nothing to host and no account to
create. agent-share serve runs until you stop it. The mount stays until you
press Ctrl-C.
Lazy and live
Serve scans the folder for metadata only. Nothing is hashed or sent before a peer reads it. When a peer reads a file, it fetches only the byte ranges that it reads.
The producer watches the folder. Edits, new files and deletions reach connected peers without a remount.
Both ends must run agent-share. It uses its own QUIC ALPN, so it does not mount against other tools.
Three ways to consume a share
- The native binary mounts the share as a filesystem on macOS and Linux.
- The webapp opens the share in a browser tab, with no install.
npx agent-sharewrites the files into a local folder, with no native binary.
Features
The two peers connect directly. No server to host, no account to create.
🕸️Peer to peerBytes move over iroh QUIC, or WebRTC in a browser. Both are encrypted.
🔐EncryptedThe share mounts as a directory. grep it, open it in an editor, build against it.
📂Real folderThe built-in NFS client of the OS does the mount. No kernel extension, no daemon.
🧰No FUSEA peer fetches only the byte ranges that it reads, when it reads them.
⚡LazyEdits, new files and deletions reach connected peers without a remount.
🔄LiveA consumer cannot change the files of the producer. Every write fails.
🔒Read-onlyWith a password, the ticket finds the share but does not open it.
🔑Password-protectedDownload the full tree, verified against the origin, and serve it as a second source.
🪞MirrorOpen a share in the webapp, or create one from a folder. No install, no backend.
🌐Browsernpx agent-share writes the files into a local folder, with no native binary.
The webapp publishes its actions as WebMCP tools, so an agent can drive it.
🤖WebMCPThe local network over mDNS, the internet over the DHT and relays.
🌍Multi-machineMount works on macOS and Linux. Other platforms can serve.
💻macOS and Linux