Mount.
See the whole box in Finder as a local volume, served live over the tunnel. Nothing is copied; the mount uses no disk space on your Mac.
Mount is experimental. The command works end to end, but a dropped connection unmounts rather than reconnecting, and details may change.
The model
prized mountwakes the box if it sleeps, mounts its home directory at
~/Prized/boxes/<box>, and opens the folder in Finder. Everything you see is
served live from the box: no sync, no local copy, no disk used. Press Ctrl-C
in the terminal to unmount.
It mounts as a real volume, so it also appears in the Finder sidebar under
Locations, named <box>.localhost. Ejecting it there unmounts and exits the
command, the same as Ctrl-C.
Mount and sync answer different questions:
| You want | Use |
|---|---|
| a working copy on your Mac, fast for builds and git | sync |
| to browse, preview, or grab anything on the box | mount |
A synced project is a mirrored folder pair that costs local disk and covers
one project. A mount is a live window over the whole box that costs nothing
locally, at the price of a network round trip per uncached operation. Browsing
folders, Quick Look, editing a file, and dragging files out all feel fine;
running builds or git status on a large repo against a mount does not. Keep
working sets in sync, and reach for mount when you need to see everything.
Usage
prized mount # the configured box
prized mount mango # any box on your account
prized mount --dir /var/log --read-only| Flag | What it does |
|---|---|
--dir | Export this box directory instead of the home directory. |
--at | Mount somewhere other than ~/Prized/boxes/<box>. |
--read-only | Serve a read-only view. |
--no-open | Skip opening the mounted folder in Finder. |
--mount-opt | Extra NFS mount options, comma-separated, appended verbatim. |
The command stays in the foreground while the volume is mounted. Ctrl-C unmounts and exits; closing the terminal does the same.
How it works
The mount is the stock macOS NFS client pointed 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 and no sudo is needed.
File bytes flow straight between Finder and the box; your Mac only ever holds
them in memory.
If the box suspends or the connection drops, the volume is unmounted so Finder never hangs on a dead mount. Run
prized mountagain to remount.
Troubleshooting
"mountpoint is not empty". Something is already at that path, usually a mount left by a previous run. Unmount it and try again:
umount ~/Prized/boxes/<box>"Operation not permitted" listing the folder in a terminal. macOS gates access to network volumes per application. Finder has that access; your terminal may not. Grant it Full Disk Access in System Settings under Privacy and Security, or use Finder for that folder.
Something unclear or out of date?
Sync
A synced project is one folder pair, ~/code/<name> on the box mirrored into a folder on your Mac. Edits land on the other side in under a second, both directions, .git included.
Ports
Start a server on the box and open it on your laptop as localhost, with no flags or config. Mirroring is on by default and takes a few seconds.