emmy: Skill for Claude Code

Start Remote Server

Provision a fresh cloud GPU VM on the right provider (GCP or CloudRift) for the requested hardware, leave it running, and report back the SSH connection details so the user can run emmy deploy ssh ... or emmy bench --ssh ... against it later.

This skill does not deploy a recipe. To deploy + bench + teardown in one shot, use emmy deploy cloud or emmy bench directly — those handle their own VM lifecycle.

Preferred Path: emmy vm create gpu

For almost every request, use the GPU-name orchestrator command:

emmy vm create gpu \
  --gpu "<full GPU name>" \
  --gpu-count <N> \
  [--provider cloudrift|gcp] \
  [--name <prefix>] \
  [--ssh-key ~/.ssh/id_ed25519] \
  [--config config.yaml]

What this command does that the provider-specific commands do not:

• Resolves the GPU name to candidates from emmy/hardware.py::GPU_INSTANCE_TYPES automatically — you do not pass an instance type.
• Iterates candidates in preference order (every (provider, base) pair under the GPU key, all GCP zones from GPU_GCP_ZONES).
• Handles capacity fallback: on CapacityExhausted (HTTP 5xx, 409, "no capacity", "out of stock", "Service Unavailable") it advances to the next candidate. On transient errors it retries the same candidate.
• Cleans up orphans from failed attempts.
• Reads config.yaml for provider defaults (GCP image/disk/service account, CloudRift image override, etc.).
• Stops on terminal errors (auth 401/403, malformed 400, unknown instance type 404) without burning the candidate list.

--ssh-key is the PRIVATE key path for this command (default ~/.ssh/id_ed25519). The orchestrator appends .pub internally and also uses the private key to verify SSH reachability. This is different from vm create cloudrift (see Manual Overrides below), which requires the .pub path explicitly. Do not pass .pub to vm create gpu.

--provider is binding. If the user named a provider, pass it. If the GPU isn't offered by that provider, the orchestrator raises ValueError with the available providers — surface that to the user; do not silently substitute.