fix(cli): stop parsing flags after command

Author: kbdevs

internal/cli/flags.go

@@ -43,7 +43,8 @@ func ParseFlags(args []string) (Flags, []string) {
 		case isStackedVerboseFlag(arg):
 			flags.Verbose = strings.Count(arg, "v")
 		default:
-			remaining = append(remaining, arg)
+			remaining = append(remaining, args[i:]...)
+			return flags, remaining
 		}
 	}
 

internal/cli/flags_test.go

@@ -53,6 +53,18 @@ func TestParseFlags(t *testing.T) {
 			wantFlags: Flags{Verbose: 1, UltraCompact: true},
 			wantArgs:  []string{"git", "status"},
 		},
+		{
+			name:      "command help flag is passed through",
+			args:      []string{"npx", "-y", "chrome-devtools-mcp@latest", "--help"},
+			wantFlags: Flags{},
+			wantArgs:  []string{"npx", "-y", "chrome-devtools-mcp@latest", "--help"},
+		},
+		{
+			name:      "global flags stop parsing at command",
+			args:      []string{"-v", "npx", "-y", "chrome-devtools-mcp@latest", "--help"},
+			wantFlags: Flags{Verbose: 1},
+			wantArgs:  []string{"npx", "-y", "chrome-devtools-mcp@latest", "--help"},
+		},
 		// "--" separator: everything after it is passed verbatim to the command.
 		{
 			name:      "double dash passes remaining verbatim",