# Overview

> Prized gives you a dedicated Linux box in the cloud. Your files appear in a folder on your machine, box ports appear on your localhost, and terminal sessions survive closing the laptop.

URL: https://prized.dev/docs

## How it works [#how-it-works]

You edit and run everything on the box over SSH. Three things tie it to your laptop:

* **Sync.** A folder on your machine mirrors `~/code/<name>` on the box, both ways, .git included.
* **Ports.** A dev server you start on the box shows up on your laptop's localhost within seconds.
* **Sessions.** Your shell runs in tmux on the box, so a closed lid ends the connection, not the work.

## The pieces [#the-pieces]

| Piece          | What it is                                                                                                                  |
| -------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `prized`       | The CLI on your laptop (macOS, Linux, or Windows).                                                                          |
| `prizedd`      | A background daemon on your machine. Runs sync and mirrors box ports onto localhost.                                        |
| `prized-agent` | A service on the box. Finds listening ports, reports vitals, lists tmux sessions.                                           |
| Dashboard      | [prized.dev](https://prized.dev/dashboard). Create boxes, watch their state, manage billing; every screen is on [Dashboard](https://prized.dev/docs/dashboard). |

## What's on the box [#whats-on-the-box]

Ubuntu, with root. Preinstalled: Docker (compose and buildx), git, tmux, mosh, ripgrep, jq, the GitHub CLI, Claude Code, and Codex; Cursor's CLI installs on demand; the full inventory, sizes, and disks are on [Machines](https://prized.dev/docs/machines). `prized setup` hands your own agent sign-ins over from your machine, so nothing on the box needs a fresh OAuth flow. See [Credentials](https://prized.dev/docs/credentials).

## For agents [#for-agents]

Every page here is also plain Markdown: add `.md` to its URL (this page is [/docs.md](https://prized.dev/docs.md)), or request the page URL with `Accept: text/markdown`. The buttons under each title copy the page as Markdown or open it in ChatGPT, Claude, or Cursor.

* **Index.** [/llms.txt](https://prized.dev/llms.txt) lists every page with a one-line summary, in this order.
* **Everything.** [/llms-full.txt](https://prized.dev/llms-full.txt) is the whole set in one file.
* **Search.** `GET /api/search?query=<words>` returns JSON hits, each with the page URL and the matching heading or paragraph.
* **Setup.** To let an agent install and set Prized up for you, paste the prompt on [Agent setup](https://prized.dev/docs/agent-setup).

## All pages [#all-pages]

The same groups as the sidebar.

### Get started [#get-started]

- [Quickstart](https://prized.dev/docs/quickstart): Signup to a synced project in about five minutes.
- [Agent setup](https://prized.dev/docs/agent-setup): One prompt that lets your coding agent do the setup.
- [Bring your environment](https://prized.dev/docs/environment): Your shell, toolchains, CLIs, Docker images, and databases, moved with a few yes or no questions.

### Connect [#connect]

- [Sync](https://prized.dev/docs/sync): Two-way file sync between the box and your machine.
- [Mount](https://prized.dev/docs/mount): The whole box in Finder, nothing copied.
- [Ports](https://prized.dev/docs/ports): Servers on the box appear on your localhost.
- [Sessions](https://prized.dev/docs/sessions): Terminal sessions that survive a closed lid.
- [Run commands and files](https://prized.dev/docs/exec): Run a command, leave one running, or copy files, from the CLI or any script.
- [Desktop](https://prized.dev/docs/desktop): A Linux desktop, or a single Chrome window, from the box in your browser.

### Agents [#agents]

- [Agents](https://prized.dev/docs/agents): Claude Code, Codex, or Cursor working on the box overnight.
- [Prompt an agent remotely](https://prized.dev/docs/remote-agents): Send the box's agent a prompt from your machine, follow it, interrupt it.
- [Codex remote](https://prized.dev/docs/codex): The ChatGPT desktop app running Codex tasks on your box.
- [Claude Desktop remote](https://prized.dev/docs/claude-desktop): The Claude desktop app pointed at your box over SSH.

### Boxes [#boxes]

- [Boxes](https://prized.dev/docs/boxes): Create, pause, resize, snapshot, and delete boxes.
- [Machines](https://prized.dev/docs/machines): Sizes, disk, Ubuntu 24.04, and what is preinstalled.
- [Snapshots](https://prized.dev/docs/snapshots): Snapshot, restore, fork, templates, and schedules.
- [Environments](https://prized.dev/docs/environments): What a new box inherits: repos, a setup script, vars, secret files.
- [Credentials](https://prized.dev/docs/credentials): Git, cloud, and model credentials live on your box.
- [Connectors](https://prized.dev/docs/connectors): Brokered credentials mounted into a box, never written to its disk.
- [AWS access](https://prized.dev/docs/aws): An IAM role every box assumes with a short-lived identity token. No keys, no login.

### Reference [#reference]

- [CLI](https://prized.dev/docs/cli): Every prized command, flag, and exit code.
- [API reference](https://prized.dev/docs/api): Every HTTP route a CLI token can call.
- [Dashboard](https://prized.dev/docs/dashboard): Every screen in the web app, and where each setting lives.

### Account [#account]

- [Workspaces](https://prized.dev/docs/workspaces): One account for the whole team; join by email domain or invite link.
- [Teams](https://prized.dev/docs/teams): Roles, policies, quiet hours, the audit log, scoped secrets, and live activity for a shared workspace.
- [Billing](https://prized.dev/docs/billing): Monthly plans, hourly rates, and the balance your plan refills.
- [Limits](https://prized.dev/docs/limits): Every hard cap a box or a workspace can hit, and how a refusal reads.
- [Data retention](https://prized.dev/docs/data-retention): What pausing, deleting, and closing keep and remove.

### Support [#support]

- [Troubleshooting](https://prized.dev/docs/troubleshooting): prized doctor and fixes for the common failures.
- [Security and trust](https://prized.dev/docs/security): How a box is reached, what Prized can and cannot see, and how to report a problem.
- [Privacy](https://prized.dev/docs/privacy): What Prized records about your usage, and what it never records.