@onkernel/cli 0.4.11 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +98 -0
  2. package/package.json +19 -19
package/README.md CHANGED
@@ -106,17 +106,20 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
106
106
  ### App Management
107
107
 
108
108
  - `kernel deploy <file>` - Deploy an app to Kernel
109
+
109
110
  - `--version <version>` - Specify app version (default: latest)
110
111
  - `--force` - Allow overwriting existing version
111
112
  - `--env <KEY=VALUE>`, `-e` - Set environment variables (can be used multiple times)
112
113
  - `--env-file <file>` - Load environment variables from file (can be used multiple times)
113
114
 
114
115
  - `kernel invoke <app> <action>` - Run an app action
116
+
115
117
  - `--version <version>`, `-v` - Specify app version (default: latest)
116
118
  - `--payload <json>`, `-p` - JSON payload for the action
117
119
  - `--sync`, `-s` - Invoke synchronously (timeout after 60s)
118
120
 
119
121
  - `kernel app list` - List deployed apps
122
+
120
123
  - `--name <app_name>` - Filter by app name
121
124
  - `--version <version>` - Filter by version
122
125
 
@@ -141,6 +144,86 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
141
144
  - `-y, --yes` - Skip confirmation prompt
142
145
  - `kernel browsers view <id or persistent id>` - Get live view URL for a browser
143
146
 
147
+ ### Browser Logs
148
+
149
+ - `kernel browsers logs stream <id or persistent id>` - Stream browser logs
150
+ - `--source <source>` - Log source: "path" or "supervisor" (required)
151
+ - `--follow` - Follow the log stream (default: true)
152
+ - `--path <path>` - File path when source=path
153
+ - `--supervisor-process <name>` - Supervisor process name when source=supervisor. Most useful value is "chromium"
154
+
155
+ ### Browser Replays
156
+
157
+ - `kernel browsers replays list <id or persistent id>` - List replays for a browser
158
+ - `kernel browsers replays start <id or persistent id>` - Start a replay recording
159
+ - `--framerate <fps>` - Recording framerate (fps)
160
+ - `--max-duration <seconds>` - Maximum duration in seconds
161
+ - `kernel browsers replays stop <id or persistent id> <replay-id>` - Stop a replay recording
162
+ - `kernel browsers replays download <id or persistent id> <replay-id>` - Download a replay video
163
+ - `-o, --output <path>` - Output file path for the replay video
164
+
165
+ ### Browser Process Control
166
+
167
+ - `kernel browsers process exec <id or persistent id> [--] [command...]` - Execute a command synchronously
168
+ - `--command <cmd>` - Command to execute (optional; if omitted, trailing args are executed via /bin/bash -c)
169
+ - `--args <args>` - Command arguments
170
+ - `--cwd <path>` - Working directory
171
+ - `--timeout <seconds>` - Timeout in seconds
172
+ - `--as-user <user>` - Run as user
173
+ - `--as-root` - Run as root
174
+ - `kernel browsers process spawn <id or persistent id> [--] [command...]` - Execute a command asynchronously
175
+ - `--command <cmd>` - Command to execute (optional; if omitted, trailing args are executed via /bin/bash -c)
176
+ - `--args <args>` - Command arguments
177
+ - `--cwd <path>` - Working directory
178
+ - `--timeout <seconds>` - Timeout in seconds
179
+ - `--as-user <user>` - Run as user
180
+ - `--as-root` - Run as root
181
+ - `kernel browsers process kill <id or persistent id> <process-id>` - Send a signal to a process
182
+ - `--signal <signal>` - Signal to send: TERM, KILL, INT, HUP (default: TERM)
183
+ - `kernel browsers process status <id or persistent id> <process-id>` - Get process status
184
+ - `kernel browsers process stdin <id or persistent id> <process-id>` - Write to process stdin (base64)
185
+ - `--data-b64 <data>` - Base64-encoded data to write to stdin (required)
186
+ - `kernel browsers process stdout-stream <id or persistent id> <process-id>` - Stream process stdout/stderr
187
+
188
+ ### Browser Filesystem
189
+
190
+ - `kernel browsers fs new-directory <id or persistent id>` - Create a new directory
191
+ - `--path <path>` - Absolute directory path to create (required)
192
+ - `--mode <mode>` - Directory mode (octal string)
193
+ - `kernel browsers fs delete-directory <id or persistent id>` - Delete a directory
194
+ - `--path <path>` - Absolute directory path to delete (required)
195
+ - `kernel browsers fs delete-file <id or persistent id>` - Delete a file
196
+ - `--path <path>` - Absolute file path to delete (required)
197
+ - `kernel browsers fs download-dir-zip <id or persistent id>` - Download a directory as zip
198
+ - `--path <path>` - Absolute directory path to download (required)
199
+ - `-o, --output <path>` - Output zip file path
200
+ - `kernel browsers fs file-info <id or persistent id>` - Get file or directory info
201
+ - `--path <path>` - Absolute file or directory path (required)
202
+ - `kernel browsers fs list-files <id or persistent id>` - List files in a directory
203
+ - `--path <path>` - Absolute directory path (required)
204
+ - `kernel browsers fs move <id or persistent id>` - Move or rename a file or directory
205
+ - `--src <path>` - Absolute source path (required)
206
+ - `--dest <path>` - Absolute destination path (required)
207
+ - `kernel browsers fs read-file <id or persistent id>` - Read a file
208
+ - `--path <path>` - Absolute file path (required)
209
+ - `-o, --output <path>` - Output file path (optional)
210
+ - `kernel browsers fs set-permissions <id or persistent id>` - Set file permissions or ownership
211
+ - `--path <path>` - Absolute path (required)
212
+ - `--mode <mode>` - File mode bits (octal string) (required)
213
+ - `--owner <user>` - New owner username or UID
214
+ - `--group <group>` - New group name or GID
215
+ - `kernel browsers fs upload <id or persistent id>` - Upload one or more files
216
+ - `--file <local:remote>` - Mapping local:remote (repeatable)
217
+ - `--dest-dir <path>` - Destination directory for uploads
218
+ - `--paths <paths>` - Local file paths to upload
219
+ - `kernel browsers fs upload-zip <id or persistent id>` - Upload a zip and extract it
220
+ - `--zip <path>` - Local zip file path (required)
221
+ - `--dest-dir <path>` - Destination directory to extract to (required)
222
+ - `kernel browsers fs write-file <id or persistent id>` - Write a file from local data
223
+ - `--path <path>` - Destination absolute file path (required)
224
+ - `--mode <mode>` - File mode (octal string)
225
+ - `--source <path>` - Local source file path (required)
226
+
144
227
  ## Examples
145
228
 
146
229
  ### Deploy with environment variables
@@ -199,6 +282,21 @@ kernel browsers delete --by-persistent-id my-browser-session --yes
199
282
 
200
283
  # Get live view URL
201
284
  kernel browsers view --by-id browser123
285
+
286
+ # Stream browser logs
287
+ kernel browsers logs stream my-browser --source supervisor --follow --supervisor-process chromium
288
+
289
+ # Start a replay recording
290
+ kernel browsers replays start my-browser --framerate 30 --max-duration 300
291
+
292
+ # Execute a command in the browser VM
293
+ kernel browsers process exec my-browser -- ls -alh /tmp
294
+
295
+ # Upload files to the browser VM
296
+ kernel browsers fs upload my-browser --file "local.txt:remote.txt" --dest-dir "/tmp"
297
+
298
+ # List files in a directory
299
+ kernel browsers fs list-files my-browser --path "/tmp"
202
300
  ```
203
301
 
204
302
  ## Getting Help
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onkernel/cli",
3
- "version": "0.4.11",
3
+ "version": "0.5.0",
4
4
  "description": "Kernel CLI",
5
5
  "scripts": {
6
6
  "postinstall": "node install.js",
@@ -33,75 +33,75 @@
33
33
  },
34
34
  "archives": {
35
35
  "darwin-arm64": {
36
- "name": "kernel_0.4.11_darwin_arm64.tar.gz",
37
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_darwin_arm64.tar.gz",
36
+ "name": "kernel_0.5.0_darwin_arm64.tar.gz",
37
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_darwin_arm64.tar.gz",
38
38
  "bins": [
39
39
  "kernel"
40
40
  ],
41
41
  "format": "tar.gz",
42
42
  "checksum": {
43
43
  "algorithm": "sha256",
44
- "digest": "afb3b5876a6d226e29fe1510e73b6545af0c9dc7954aa7c82cb4c9259cb00a09"
44
+ "digest": "aeb716f6c351823b1ac3a679dafc7bde12874fcae324b26a383065aac56a9113"
45
45
  }
46
46
  },
47
47
  "darwin-x64": {
48
- "name": "kernel_0.4.11_darwin_amd64.tar.gz",
49
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_darwin_amd64.tar.gz",
48
+ "name": "kernel_0.5.0_darwin_amd64.tar.gz",
49
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_darwin_amd64.tar.gz",
50
50
  "bins": [
51
51
  "kernel"
52
52
  ],
53
53
  "format": "tar.gz",
54
54
  "checksum": {
55
55
  "algorithm": "sha256",
56
- "digest": "68e37e96ac938a00501a18e96fdb007f20c8a65d6d7e59bc807fbe8c6ec84fe5"
56
+ "digest": "9020bf76cd279e056f679e0cc416dd8c345cffa4154a43e157302a236c986cd6"
57
57
  }
58
58
  },
59
59
  "linux-arm64": {
60
- "name": "kernel_0.4.11_linux_arm64.tar.gz",
61
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_linux_arm64.tar.gz",
60
+ "name": "kernel_0.5.0_linux_arm64.tar.gz",
61
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_linux_arm64.tar.gz",
62
62
  "bins": [
63
63
  "kernel"
64
64
  ],
65
65
  "format": "tar.gz",
66
66
  "checksum": {
67
67
  "algorithm": "sha256",
68
- "digest": "a3f2e58c16ef8bb339c16f0ddca130c5c420d3f3a40ee4a07f7bd15b16ea2ff1"
68
+ "digest": "8f3485acacec01098eb46c6b7655ba2ad4993b37616978eebe7dbbfe2b581eb2"
69
69
  }
70
70
  },
71
71
  "linux-x64": {
72
- "name": "kernel_0.4.11_linux_amd64.tar.gz",
73
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_linux_amd64.tar.gz",
72
+ "name": "kernel_0.5.0_linux_amd64.tar.gz",
73
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_linux_amd64.tar.gz",
74
74
  "bins": [
75
75
  "kernel"
76
76
  ],
77
77
  "format": "tar.gz",
78
78
  "checksum": {
79
79
  "algorithm": "sha256",
80
- "digest": "7bf2be9e15decb600d314cbc27b319af2736ae0c6925df09c3e49c20cd6ef274"
80
+ "digest": "a1043af30a86f868403fbfe54ba3bd4c0549e0ff9b3c82caae6395de006ed2a8"
81
81
  }
82
82
  },
83
83
  "win32-arm64": {
84
- "name": "kernel_0.4.11_windows_arm64.tar.gz",
85
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_windows_arm64.tar.gz",
84
+ "name": "kernel_0.5.0_windows_arm64.tar.gz",
85
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_windows_arm64.tar.gz",
86
86
  "bins": [
87
87
  "kernel.exe"
88
88
  ],
89
89
  "format": "tar.gz",
90
90
  "checksum": {
91
91
  "algorithm": "sha256",
92
- "digest": "b75a637177a15a487b7b8905560cfec39371bba84b8449e2a0ff39b6b16b3213"
92
+ "digest": "34a1e1adb3104bbbae3fd8e813e120ceb0ca513c279fa52c3a7ebb06c394908f"
93
93
  }
94
94
  },
95
95
  "win32-x64": {
96
- "name": "kernel_0.4.11_windows_amd64.tar.gz",
97
- "url": "https://github.com/onkernel/cli/releases/download/v0.4.11/kernel_0.4.11_windows_amd64.tar.gz",
96
+ "name": "kernel_0.5.0_windows_amd64.tar.gz",
97
+ "url": "https://github.com/onkernel/cli/releases/download/v0.5.0/kernel_0.5.0_windows_amd64.tar.gz",
98
98
  "bins": [
99
99
  "kernel.exe"
100
100
  ],
101
101
  "format": "tar.gz",
102
102
  "checksum": {
103
103
  "algorithm": "sha256",
104
- "digest": "71c5dc40c8aba46c3d0c65fdc6cee19c969209c54177d4d7f52d304741eecadc"
104
+ "digest": "48f3a239067b4d0d2b37d151483dcc9875bea38f68a5ff16ef656e198b8f9bb1"
105
105
  }
106
106
  }
107
107
  }