Sessions.
Your shell runs on the box. A network drop or a closed lid ends the connection but not the session; reconnect and you are where you left off, running processes included.
Connect
prized sshThis lands in a persistent tmux session named main; run it again from anywhere and you attach to the same one. A suspended box wakes on connect. On Windows it runs the OpenSSH client that ships with Windows; mosh and dragging files in are not on Windows yet.
| Command | What it does |
|---|---|
prized ssh -s agents | Attach to, or create, a named session. Letters, digits, hyphens, and underscores; no dots. |
prized ssh --ls | List sessions. |
prized ssh --kill agents | Close a session. |
prized ssh --raw | A plain shell without tmux. |
prized ssh -- make test | Run one command and get its exit code back. |
prized agents run codex | Start a coding agent in a detached session, no laptop attached. See Agents. |
Sessions survive disconnects and closed lids. What they survive on a pause depends on the box size, and a busy session holds off auto-pause; see Pause and resume.
Mosh for flaky networks
brew install mosh # macOS; on Linux: sudo apt install mosh
prized moshThe same tmux session over UDP: keystrokes echo instantly, and the connection survives IP changes and laptop sleep. The box needs no public port; the traffic uses the SSH tunnel.
Drag files in
Drag a file from Finder (or your file manager) onto a prized ssh or prized mosh window and it lands on the box: the CLI uploads it over the tunnel into a fresh folder under ~/.prized/drops/ and pastes the box path instead of the local one. Drop a screenshot into Claude Code's prompt this way and the agent can open it.
- Size: one file or several per drop, up to 512 MB; drops older than 7 days are cleaned out.
- Only a paste that is nothing but local file paths is rewritten. If an upload fails, the original local path is pasted and the tmux status line says why.
- Off for one session with
--no-drop-upload, or for good withdrop_upload = falseunder[ssh]in the config.
Editors and other tools
- Your local editor on the synced folder. Saves to
~/Prized/myprojectland on the box in under a second. - Anything that speaks SSH.
prized setupinstalls an SSH config stanza, sossh box-3fa9, Cursor and VS Code Remote-SSH, scp, rsync, and git remotes all reach the box by hostname. The ChatGPT desktop app rides the same stanza (Codex remote); Claude Desktop rides it with a restricted device key Prized installs for you (Claude Desktop remote).
Something unclear or out of date?
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.
Run commands and files
Run a command on your box and get its exit code back, leave one running and check on it later, and copy files in either direction, from the CLI or from any script that holds a CLI token. Nothing to install on the box.