Reference · the tools · boxes

What it does

Request a new box, within its account's limit: a machine, about six minutes. It belongs to an account: the user's own, or a family or organization they are an admin of, which pays for it. By default it is the account of their current box (or of session_box); ASK THE USER WHICH ACCOUNT before creating, as you ask the name and the price, and say it back. The name is a label -- "dev" becomes dev-<handle>.<domain>; blank is your default box, <handle>.<domain>. Ask the user what to call it and say the address. Refused past the limit: destroy a box first, or ask for the limit to be raised. The size is its memory in GB, within a kind -- shared unless the user wants another; say the price when asking. Shared (kind "shared"; CPUs shared with other machines: fine for bursts of work, the usual choice): 4 GB ($49/month, tight), 8 GB ($99/month, tight), 16 GB ($149/month), 32 GB ($249/month), 64 GB ($449/month). Dedicated CPU (kind "dedicated"; The same memory with twice the CPUs, none of them shared: for long builds and heavy tests): 4 GB ($89/month, tight), 8 GB ($129/month, tight), 16 GB ($199/month), 32 GB ($349/month), 64 GB ($649/month). High memory (kind "highmem"; The most memory for the money, for many bundles at once. Few CPUs, so builds are slower, and a smaller disk): 48 GB ($179/month, tight), 90 GB ($299/month), 150 GB ($549/month). 16 GB shared when not given. The bigger sizes may need our provider's approval first: such a box shows as awaiting approval, costs nothing, and may be destroyed freely. A box has its own SSH keys, env vars and Claude settings (set on its page: the Settings and Env vars tabs); it starts with all three copied from copy_from -- another box of yours in any account, or your named box settings (kept with no box, on the Settings page) -- or, when not given, from your first other box in its account, else your first box anywhere.

What it needs to know

label · optional

The label, or empty for the default box.

size · optional

Memory in GB, one of the sizes offered in its kind. Optional. One of 4, 8, 16, 32, 64, 48, 90, 150.

kind · optional

shared (the default), dedicated (CPUs nobody else uses) or highmem (the most memory, few CPUs). Optional. One of shared, dedicated, highmem.

copy_from · optional

What to set it up like: another box of yours in any account ("home.frank"), or the name of your box settings ("dev"). A box is looked for first. Its SSH keys, env vars and Claude settings are copied, and its workspaces are made on the new box: each one's name, agent, limits and Claude repo and branch -- never its sign-in, so each is signed in on the new box. Codex workspaces are kept, not made yet (coming soon). Optional.

account · optional

Whose box: "me" (the user's own), or a family's or organization's name ("hemlane"). Optional: the account of the current box.

session_box · optional

The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On your account. It needs no box; it is how boxes come to exist and be found.