Add CLIArgs field to Go SDK for complete cross-SDK consistency

Co-authored-by: friggeri <106686+friggeri@users.noreply.github.com>

Author: Copilot

go/README.md

@@ -109,6 +109,7 @@ Event types: `SessionLifecycleCreated`, `SessionLifecycleDeleted`, `SessionLifec
 **ClientOptions:**
 
 - `CLIPath` (string): Path to CLI executable (default: "copilot" or `COPILOT_CLI_PATH` env var)
+- `CLIArgs` ([]string): Extra arguments to pass to the CLI executable (inserted before SDK-managed args)
 - `CLIUrl` (string): URL of existing CLI server (e.g., `"localhost:8080"`, `"http://127.0.0.1:9000"`, or just `"8080"`). When provided, the client will not spawn a CLI process.
 - `Cwd` (string): Working directory for CLI process
 - `Port` (int): Server port for TCP mode (default: 0 for random)

go/client.go

@@ -143,6 +143,9 @@ func NewClient(options *ClientOptions) *Client {
 		if options.CLIPath != "" {
 			opts.CLIPath = options.CLIPath
 		}
+		if options.CLIArgs != nil {
+			opts.CLIArgs = options.CLIArgs
+		}
 		if options.Cwd != "" {
 			opts.Cwd = options.Cwd
 		}
@@ -994,7 +997,11 @@ func (c *Client) verifyProtocolVersion(ctx context.Context) error {
 // This spawns the CLI server as a subprocess using the configured transport
 // mode (stdio or TCP).
 func (c *Client) startCLIServer(ctx context.Context) error {
-	args := []string{"--headless", "--no-auto-update", "--log-level", c.options.LogLevel}
+	// Start with user-provided CLI args (inserted before SDK-managed args)
+	args := append([]string{}, c.options.CLIArgs...)
+	
+	// Add SDK-managed args
+	args = append(args, "--headless", "--no-auto-update", "--log-level", c.options.LogLevel)
 
 	// Choose transport mode
 	if c.useStdio {

go/client_test.go

@@ -330,6 +330,40 @@ func TestClient_AuthOptions(t *testing.T) {
 	})
 }
 
+func TestClient_CLIArgs(t *testing.T) {
+	t.Run("should default CLIArgs to nil when not provided", func(t *testing.T) {
+		client := NewClient(&ClientOptions{})
+
+		if client.options.CLIArgs != nil {
+			t.Errorf("Expected CLIArgs to be nil, got %v", client.options.CLIArgs)
+		}
+	})
+
+	t.Run("should accept CLIArgs option", func(t *testing.T) {
+		args := []string{"--custom-flag", "--another-arg", "value"}
+		client := NewClient(&ClientOptions{
+			CLIArgs: args,
+		})
+
+		if !reflect.DeepEqual(client.options.CLIArgs, args) {
+			t.Errorf("Expected CLIArgs to be %v, got %v", args, client.options.CLIArgs)
+		}
+	})
+
+	t.Run("should store empty CLIArgs slice", func(t *testing.T) {
+		client := NewClient(&ClientOptions{
+			CLIArgs: []string{},
+		})
+
+		if client.options.CLIArgs == nil {
+			t.Error("Expected CLIArgs to be non-nil empty slice")
+		}
+		if len(client.options.CLIArgs) != 0 {
+			t.Errorf("Expected 0 CLI args, got %d", len(client.options.CLIArgs))
+		}
+	})
+}
+
 func TestClient_EnvOptions(t *testing.T) {
 	t.Run("should store custom environment variables", func(t *testing.T) {
 		client := NewClient(&ClientOptions{

go/types.go

@@ -16,6 +16,8 @@ const (
 type ClientOptions struct {
 	// CLIPath is the path to the Copilot CLI executable (default: "copilot")
 	CLIPath string
+	// CLIArgs are extra arguments to pass to the CLI executable (inserted before SDK-managed args)
+	CLIArgs []string
 	// Cwd is the working directory for the CLI process (default: "" = inherit from current process)
 	Cwd string
 	// Port for TCP transport (default: 0 = random port)