@onkernel/cli 0.13.1 → 0.13.3

package/README.md

@@ -104,6 +104,32 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 - `--no-color` - Disable color output
 - `--log-level <level>` - Set log level (trace, debug, info, warn, error, fatal, print)
 
+## JSON Output
+
+Many commands support JSON output for scripting and automation. Use `--output json` or `-o json` to get machine-readable output:
+
+```bash
+# Get browser session details as JSON
+kernel browsers create -o json
+
+# List apps as JSON
+kernel app list -o json
+
+# Deploy with JSONL streaming output (one JSON object per line)
+kernel deploy index.ts -o json
+```
+
+Commands with JSON output support:
+- **Browsers**: `create`, `list`, `get`, `view`
+- **Browser Pools**: `create`, `list`, `get`, `update`, `acquire`
+- **Profiles**: `create`, `list`, `get`
+- **Extensions**: `upload`, `list`
+- **Proxies**: `create`, `list`, `get`
+- **Apps**: `list`, `history`
+- **Deploy**: `deploy` (JSONL streaming), `history`
+- **Invoke**: `invoke` (JSONL streaming), `history`
+- **Browser Sub-commands**: `replays list/start`, `process exec/spawn`, `fs file-info/list-files`
+
 ### Authentication
 
 - `kernel login [--force]` - Login via OAuth 2.0
@@ -134,6 +160,7 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `--force` - Allow overwriting existing version
   - `--env <KEY=VALUE>`, `-e` - Set environment variables (can be used multiple times)
   - `--env-file <file>` - Load environment variables from file (can be used multiple times)
+  - `--output json`, `-o json` - Output JSONL (one JSON object per line for each event)
 
 - `kernel deploy logs <deployment_id>` - Stream logs for a deployment
 
@@ -143,6 +170,7 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 
 - `kernel deploy history [app_name]` - Show deployment history
   - `--limit <n>` - Max deployments to return (default: 100; 0 = all)
+  - `--output json`, `-o json` - Output raw JSON array
 
 ### App Management
 
@@ -150,15 +178,19 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 
   - `--version <version>`, `-v` - Specify app version (default: latest)
   - `--payload <json>`, `-p` - JSON payload for the action
+  - `--payload-file <path>`, `-f` - Read JSON payload from a file (use `-` for stdin)
   - `--sync`, `-s` - Invoke synchronously (timeout after 60s)
+  - `--output json`, `-o json` - Output JSONL (one JSON object per line for each event)
 
 - `kernel app list` - List deployed apps
 
   - `--name <app_name>` - Filter by app name
   - `--version <version>` - Filter by version
+  - `--output json`, `-o json` - Output raw JSON array
 
 - `kernel app history <app_name>` - Show deployment history for an app
   - `--limit <n>` - Max deployments to return (default: 100; 0 = all)
+  - `--output json`, `-o json` - Output raw JSON array
 
 ### Logs
 
@@ -171,21 +203,26 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 ### Browser Management
 
 - `kernel browsers list` - List running browsers
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel browsers create` - Create a new browser session
   - `-s, --stealth` - Launch browser in stealth mode to avoid detection
   - `-H, --headless` - Launch browser without GUI access
   - `--kiosk` - Launch browser in kiosk mode
   - `--pool-id <id>` - Acquire a browser from the specified pool (mutually exclusive with --pool-name; ignores other session flags)
   - `--pool-name <name>` - Acquire a browser from the pool name (mutually exclusive with --pool-id; ignores other session flags)
+  - `--output json`, `-o json` - Output raw JSON object
   - _Note: When a pool is specified, omit other session configuration flags—pool settings determine profile, proxy, viewport, etc._
 - `kernel browsers delete <id>` - Delete a browser
   - `-y, --yes` - Skip confirmation prompt
 - `kernel browsers view <id>` - Get live view URL for a browser
+  - `--output json`, `-o json` - Output JSON with liveViewUrl
+- `kernel browsers get <id>` - Get detailed browser session info
+  - `--output json`, `-o json` - Output raw JSON object
 
 ### Browser Pools
 
 - `kernel browser-pools list` - List browser pools
-  - `-o, --output json` - Output raw JSON response
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel browser-pools create` - Create a browser pool
   - `--name <name>` - Optional unique name for the pool
   - `--size <n>` - Number of browsers in the pool (required)
@@ -193,14 +230,17 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `--timeout <seconds>` - Idle timeout for browsers acquired from the pool
   - `--stealth`, `--headless`, `--kiosk` - Default pool configuration
   - `--profile-id`, `--profile-name`, `--save-changes`, `--proxy-id`, `--extension`, `--viewport` - Same semantics as `kernel browsers create`
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browser-pools get <id-or-name>` - Get pool details
-  - `-o, --output json` - Output raw JSON response
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browser-pools update <id-or-name>` - Update pool configuration
   - Same flags as create plus `--discard-all-idle` to discard all idle browsers in the pool and refill at the specified fill rate
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browser-pools delete <id-or-name>` - Delete a pool
   - `--force` - Force delete even if browsers are leased
 - `kernel browser-pools acquire <id-or-name>` - Acquire a browser from the pool
   - `--timeout <seconds>` - Acquire timeout before returning 204
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browser-pools release <id-or-name>` - Release a browser back to the pool
   - `--session-id <id>` - Browser session ID to release (required)
   - `--reuse` - Reuse the browser instance (default: true)
@@ -217,12 +257,14 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 ### Browser Replays
 
 - `kernel browsers replays list <id>` - List replays for a browser
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel browsers replays start <id>` - Start a replay recording
   - `--framerate <fps>` - Recording framerate (fps)
   - `--max-duration <seconds>` - Maximum duration in seconds
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browsers replays stop <id> <replay-id>` - Stop a replay recording
 - `kernel browsers replays download <id> <replay-id>` - Download a replay video
-  - `-o, --output <path>` - Output file path for the replay video
+  - `-f, --output-file <path>` - Output file path for the replay video
 
 ### Browser Process Control
 
@@ -233,6 +275,7 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `--timeout <seconds>` - Timeout in seconds
   - `--as-user <user>` - Run as user
   - `--as-root` - Run as root
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browsers process spawn <id> [--] [command...]` - Execute a command asynchronously
   - `--command <cmd>` - Command to execute (optional; if omitted, trailing args are executed via /bin/bash -c)
   - `--args <args>` - Command arguments
@@ -240,6 +283,7 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `--timeout <seconds>` - Timeout in seconds
   - `--as-user <user>` - Run as user
   - `--as-root` - Run as root
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browsers process kill <id> <process-id>` - Send a signal to a process
   - `--signal <signal>` - Signal to send: TERM, KILL, INT, HUP (default: TERM)
 - `kernel browsers process status <id> <process-id>` - Get process status
@@ -261,8 +305,10 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `-o, --output <path>` - Output zip file path
 - `kernel browsers fs file-info <id>` - Get file or directory info
   - `--path <path>` - Absolute file or directory path (required)
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel browsers fs list-files <id>` - List files in a directory
   - `--path <path>` - Absolute directory path (required)
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel browsers fs move <id>` - Move or rename a file or directory
   - `--src <path>` - Absolute source path (required)
   - `--dest <path>` - Absolute destination path (required)
@@ -343,8 +389,10 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 ### Extension Management
 
 - `kernel extensions list` - List all uploaded extensions
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel extensions upload <directory>` - Upload an unpacked browser extension directory
   - `--name <name>` - Optional unique extension name
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel extensions download <id-or-name>` - Download an extension archive
   - `--to <directory>` - Output directory (required)
 - `kernel extensions download-web-store <url>` - Download an extension from the Chrome Web Store
@@ -356,8 +404,11 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 ### Proxy Management
 
 - `kernel proxies list` - List proxy configurations
+  - `--output json`, `-o json` - Output raw JSON array
 - `kernel proxies get <id>` - Get a proxy configuration by ID
+  - `--output json`, `-o json` - Output raw JSON object
 - `kernel proxies create` - Create a new proxy configuration
+  - `--output json`, `-o json` - Output raw JSON object
 
   - `--name <name>` - Proxy configuration name
   - `--type <type>` - Proxy type: datacenter, isp, residential, mobile, custom (required)
@@ -423,6 +474,15 @@ kernel invoke my-scraper scrape-page
 # With JSON payload
 kernel invoke my-scraper scrape-page --payload '{"url": "https://example.com"}'
 
+# Read payload from a file
+kernel invoke my-scraper scrape-page --payload-file payload.json
+
+# Read payload from stdin
+cat payload.json | kernel invoke my-scraper scrape-page --payload-file -
+
+# Pipe from another command
+echo '{"url": "https://example.com"}' | kernel invoke my-scraper scrape-page -f -
+
 # Synchronous invoke (wait for completion)
 kernel invoke my-scraper quick-task --sync
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/cli",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Kernel CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -34,75 +34,75 @@
   },
   "archives": {
     "darwin-arm64": {
-      "name": "kernel_0.13.1_darwin_arm64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_darwin_arm64.tar.gz",
+      "name": "kernel_0.13.3_darwin_arm64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_darwin_arm64.tar.gz",
       "bins": [
         "kernel"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "660a6f7dc37391e975185f9309b9cfd4c142a3997b72224855ce326a7733cc20"
+        "digest": "0df1539a228e90d2fc60aead8af93799f24361d08239cdc907fe1a306605f1d3"
       }
     },
     "darwin-x64": {
-      "name": "kernel_0.13.1_darwin_amd64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_darwin_amd64.tar.gz",
+      "name": "kernel_0.13.3_darwin_amd64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_darwin_amd64.tar.gz",
       "bins": [
         "kernel"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "19f8e2d330d3f1a54714b12267bf76220919a61c38f46aa2d33087b1fbef49d5"
+        "digest": "6d855018dbeac070979124c3cf6a9221574dd9c2cb5ccc3bd6d8f8d4745fa2a3"
       }
     },
     "linux-arm64": {
-      "name": "kernel_0.13.1_linux_arm64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_linux_arm64.tar.gz",
+      "name": "kernel_0.13.3_linux_arm64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_linux_arm64.tar.gz",
       "bins": [
         "kernel"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "18581682ac0161ed045366960e0d7bcc0baf8fb72f1ed57a80ad16c44fd8d471"
+        "digest": "25692da0b0f9d439c488257e3560599c542bbfbb229e51286dccbc7bcc7aab9b"
       }
     },
     "linux-x64": {
-      "name": "kernel_0.13.1_linux_amd64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_linux_amd64.tar.gz",
+      "name": "kernel_0.13.3_linux_amd64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_linux_amd64.tar.gz",
       "bins": [
         "kernel"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "948e2494b099ae491ef744b8d21ec5b892ebb5488723f1dd7751a8371ceb7a5a"
+        "digest": "c7515b33368a72907f2c023c6b70265372a7ba493ee89539bb34462c577f7456"
       }
     },
     "win32-arm64": {
-      "name": "kernel_0.13.1_windows_arm64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_windows_arm64.tar.gz",
+      "name": "kernel_0.13.3_windows_arm64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_windows_arm64.tar.gz",
       "bins": [
         "kernel.exe"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "8935da83ba9d6bd19ab795b221e168798c6fde215b89ec4a60d072669f4c6189"
+        "digest": "b738bd181fa6049e76affb7d718655bcc72ac0790a0acb93d97a27b1d67abbcd"
       }
     },
     "win32-x64": {
-      "name": "kernel_0.13.1_windows_amd64.tar.gz",
-      "url": "https://github.com/kernel/cli/releases/download/v0.13.1/kernel_0.13.1_windows_amd64.tar.gz",
+      "name": "kernel_0.13.3_windows_amd64.tar.gz",
+      "url": "https://github.com/kernel/cli/releases/download/v0.13.3/kernel_0.13.3_windows_amd64.tar.gz",
       "bins": [
         "kernel.exe"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "03635704a7823c768f6bb8707d79b7865671e41de292e85e905f1c36571915be"
+        "digest": "bfb46e97f0aea1ee4059f3ed83b7fcb148576474dc896c9fecd6d5fbbe611855"
       }
     }
   }