CLI - Prized docs

The Prized CLI is a thin client over the Mac daemon and the box agent; add --help to any command for full flags. Every non-interactive command also takes --json and prints exactly one JSON object.

Commands

Command	What it does
`prized login`	Authenticate the CLI. Opens the dashboard to mint a token, then sets up your SSH identity.
`prized init`	Adopt the box on your account: write the config, install the SSH stanza, start the daemon.
`prized setup`	The whole onboarding in one pass: machine, health check, project sync (`[PATH]`, in place when the path is outside `~/Prized`; `--copy` syncs a copy under `~/Prized` instead; `--clone` clones the repo onto the box with no sync, so it never shows in `prized sync ls`), agent handoff (`--agent`, `--gh`, `--install-cursor`; agents you picked before are remembered, `--no-agents` opts out), detached session (`--start`). Safe to re-run; it converges instead of conflicting.
`prized up`	Start the box and reconnect everything, from cold. Reports paused syncs; `--resume` resumes them.
`prized ssh`	Connect to the box in a persistent tmux session. Wakes a suspended box first. Files dragged into the window upload to the box.
`prized mosh`	Same session over mosh: instant echo, survives roaming and sleep. Needs mosh installed locally.
`prized sync`	Add (`--local` syncs a folder of your own in place), list, pause, resume, flush, repair, and remove synced projects.
`prized mount`	Mount a box in Finder as a live volume until interrupted; nothing is copied locally. Experimental.
`prized agents ls`	One row per coding agent: installed and signed in on the Mac and the box, MCP servers, where it runs.
`prized agents handoff`	Copy the named agents' sign-in and MCP config to the box; `--gh` and `--install-cursor` extend it. One-shot; re-run after config changes.
`prized agents run`	Start an agent detached in a tmux session on the box: `--session`, `--dir`, `--attach`, `-- ARGS`.
`prized status`	Box, sync, ports, and daemon state at a glance. `--watch 2s` to keep it open.
`prized ports`	List box listeners and their mirror state; toggle a port on or off.
`prized proxy`	Forward one box port to localhost until interrupted.
`prized doctor`	Run the full health check. `--fix` applies the safe repairs.
`prized snapshot`	Snapshot the box disk without stopping it; `ls` lists snapshots, `restore` rolls back. Needs `[aws]` configured.
`prized resize`	Change the box size in place: pause syncs, stop, modify, start, resume. Needs `[aws]` configured.
`prized version`	Print client, daemon, and agent versions.
`prized update`	Update prized and the daemon in place from verified releases.
`prized daemon`	Manage the Mac daemon: install, uninstall, start, stop, restart, status, logs.
`prized agent upgrade`	Upgrade the agent on the box. It normally updates itself.
`prized mutagen ensure`	Fetch Prized's managed copy of Mutagen. The installer, `init`, and `doctor --fix` run it for you.

You can also create, resize, and delete boxes from the dashboard. See Boxes.

Global flags

Flag	What it does
`--json`	Machine output: exactly one JSON object on stdout. Interactive commands reject it.
`-y, --yes`	Assume yes for confirmations.
`-q, --quiet`	Suppress non-essential output.
`-v, --verbose`	Verbose output; repeat for wire detail on stderr.
`--timeout`	Per-request network timeout, default 10s.
`--no-color`	Disable ANSI color. `NO_COLOR` is honored too.

For agents and scripts

A failing --json command prints:

{ "ok": false, "error": { "code": "CHECK_FAILED", "message": "…", "hint": "…" } }

On success the object is {"ok": true, ...} with the payload inline. error.code maps 1:1 to the exit code, and both are a stable contract:

Exit	`error.code`	Meaning
0		Success.
1	`INTERNAL`, `AWS_ERROR`	Internal or unexpected error.
2	`USAGE`	Usage error.
3	`BOX_UNREACHABLE`	Box unreachable.
4	`DAEMON_UNAVAILABLE`	Daemon required but unavailable.
5	`CHECK_FAILED`	A precondition failed; the `hint` says what to do.
6	`CONFLICT`	Already exists: project name, port, config.
7	`PARTIAL`	A batch partly failed: some items of a `--all` run or an `agents handoff` succeeded, others did not.
8	`AUTH`	Not signed in or token rejected; run `prized login`.
9	`MISSING_DEP`	A dependency is missing; `prized doctor --fix` usually helps.
10	`DECLINED`	You declined a confirmation.
130		Interrupted.

prized ssh is the exception: after connecting, its exit code is whatever the remote command returned.

Sign-in without a browser: prized login --token dcp_… takes a CLI token minted in the dashboard directly, and is the only login form --json accepts. To hand a whole setup to an agent instead of scripting it yourself, see Agent setup. The docs themselves are mirrored as plain text at /llms.txt (index) and /llms-full.txt (full content) for agents to read.

Files

Path	What lives there
`~/.config/prized/config.toml`	The config: box name, sync projects, port policy, preferred agents (`[agents]`).
`~/.config/prized/`	CLI token, SSH identity, and per-box certificates.
`~/Prized/`	The default local twin of synced projects; one added with `--local` lives at its own path instead.
`~/.ssh/config.d/prized`	The SSH stanza that makes `ssh box-3fa9` work everywhere.
`~/Library/Logs/prized/`	Daemon logs.

An install that predates the rename keeps its old paths (~/.config/doppel, ~/Doppel, ~/.ssh/config.d/doppel) and everything keeps working; see doppel is now Prized.

Updates

prized update replaces the CLI and daemon in place from signed releases. prized status and prized version note when a newer release exists; the check is a cached, sub-second probe you can turn off with check = false under [update] in the config. If your installed CLI falls below the minimum the API supports, commands exit with code 5 and a prized update hint until you update.

Usage telemetry

When you are signed in, the CLI records which command ran, its version, OS, duration, and exit code, and sends those counts to Prized in occasional batches. It never records arguments, flags, paths, or file contents, and it sends nothing while you are signed out.

Turn it off either way:

# in ~/.config/prized/config.toml
[telemetry]
enabled = false

# or per shell
export PRIZED_NO_TELEMETRY=1

This switch covers the CLI only. For what the website and dashboard record, and how to turn that off, see Privacy.