Add start_url to browser update CLI

Author: chruffins

README.md

@@ -252,6 +252,7 @@ Commands with JSON output support:
   - `--proxy-mode direct|default` - Change egress mode: `direct` for no proxy regardless of stealth, `default` to restore the browser default after using a selected proxy. Changing the proxy does not change stealth or CAPTCHA solver behavior.
   - `--clear-proxy` - Drop the selected proxy and restore the browser default (same as `--proxy-mode=default`)
   - `--disable-default-proxy` - Connect directly instead of through the default stealth proxy (same as `--proxy-mode=direct`); use `--disable-default-proxy=false` to restore the default
+  - `--start-url <url>` - Navigate the browser to a URL after applying the update
   - `--output json`, `-o json` - Output raw JSON object
 - `kernel browsers curl <id> <url>` - Make HTTP requests through a browser session's Chrome network stack
   - `-X, --request <method>` - HTTP method (default: GET; defaults to POST when `--data` is set)

cmd/browsers.go

@@ -413,6 +413,7 @@ type BrowsersUpdateInput struct {
 	ProfileID           string
 	ProfileName         string
 	ProfileSaveChanges  BoolFlag
+	StartURL            string
 	Viewport            string
 	Force               bool
 	Telemetry           string
@@ -897,6 +898,9 @@ func (b BrowsersCmd) Update(ctx context.Context, in BrowsersUpdateInput) error {
 	if err := validateJSONOutput(in.Output); err != nil {
 		return err
 	}
+	if err := validateStartURLFlag(in.StartURL); err != nil {
+		return err
+	}
 
 	// Validate profile selection: at most one of profile-id or profile-name must be provided
 	if in.ProfileID != "" && in.ProfileName != "" {
@@ -938,6 +942,7 @@ func (b BrowsersCmd) Update(ctx context.Context, in BrowsersUpdateInput) error {
 
 	hasProxyChange := proxySel.set()
 	hasProfileChange := in.ProfileID != "" || in.ProfileName != ""
+	hasStartURLChange := in.StartURL != ""
 	hasViewportChange := in.Viewport != ""
 	// By this point a set name is guaranteed non-empty (the guard above rejects --name "").
 	hasNameChange := in.SetName || in.ClearName
@@ -954,8 +959,8 @@ func (b BrowsersCmd) Update(ctx context.Context, in BrowsersUpdateInput) error {
 	}
 
 	// Validate that at least one update option is provided
-	if !hasProxyChange && !hasProfileChange && !hasViewportChange && in.Telemetry == "" && !hasNameChange && !hasTagsChange {
-		return fmt.Errorf("must specify at least one of: --proxy-id, --proxy-name, --proxy-mode, --clear-proxy, --disable-default-proxy, --profile-id, --profile-name, --viewport, --telemetry, --name, --clear-name, --tag, or --clear-tags")
+	if !hasProxyChange && !hasProfileChange && !hasStartURLChange && !hasViewportChange && in.Telemetry == "" && !hasNameChange && !hasTagsChange {
+		return fmt.Errorf("must specify at least one of: --proxy-id, --proxy-name, --proxy-mode, --clear-proxy, --disable-default-proxy, --profile-id, --profile-name, --start-url, --viewport, --telemetry, --name, --clear-name, --tag, or --clear-tags")
 	}
 
 	params := kernel.BrowserUpdateParams{}
@@ -997,6 +1002,10 @@ func (b BrowsersCmd) Update(ctx context.Context, in BrowsersUpdateInput) error {
 		}
 	}
 
+	if hasStartURLChange {
+		params.StartURL = kernel.Opt(in.StartURL)
+	}
+
 	// Handle telemetry changes
 	if in.Telemetry != "" {
 		t, err := buildUpdateTelemetryParam(in.Telemetry)
@@ -2644,6 +2653,7 @@ Supported operations:
   - Select a proxy by ID or name (--proxy-id or --proxy-name)
   - Change proxy egress mode (--proxy-mode=direct or --proxy-mode=default)
   - Load a profile into a session that doesn't have one (--profile-id or --profile-name)
+  - Navigate to a URL after the update (--start-url)
   - Change viewport dimensions (--viewport)
   - Force viewport resize during active live view or recording (--force with --viewport)
   - Rename or clear the session name (--name or --clear-name)
@@ -2692,6 +2702,7 @@ func init() {
 	browsersUpdateCmd.Flags().String("profile-id", "", "Profile ID to load into the browser session (mutually exclusive with --profile-name)")
 	browsersUpdateCmd.Flags().String("profile-name", "", "Profile name to load into the browser session (mutually exclusive with --profile-id)")
 	browsersUpdateCmd.Flags().Bool("save-changes", false, "If set, save changes back to the profile when the session ends")
+	browsersUpdateCmd.Flags().String("start-url", "", "URL to navigate the browser to after applying this update")
 	browsersUpdateCmd.Flags().String("viewport", "", "Browser viewport size (e.g., 1920x1080@25). Supported: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1024x768@60, 1200x800@60, 1280x800@60")
 	browsersUpdateCmd.Flags().Bool("force", false, "Force viewport resize even when a live view or recording/replay is active")
 	browsersUpdateCmd.Flags().String("telemetry", "", "Update telemetry: --telemetry=all (reset to default set), --telemetry=off (disable), or --telemetry=console,network (merge those categories into the current selection)")
@@ -3311,6 +3322,7 @@ func runBrowsersUpdate(cmd *cobra.Command, args []string) error {
 	profileID, _ := cmd.Flags().GetString("profile-id")
 	profileName, _ := cmd.Flags().GetString("profile-name")
 	saveChanges, _ := cmd.Flags().GetBool("save-changes")
+	startURL, _ := cmd.Flags().GetString("start-url")
 	viewport, _ := cmd.Flags().GetString("viewport")
 	force, _ := cmd.Flags().GetBool("force")
 	telemetry, _ := cmd.Flags().GetString("telemetry")
@@ -3331,6 +3343,7 @@ func runBrowsersUpdate(cmd *cobra.Command, args []string) error {
 		ProfileID:           profileID,
 		ProfileName:         profileName,
 		ProfileSaveChanges:  BoolFlag{Set: cmd.Flags().Changed("save-changes"), Value: saveChanges},
+		StartURL:            startURL,
 		Viewport:            viewport,
 		Force:               force,
 		Telemetry:           telemetry,

cmd/browsers_test.go

@@ -2408,6 +2408,39 @@ func captureUpdateParams(t *testing.T) (*FakeBrowsersService, *kernel.BrowserUpd
 	return fake, captured
 }
 
+func TestBrowsersUpdate_WithStartURL_ForwardsParam(t *testing.T) {
+	setupStdoutCapture(t)
+	fake, captured := captureUpdateParams(t)
+	b := BrowsersCmd{browsers: fake}
+
+	err := b.Update(context.Background(), BrowsersUpdateInput{
+		Identifier: "session123",
+		StartURL:   "https://example.com/checkout",
+	})
+
+	require.NoError(t, err)
+	assert.True(t, captured.StartURL.Valid())
+	assert.Equal(t, "https://example.com/checkout", captured.StartURL.Value)
+}
+
+func TestBrowsersUpdate_RejectsStartURLFlagToken(t *testing.T) {
+	called := false
+	fake := &FakeBrowsersService{UpdateFunc: func(ctx context.Context, id string, body kernel.BrowserUpdateParams, opts ...option.RequestOption) (*kernel.BrowserUpdateResponse, error) {
+		called = true
+		return &kernel.BrowserUpdateResponse{}, nil
+	}}
+	b := BrowsersCmd{browsers: fake}
+
+	err := b.Update(context.Background(), BrowsersUpdateInput{
+		Identifier: "session123",
+		StartURL:   "--viewport",
+	})
+
+	require.Error(t, err)
+	assert.Contains(t, err.Error(), "--start-url requires a URL value")
+	assert.False(t, called)
+}
+
 func TestBrowsersUpdate_WithName_ForwardsParam(t *testing.T) {
 	setupStdoutCapture(t)
 	fake, captured := captureUpdateParams(t)

go.mod

@@ -9,7 +9,7 @@ require (
 	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta.1
 	github.com/golang-jwt/jwt/v5 v5.2.2
 	github.com/joho/godotenv v1.5.1
-	github.com/kernel/kernel-go-sdk v0.105.0
+	github.com/kernel/kernel-go-sdk v0.106.0
 	github.com/klauspost/compress v1.18.5
 	github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c
 	github.com/pterm/pterm v0.12.80

go.sum

@@ -66,6 +66,8 @@ github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
 github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
 github.com/kernel/kernel-go-sdk v0.105.0 h1:xKCFrduHuKTD6ceytLkMHUDRafnZaJcc8WUPSXGGILw=
 github.com/kernel/kernel-go-sdk v0.105.0/go.mod h1:EeZzSuHZVeHKxKCPUzxou2bovNGhXaz0RXrSqKNf1AQ=
+github.com/kernel/kernel-go-sdk v0.106.0 h1:w5+MEk6hdkwVOltLrS+6bvEaRBq8y8FUcfdfibzMH7k=
+github.com/kernel/kernel-go-sdk v0.106.0/go.mod h1:EeZzSuHZVeHKxKCPUzxou2bovNGhXaz0RXrSqKNf1AQ=
 github.com/klauspost/compress v1.18.5 h1:/h1gH5Ce+VWNLSWqPzOVn6XBO+vJbCNGvjoaGBFW2IE=
 github.com/klauspost/compress v1.18.5/go.mod h1:cwPg85FWrGar70rWktvGQj8/hthj3wpl0PGDogxkrSQ=
 github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=