add demos

Author: rgarcia

README.md

@@ -106,17 +106,20 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
 ### App Management
 
 - `kernel deploy <file>` - Deploy an app to Kernel
+
   - `--version <version>` - Specify app version (default: latest)
   - `--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)
 
 - `kernel invoke <app> <action>` - Run an app action
+
   - `--version <version>`, `-v` - Specify app version (default: latest)
   - `--payload <json>`, `-p` - JSON payload for the action
   - `--sync`, `-s` - Invoke synchronously (timeout after 60s)
 
 - `kernel app list` - List deployed apps
+
   - `--name <app_name>` - Filter by app name
   - `--version <version>` - Filter by version
 
@@ -141,6 +144,86 @@ Create an API key from the [Kernel dashboard](https://dashboard.onkernel.com).
   - `-y, --yes` - Skip confirmation prompt
 - `kernel browsers view <id or persistent id>` - Get live view URL for a browser
 
+### Browser Logs
+
+- `kernel browsers logs stream <id or persistent id>` - Stream browser logs
+  - `--source <source>` - Log source: "path" or "supervisor" (required)
+  - `--follow` - Follow the log stream (default: true)
+  - `--path <path>` - File path when source=path
+  - `--supervisor-process <name>` - Supervisor process name when source=supervisor. Most useful value is "chromium"
+
+### Browser Replays
+
+- `kernel browsers replays list <id or persistent id>` - List replays for a browser
+- `kernel browsers replays start <id or persistent id>` - Start a replay recording
+  - `--framerate <fps>` - Recording framerate (fps)
+  - `--max-duration <seconds>` - Maximum duration in seconds
+- `kernel browsers replays stop <id or persistent id> <replay-id>` - Stop a replay recording
+- `kernel browsers replays download <id or persistent id> <replay-id>` - Download a replay video
+  - `-o, --output <path>` - Output file path for the replay video
+
+### Browser Process Control
+
+- `kernel browsers process exec <id or persistent id> [--] [command...]` - Execute a command synchronously
+  - `--command <cmd>` - Command to execute (optional; if omitted, trailing args are executed via /bin/bash -c)
+  - `--args <args>` - Command arguments
+  - `--cwd <path>` - Working directory
+  - `--timeout <seconds>` - Timeout in seconds
+  - `--as-user <user>` - Run as user
+  - `--as-root` - Run as root
+- `kernel browsers process spawn <id or persistent 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
+  - `--cwd <path>` - Working directory
+  - `--timeout <seconds>` - Timeout in seconds
+  - `--as-user <user>` - Run as user
+  - `--as-root` - Run as root
+- `kernel browsers process kill <id or persistent 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 or persistent id> <process-id>` - Get process status
+- `kernel browsers process stdin <id or persistent id> <process-id>` - Write to process stdin (base64)
+  - `--data-b64 <data>` - Base64-encoded data to write to stdin (required)
+- `kernel browsers process stdout-stream <id or persistent id> <process-id>` - Stream process stdout/stderr
+
+### Browser Filesystem
+
+- `kernel browsers fs new-directory <id or persistent id>` - Create a new directory
+  - `--path <path>` - Absolute directory path to create (required)
+  - `--mode <mode>` - Directory mode (octal string)
+- `kernel browsers fs delete-directory <id or persistent id>` - Delete a directory
+  - `--path <path>` - Absolute directory path to delete (required)
+- `kernel browsers fs delete-file <id or persistent id>` - Delete a file
+  - `--path <path>` - Absolute file path to delete (required)
+- `kernel browsers fs download-dir-zip <id or persistent id>` - Download a directory as zip
+  - `--path <path>` - Absolute directory path to download (required)
+  - `-o, --output <path>` - Output zip file path
+- `kernel browsers fs file-info <id or persistent id>` - Get file or directory info
+  - `--path <path>` - Absolute file or directory path (required)
+- `kernel browsers fs list-files <id or persistent id>` - List files in a directory
+  - `--path <path>` - Absolute directory path (required)
+- `kernel browsers fs move <id or persistent id>` - Move or rename a file or directory
+  - `--src <path>` - Absolute source path (required)
+  - `--dest <path>` - Absolute destination path (required)
+- `kernel browsers fs read-file <id or persistent id>` - Read a file
+  - `--path <path>` - Absolute file path (required)
+  - `-o, --output <path>` - Output file path (optional)
+- `kernel browsers fs set-permissions <id or persistent id>` - Set file permissions or ownership
+  - `--path <path>` - Absolute path (required)
+  - `--mode <mode>` - File mode bits (octal string) (required)
+  - `--owner <user>` - New owner username or UID
+  - `--group <group>` - New group name or GID
+- `kernel browsers fs upload <id or persistent id>` - Upload one or more files
+  - `--file <local:remote>` - Mapping local:remote (repeatable)
+  - `--dest-dir <path>` - Destination directory for uploads
+  - `--paths <paths>` - Local file paths to upload
+- `kernel browsers fs upload-zip <id or persistent id>` - Upload a zip and extract it
+  - `--zip <path>` - Local zip file path (required)
+  - `--dest-dir <path>` - Destination directory to extract to (required)
+- `kernel browsers fs write-file <id or persistent id>` - Write a file from local data
+  - `--path <path>` - Destination absolute file path (required)
+  - `--mode <mode>` - File mode (octal string)
+  - `--source <path>` - Local source file path (required)
+
 ## Examples
 
 ### Deploy with environment variables
@@ -199,6 +282,21 @@ kernel browsers delete --by-persistent-id my-browser-session --yes
 
 # Get live view URL
 kernel browsers view --by-id browser123
+
+# Stream browser logs
+kernel browsers logs stream my-browser --source supervisor --follow --supervisor-process chromium
+
+# Start a replay recording
+kernel browsers replays start my-browser --framerate 30 --max-duration 300
+
+# Execute a command in the browser VM
+kernel browsers process exec my-browser -- ls -alh /tmp
+
+# Upload files to the browser VM
+kernel browsers fs upload my-browser --file "local.txt:remote.txt" --dest-dir "/tmp"
+
+# List files in a directory
+kernel browsers fs list-files my-browser --path "/tmp"
 ```
 
 ## Getting Help
@@ -223,3 +321,7 @@ For complete documentation, visit:
 ---
 
 For development and contribution information, see [DEVELOPMENT.md](./DEVELOPMENT.md).
+
+```
+
+```

cmd/browsers.go

@@ -577,6 +577,30 @@ func (b BrowsersCmd) ProcessExec(ctx context.Context, in BrowsersProcessExecInpu
 	}
 	rows := pterm.TableData{{"Property", "Value"}, {"Exit Code", fmt.Sprintf("%d", res.ExitCode)}, {"Duration (ms)", fmt.Sprintf("%d", res.DurationMs)}}
 	printTableNoPad(rows, true)
+	if res.StdoutB64 != "" {
+		data, err := base64.StdEncoding.DecodeString(res.StdoutB64)
+		if err != nil {
+			pterm.Error.Printf("stdout decode error: %v\n", err)
+		} else if len(data) > 0 {
+			pterm.Info.Println("stdout:")
+			os.Stdout.Write(data)
+			if data[len(data)-1] != '\n' {
+				fmt.Println()
+			}
+		}
+	}
+	if res.StderrB64 != "" {
+		data, err := base64.StdEncoding.DecodeString(res.StderrB64)
+		if err != nil {
+			pterm.Error.Printf("stderr decode error: %v\n", err)
+		} else if len(data) > 0 {
+			pterm.Info.Println("stderr:")
+			os.Stderr.Write(data)
+			if data[len(data)-1] != '\n' {
+				fmt.Fprintln(os.Stderr)
+			}
+		}
+	}
 	return nil
 }
 

tapes/demo.gif

@@ -0,0 +1,69 @@
+# VHS documentation
+#
+# Output:
+#   Output <path>.gif               Create a GIF output at the given <path>
+#   Output <path>.mp4               Create an MP4 output at the given <path>
+#   Output <path>.webm              Create a WebM output at the given <path>
+#
+# Require:
+#   Require <string>                Ensure a program is on the $PATH to proceed
+#
+# Settings:
+#   Set FontSize <number>           Set the font size of the terminal
+#   Set FontFamily <string>         Set the font family of the terminal
+#   Set Height <number>             Set the height of the terminal
+#   Set Width <number>              Set the width of the terminal
+#   Set LetterSpacing <float>       Set the font letter spacing (tracking)
+#   Set LineHeight <float>          Set the font line height
+#   Set LoopOffset <float>%         Set the starting frame offset for the GIF loop
+#   Set Theme <json|string>         Set the theme of the terminal
+#   Set Padding <number>            Set the padding of the terminal
+#   Set Framerate <number>          Set the framerate of the recording
+#   Set PlaybackSpeed <float>       Set the playback speed of the recording
+#   Set MarginFill <file|#000000>   Set the file or color the margin will be filled with.
+#   Set Margin <number>             Set the size of the margin. Has no effect if MarginFill isn't set.
+#   Set BorderRadius <number>       Set terminal border radius, in pixels.
+#   Set WindowBar <string>          Set window bar type. (one of: Rings, RingsRight, Colorful, ColorfulRight)
+#   Set WindowBarSize <number>      Set window bar size, in pixels. Default is 40.
+#   Set TypingSpeed <time>          Set the typing speed of the terminal. Default is 50ms.
+#
+# Sleep:
+#   Sleep <time>                    Sleep for a set amount of <time> in seconds
+#
+# Type:
+#   Type[@<time>] "<characters>"    Type <characters> into the terminal with a
+#                                   <time> delay between each character
+#
+# Keys:
+#   Escape[@<time>] [number]        Press the Escape key
+#   Backspace[@<time>] [number]     Press the Backspace key
+#   Delete[@<time>] [number]        Press the Delete key
+#   Insert[@<time>] [number]        Press the Insert key
+#   Down[@<time>] [number]          Press the Down key
+#   Enter[@<time>] [number]         Press the Enter key
+#   Space[@<time>] [number]         Press the Space key
+#   Tab[@<time>] [number]           Press the Tab key
+#   Left[@<time>] [number]          Press the Left Arrow key
+#   Right[@<time>] [number]         Press the Right Arrow key
+#   Up[@<time>] [number]            Press the Up Arrow key
+#   Down[@<time>] [number]          Press the Down Arrow key
+#   PageUp[@<time>] [number]        Press the Page Up key
+#   PageDown[@<time>] [number]      Press the Page Down key
+#   Ctrl+<key>                      Press the Control key + <key> (e.g. Ctrl+C)
+#
+# Display:
+#   Hide                            Hide the subsequent commands from the output
+#   Show                            Show the subsequent commands in the output
+
+Output tapes/demo.gif
+
+Require echo
+
+Set Shell "bash"
+Set FontSize 32
+Set Width 1200
+Set Height 600
+
+Type "echo 'Welcome to VHS!'" Sleep 500ms  Enter
+
+Sleep 5s

tapes/demo.tape

@@ -7,25 +7,25 @@ Set Shell "bash"
 Set FontSize 32
 Set Width 2400
 Set Height 1200
-Set TypingSpeed 20ms
+Set TypingSpeed 100ms
 
-Type "kernel browsers create -H -p demo > /dev/null" Enter
+Type "kernel browsers create -H -p fs-demo" Enter
 Sleep 2s
-Type "kernel browsers fs new-directory demo --path /tmp/test" Enter
+Type "kernel browsers fs new-directory fs-demo --path /tmp/test" Enter
 Sleep 2s
 Type "echo 'hello world' > /tmp/hello_world.txt" Enter
 Sleep 2s
-Type "kernel browsers fs write-file demo --source /tmp/hello_world.txt --path /tmp/test/hello_world" Enter
+Type "kernel browsers fs write-file fs-demo --source /tmp/hello_world.txt --path /tmp/test/hello_world" Enter
 Sleep 2s
-Type "kernel browsers fs list-files demo --path /tmp/test" Enter
+Type "kernel browsers fs list-files fs-demo --path /tmp/test" Enter
 Sleep 2s
-Type "kernel browsers fs file-info demo --path /tmp/test/hello_world" Enter
+Type "kernel browsers fs file-info fs-demo --path /tmp/test/hello_world" Enter
 Sleep 2s
-Type "kernel browsers fs read-file demo --path /tmp/test/hello_world" Enter
+Type "kernel browsers fs read-file fs-demo --path /tmp/test/hello_world" Enter
 Sleep 2s
-Type "kernel browsers fs download-dir-zip demo --path /tmp/test --output /tmp/test.zip" Enter
+Type "kernel browsers fs download-dir-zip fs-demo --path /tmp/test --output /tmp/test.zip" Enter
 Sleep 2s
 Type "unzip -l /tmp/test.zip" Enter
 Sleep 2s
-Type "kernel browsers delete -y demo" Enter
+Type "kernel browsers delete -y fs-demo" Enter
 Sleep 5s

tapes/fs-demo.gif

@@ -0,0 +1,17 @@
+Output tapes/process-exec-demo.gif
+Output tapes/process-exec-demo.mp4
+
+Require kernel
+
+Set Shell "bash"
+Set FontSize 32
+Set Width 2400
+Set Height 1200
+Set TypingSpeed 100ms
+
+Type "kernel browsers create -H -p process-exec-demo" Enter
+Sleep 2s
+Type "kernel browsers process exec process-exec-demo -- echo hello world!" Enter
+Sleep 2s
+Type "kernel browsers delete -y process-exec-demo" Enter
+Sleep 5s