feat(cli): add configure show subcommand

Add `docker model configure show [MODEL]` to display active model configurations. Also alias `configure` to `config` for convenience.

Signed-off-by: Dorin Geman <[email protected]>

Author: doringeman

cmd/cli/commands/configure.go

@@ -11,9 +11,10 @@ func newConfigureCmd() *cobra.Command {
 	var flags ConfigureFlags
 
 	c := &cobra.Command{
-		Use:    "configure [--context-size=<n>] [--speculative-draft-model=<model>] [--hf_overrides=<json>] [--gpu-memory-utilization=<float>] [--mode=<mode>] [--think] MODEL [-- <runtime-flags...>]",
-		Short:  "Configure runtime options for a model",
-		Hidden: true,
+		Use:     "configure [--context-size=<n>] [--speculative-draft-model=<model>] [--hf_overrides=<json>] [--gpu-memory-utilization=<float>] [--mode=<mode>] [--think] MODEL [-- <runtime-flags...>]",
+		Aliases: []string{"config"},
+		Short:   "Manage model runtime configurations",
+		Hidden:  true,
 		Args: func(cmd *cobra.Command, args []string) error {
 			argsBeforeDash := cmd.ArgsLenAtDash()
 			if argsBeforeDash == -1 {
@@ -48,5 +49,6 @@ func newConfigureCmd() *cobra.Command {
 	}
 
 	flags.RegisterFlags(c)
+	c.AddCommand(newConfigureShowCmd())
 	return c
 }

cmd/cli/commands/configure_show.go

@@ -0,0 +1,35 @@
+package commands
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/docker/model-runner/cmd/cli/commands/completion"
+	"github.com/spf13/cobra"
+)
+
+func newConfigureShowCmd() *cobra.Command {
+	c := &cobra.Command{
+		Use:   "show [MODEL]",
+		Short: "Show model configurations",
+		Args:  cobra.MaximumNArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			var modelFilter string
+			if len(args) > 0 {
+				modelFilter = args[0]
+			}
+			configs, err := desktopClient.ShowConfigs(modelFilter)
+			if err != nil {
+				return err
+			}
+			jsonResult, err := json.MarshalIndent(configs, "", "  ")
+			if err != nil {
+				return fmt.Errorf("failed to marshal configs to JSON: %w", err)
+			}
+			cmd.Println(string(jsonResult))
+			return nil
+		},
+		ValidArgsFunction: completion.ModelNames(getDesktopClient, 1),
+	}
+	return c
+}

cmd/cli/desktop/desktop.go

@@ -670,6 +670,35 @@ func (c *Client) Unload(req UnloadRequest) (UnloadResponse, error) {
 	return unloadResp, nil
 }
 
+func (c *Client) ShowConfigs(modelFilter string) ([]scheduling.ModelConfigEntry, error) {
+	configureBackendPath := inference.InferencePrefix + "/_configure"
+	if modelFilter != "" {
+		configureBackendPath += "?model=" + url.QueryEscape(modelFilter)
+	}
+	resp, err := c.doRequest(http.MethodGet, configureBackendPath, nil)
+	if err != nil {
+		return nil, c.handleQueryError(err, configureBackendPath)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		body, _ := io.ReadAll(resp.Body)
+		return nil, fmt.Errorf("listing configs failed with status %s: %s", resp.Status, string(body))
+	}
+
+	body, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return nil, fmt.Errorf("failed to read response body: %w", err)
+	}
+
+	var configs []scheduling.ModelConfigEntry
+	if err := json.Unmarshal(body, &configs); err != nil {
+		return nil, fmt.Errorf("failed to unmarshal response body: %w", err)
+	}
+
+	return configs, nil
+}
+
 func (c *Client) ConfigureBackend(request scheduling.ConfigureRequest) error {
 	configureBackendPath := inference.InferencePrefix + "/_configure"
 	jsonData, err := json.Marshal(request)

cmd/cli/docs/reference/docker_model_configure.yaml

@@ -1,9 +1,14 @@
 command: docker model configure
-short: Configure runtime options for a model
-long: Configure runtime options for a model
+aliases: docker model configure, docker model config
+short: Manage model runtime configurations
+long: Manage model runtime configurations
 usage: docker model configure [--context-size=<n>] [--speculative-draft-model=<model>] [--hf_overrides=<json>] [--gpu-memory-utilization=<float>] [--mode=<mode>] [--think] MODEL [-- <runtime-flags...>]
 pname: docker model
 plink: docker_model.yaml
+cname:
+    - docker model configure show
+clink:
+    - docker_model_configure_show.yaml
 options:
     - option: context-size
       value_type: int32

cmd/cli/docs/reference/docker_model_configure_show.yaml

@@ -0,0 +1,13 @@
+command: docker model configure show
+short: Show model configurations
+long: Show model configurations
+usage: docker model configure show [MODEL]
+pname: docker model configure
+plink: docker_model_configure.yaml
+deprecated: false
+hidden: true
+experimental: false
+experimentalcli: false
+kubernetes: false
+swarm: false
+