Mount.

Mount is experimental and macOS-only: it is built on the stock macOS NFS client, so on Linux and Windows the command refuses and points at sync and prized ssh instead. A dropped connection unmounts rather than reconnecting.

Usage

prized mount                                # the configured box
prized mount mango                          # any box on your account
prized mount --dir /var/log --read-only     # one directory, read-only
prized mount --detach                       # in the background; the command returns
prized unmount                              # stop the mount and detach the volume

prized mount wakes the box if it sleeps, mounts its home directory at ~/Prized/boxes/<box>, and opens it in Finder, where it also appears under Locations as <box>.localhost. The command stays in the foreground; Ctrl-C, closing the terminal, or ejecting in Finder unmounts.

In the background

prized mount --detach          # mounted prized-1 at ~/Prized/boxes/prized-1 in the background (pid 4242)
prized unmount                 # unmounted ~/Prized/boxes/prized-1

prized mount --detach hands the volume to a background process and returns once the folder is mounted; the mount outlives the terminal. prized unmount [BOX] stops that process and detaches the folder, and works on a foreground mount in another terminal too. One mount per box: a second prized mount reports where it is mounted and the pid serving it. A background mount logs to ~/Library/Logs/prized/mount-<box>.log; --json works with --detach and prized unmount.

Mount or sync?

A synced project is a mirrored folder pair: local disk, one project, fast. A mount is a live window over the whole box with a network round trip per uncached operation: browsing, Quick Look, and editing a file feel fine; builds or git status on a large repo do not.

How it works

The stock macOS NFS client points at a server the CLI runs on 127.0.0.1, whose backend is an SFTP session to the box over the same tunnel prized ssh uses. Nothing kernel-side is installed, no sudo is needed, and your Mac holds file bytes only in memory.

That local server does not authenticate its clients, so on a Mac you share with other user accounts treat a mount as readable by them: export a narrower --dir, add --read-only, and prized unmount when you are done.

If the box suspends or the connection drops, the volume is unmounted so Finder never hangs; run prized mount again to remount.

Troubleshooting

• "already mounted at ... (pid N)": the box is being served elsewhere; prized unmount <box> stops it.
• "mountpoint is not empty": a mount left by a previous run; umount ~/Prized/boxes/<box> and try again.
• "Operation not permitted" listing the folder in a terminal: grant your terminal Full Disk Access (System Settings > Privacy and Security), or use Finder.
• "secure sftp helper failed (update prized-agent on the box)": the box's agent predates the mount helper; update it and try again.