instavm 0.15.0 → 0.16.0

package/README.md

@@ -45,8 +45,11 @@ printf '%s' "$INSTAVM_API_KEY" | instavm auth set-key
 ```bash
 instavm whoami
 instavm ls
+instavm ls -a
 instavm create --type computer-use --memory 4096
 instavm connect vm_123
+instavm deploy
+instavm deploy --plan
 instavm snapshot ls
 instavm volume ls
 instavm volume files upload <volume_id> ./README.md --path docs/README.md
@@ -58,11 +61,43 @@ instavm doc
 instavm billing
 ```
 
+`instavm ls` shows active VMs only. Use `-a` or `--all` to include terminated VM records.
+
+### Cookbooks
+
+`instavm cookbook` pulls curated starter apps from the public [`instavm/cookbooks`](https://github.com/instavm/cookbooks) catalog, creates a VM, starts the service, creates the share, and returns the public URL.
+
+```bash
+instavm cookbook list
+instavm cookbook info neon-city-webgl
+instavm cookbook deploy neon-city-webgl
+instavm cookbook deploy hello-fastapi
+```
+
+The CLI syncs the cookbook repo into `~/.instavm/cookbooks/`, checks for `git`, `ssh`, `scp`, and `tar`, prompts for any required secrets, and auto-registers a local public SSH key if your account does not already have one.
+
+### Deploy
+
+`instavm deploy` tries to deploy the app in the current directory without asking you to create an `instavm.yaml` first. It detects a simple Node.js or Python web app, creates a VM, uploads the project, starts the service, and gives you a share URL.
+
+```bash
+instavm deploy
+instavm deploy --plan
+instavm deploy ./path/to/app
+```
+
+`--plan` shows the detected runtime, install command, start command, port, and secrets without creating a VM.
+
+`instavm deploy` is experimental right now. The zero-config path is working best for straightforward Node.js and Python apps. Some runtimes and projects still need follow-up fixes or backend support.
+
 ### Command Reference
 
 - `auth`: `set-key`, `status`, `logout`
 - `whoami`: show account details and SSH keys
-- `create`/`new`, `ls`/`list`, `rm`/`delete`, `clone`, `connect`: core VM workflows
+- `ls`/`list`: show active VMs by default; use `-a` or `--all` for all VM records
+- `cookbook`: `list`, `info`, `deploy` for curated starter apps from `instavm/cookbooks`
+- `deploy`: experimental zero-config deploy for the current app directory
+- `create`/`new`, `rm`/`delete`, `clone`, `connect`: core VM workflows
 - `snapshot`: `ls`, `create`, `build`, `get`, `rm`
 - `desktop`: `status`, `start`, `stop`, `viewer`
 - `volume`: `ls`, `get`, `create`, `update`, `rm`, `checkpoint`, `files`
@@ -93,6 +128,8 @@ console.log(vms.length);
 - [CLI](#cli)
   - [Auth & Config](#auth--config)
   - [Common Commands](#common-commands)
+  - [Cookbooks](#cookbooks)
+  - [Deploy](#deploy)
   - [Command Reference](#command-reference)
 - [Library Quick Start](#library-quick-start)
 - [Code Execution](#code-execution)
@@ -489,7 +526,17 @@ npm run build        # Build package
 
 ## Changelog
 
-Current package version: **0.15.0**
+Current package version: **0.16.0**
+
+### 0.16.0
+
+- Expanded CLI docs for `instavm cookbook`
+- Added experimental `instavm deploy` for zero-config app deploys from the current directory
+
+### 0.15.1
+
+- `ls` now matches the SSH gateway: active VMs by default, `-a` or `--all` for all VM records
+- `whoami` now uses the live `/v1/users/me` endpoint
 
 ### 0.15.0