runcloud 0.1.12 → 0.1.14

package/README.md

@@ -5,6 +5,10 @@ Create and control **remote mobile simulators** and **cloud sandboxes** from you
 - **Simulators** — boot real iOS simulators and Android emulators in the cloud, install your app, open deep links, and tunnel a local dev server into them.
 - **Sandboxes** — start a fresh, isolated Linux environment in seconds, run commands in it, snapshot a ready setup, and restore it later as a warm start.
 
+Everything the CLI creates also shows up at [run.cloud/dashboard](https://run.cloud/dashboard):
+
+![The run.cloud dashboard: fleet totals, reserved vCPU and memory, billed uptime, estimated spend, and recent sandboxes.](https://run.cloud/media/dashboard.png)
+
 ## Install
 
 ```bash
@@ -13,6 +17,13 @@ npm i -g runcloud
 
 Installs the `runcloud` binary. Requires **Node ≥ 20**.
 
+Or take the standalone binary — no Node, no sudo. It installs to `~/.run-cloud/bin`
+and hands the terminal to `runcloud login` when it finishes:
+
+```bash
+curl -fsSL https://run.cloud/install | sh
+```
+
 ## Log in
 
 ```bash
@@ -41,13 +52,27 @@ runcloud ios delete <id>                                   # release the session
 runcloud android create --model pixel
 ```
 
-Useful `create` flags: `--region`, `--display-name`, `--inactivity-timeout 3m`, `--hard-timeout 1h`, `--rm` (release when the command exits), `--json`.
+Useful `create` flags: `--region`, `--display-name`, `--inactivity-timeout 3m`,
+`--hard-timeout 1h`, `--install-asset <name-or-id>`, `--rm` (release when the
+command exits), `--json`.
 
 ### Tunnel a local dev server into a simulator
 
 ```bash
-runcloud tunnel <id> --service metro   # expose your local Metro/dev server to the remote iOS session
-runcloud tunnel-status
+runcloud ios tunnel <id> --local-port 8081   # expose local Metro to the remote session
+runcloud ios tunnel-status
+```
+
+### Reusable app assets
+
+Upload an app once, install it into as many sessions as you like:
+
+```bash
+runcloud asset push ./MyApp.app --name my-app
+runcloud asset list
+runcloud ios create --install-asset my-app
+runcloud asset pull <id> --output ./MyApp.app
+runcloud asset delete <id>
 ```
 
 ## Sandboxes
@@ -57,7 +82,8 @@ runcloud sandbox create                          # start a sandbox (default imag
 runcloud sandbox create --cpu 0.5 --memory 1024  # allocate CPU cores and memory in MiB
 runcloud sandbox create --disk 80                # request an 80 GiB root filesystem
 runcloud sandbox exec <id> npm run build         # run a command inside it
-runcloud sandbox logs <id> -n 200                # tail its logs
+runcloud sandbox shell <id>                      # interactive shell, streamed over the API
+runcloud sandbox logs <id> --lines 200           # tail its logs
 runcloud sandbox list
 runcloud sandbox rm <id>                          # destroy it
 ```
@@ -88,17 +114,21 @@ desktop without asking the browser to send your CLI credential.
 
 ### Persistence and a public hostname
 
-A sandbox pauses when idle by default. Turn persistence on with `--persistent`,
-and publish a guest port at a stable `<name>-box.run.cloud` hostname with
-`--expose`:
+A sandbox pauses when idle by default. Tune that with `--idle-pause <seconds>`,
+turn it off with `--persistent`, and publish a guest port at a stable
+`<name>-box.run.cloud` hostname with `--expose`:
 
 ```bash
+runcloud sandbox create --idle-pause 600                    # pause after 10 idle minutes
 runcloud sandbox create --name my-project --persistent      # never pauses
 runcloud sandbox create --name my-project --expose 3000     # persistent + https://my-project-box.run.cloud
 runcloud sandbox expose <id> --port 8080                    # expose later, or move the published port
 runcloud sandbox get <id>                                   # inspect, including the hostname
 ```
 
+`--expose` needs `--name` — that name is the hostname prefix, and it is fixed
+once minted.
+
 Exposed sandboxes support SSH, file transfer, VS Code, and custom domains:
 
 ```bash
@@ -147,10 +177,14 @@ runcloud android create --install ./run-cloud-sample-android.apk
 ## AI coding agents
 
 ```bash
-runcloud skills   # install run.cloud skills for AI coding agents
+runcloud skills install                    # install run.cloud skills into this project
+runcloud skills install --agents claude --scope global
 ```
 
-Every command accepts `--json` for scripting.
+Supported agents: `claude`, `codex`, `cursor`.
+
+Every command accepts `--json` for scripting. For programmatic use from
+TypeScript, see [`@run-cloud/sdk`](https://www.npmjs.com/package/@run-cloud/sdk).
 
 ## Credentials & environment
 

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.1.12';
+export const CLI_VERSION = '0.1.14';

package/package.json

@@ -1,8 +1,36 @@
 {
   "name": "runcloud",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Create and control run.cloud remote mobile simulators and cloud sandboxes",
   "license": "Apache-2.0",
+  "keywords": [
+    "runcloud",
+    "run-cloud",
+    "run cloud",
+    "run.cloud",
+    "ios-simulator",
+    "android-emulator",
+    "simulator",
+    "emulator",
+    "device-farm",
+    "device-cloud",
+    "mobile-testing",
+    "mobile-app-testing",
+    "ios-testing",
+    "android-testing",
+    "mobile-automation",
+    "cloud-testing",
+    "e2e-testing",
+    "sandbox",
+    "cloud-sandbox",
+    "code-sandbox",
+    "agent-sandbox",
+    "ai-sandbox",
+    "code-execution",
+    "code-interpreter",
+    "remote-execution",
+    "cli"
+  ],
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,9 +45,6 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "esbuild": "0.25.12",
-    "google-auth-library": "^9.15.0",
-    "tar": "^7.4.3",
     "ws": "^8.21.0"
   }
 }