feat(cmd): add info command to list supported agents and runtimes

AGENTS.md

@@ -163,6 +163,7 @@ The runtime system provides a pluggable architecture for managing workspaces on
 
 **Optional Interfaces:**
 - **StorageAware**: Enables runtimes to persist data in a dedicated storage directory
+- **AgentLister**: Enables runtimes to report which agents they support
 - **Terminal**: Enables interactive terminal sessions with running instances
 
 **For detailed runtime implementation guidance, use:** `/working-with-runtime-system`

README.md

@@ -1402,6 +1402,63 @@ The system works without any configuration files and merges only the ones that e
 
 ## Commands
 
+### `info` - Display Information About kortex-cli
+
+Displays version, available agents, and supported runtimes.
+
+#### Usage
+
+```bash
+kortex-cli info [flags]
+```
+
+#### Flags
+
+- `--output, -o <format>` - Output format (supported: `json`)
+- `--storage <path>` - Storage directory for kortex-cli data (default: `$HOME/.kortex-cli`)
+
+#### Examples
+
+**Show info (human-readable format):**
+```bash
+kortex-cli info
+```
+Output:
+```text
+Version: 0.3.0
+Agents: claude
+Runtimes: fake, podman
+```
+
+**Show info in JSON format:**
+```bash
+kortex-cli info --output json
+```
+Output:
+```json
+{
+  "version": "0.3.0",
+  "agents": [
+    "claude"
+  ],
+  "runtimes": [
+    "fake",
+    "podman"
+  ]
+}
+```
+
+**Show info using short flag:**
+```bash
+kortex-cli info -o json
+```
+
+#### Notes
+
+- Agents are discovered from runtimes that support agent configuration (e.g., the Podman runtime reports agents from its configuration files)
+- Runtimes are listed based on availability in the current environment (e.g., the Podman runtime only appears if the `podman` CLI is installed)
+- **JSON error handling**: When `--output json` is used, errors are written to stdout (not stderr) in JSON format, and the CLI exits with code 1. Always check the exit code to determine success/failure
+
 ### `init` - Register a New Workspace
 
 Registers a new workspace with kortex-cli, making it available for agent launch and configuration.

go.mod

@@ -11,3 +11,5 @@ require (
 )
 
 require github.com/inconshreveable/mousetrap v1.1.0 // indirect
+
+replace github.com/kortex-hub/kortex-cli-api/cli/go => /home/brian/kortex-cli-api/cli/go

pkg/cmd/autocomplete.go

@@ -102,19 +102,10 @@ func newOutputFlagCompletion(validFormats []string) func(cmd *cobra.Command, arg
 }
 
 // completeRuntimeFlag provides completion for the --runtime flag
-// It lists all available runtimes, excluding the "fake" runtime (used only for testing)
 func completeRuntimeFlag(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective) {
 	// Get all available runtimes without requiring a manager instance
 	// This avoids creating storage directories during tab-completion
 	runtimes := runtimesetup.ListAvailable()
 
-	// Filter out "fake" runtime (used only for testing)
-	var filteredRuntimes []string
-	for _, rt := range runtimes {
-		if rt != "fake" {
-			filteredRuntimes = append(filteredRuntimes, rt)
-		}
-	}
-
-	return filteredRuntimes, cobra.ShellCompDirectiveNoFileComp
+	return runtimes, cobra.ShellCompDirectiveNoFileComp
 }

pkg/cmd/conversion.go

@@ -23,7 +23,7 @@
 	"fmt"
 	"io"
 
 	api "github.com/kortex-hub/kortex-cli-api/cli/go"
 	"github.com/kortex-hub/kortex-cli/pkg/instances"
 )
 
@@ -36,11 +36,13 @@
 
 // instanceToWorkspace converts an Instance to an api.Workspace
 func instanceToWorkspace(instance instances.Instance) api.Workspace {
+	project := instance.GetProject()
+	agent := instance.GetAgent()
 	return api.Workspace{
 		Id:      instance.GetID(),
 		Name:    instance.GetName(),
-		Project: instance.GetProject(),
-		Agent:   instance.GetAgent(),
+		Project: &project,
+		Agent:   &agent,
 		Paths: api.WorkspacePaths{
 			Configuration: instance.GetConfigDir(),
 			Source:        instance.GetSourceDir(),

pkg/cmd/conversion_test.go

@@ -114,8 +114,8 @@ func TestInstanceToWorkspace(t *testing.T) {
 			t.Errorf("Expected name 'test-workspace', got '%s'", result.Name)
 		}
 
-		if result.Project != "test-project" {
-			t.Errorf("Expected project 'test-project', got '%s'", result.Project)
+		if result.Project == nil || *result.Project != "test-project" {
+			t.Errorf("Expected project 'test-project', got '%v'", result.Project)
 		}
 
 		if result.Paths.Source != sourceDir {

pkg/cmd/info.go

@@ -0,0 +1,128 @@
+/**********************************************************************
+ * Copyright (C) 2026 Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ **********************************************************************/
+
+package cmd
+
+import (
+	"encoding/json"
+	"fmt"
+	"path/filepath"
+	"strings"
+
+	api "github.com/kortex-hub/kortex-cli-api/cli/go"
+	"github.com/kortex-hub/kortex-cli/pkg/runtimesetup"
+	"github.com/kortex-hub/kortex-cli/pkg/version"
+	"github.com/spf13/cobra"
+)
+
+// infoCmd contains the configuration for the info command
+type infoCmd struct {
+	output string
+}
+
+// preRun validates the parameters and flags
+func (i *infoCmd) preRun(cmd *cobra.Command, args []string) error {
+	// Validate output format if specified
+	if i.output != "" && i.output != "json" {
+		return fmt.Errorf("unsupported output format: %s (supported: json)", i.output)
+	}
+
+	return nil
+}
+
+// run executes the info command logic
+func (i *infoCmd) run(cmd *cobra.Command, args []string) error {
+	runtimes := runtimesetup.ListAvailable()
+
+	// Discover agents from runtimes that implement AgentLister
+	storageDir, err := cmd.Flags().GetString("storage")
+	if err != nil {
+		return outputErrorIfJSON(cmd, i.output, fmt.Errorf("failed to read --storage flag: %w", err))
+	}
+
+	absStorageDir, err := filepath.Abs(storageDir)
+	if err != nil {
+		return outputErrorIfJSON(cmd, i.output, fmt.Errorf("failed to resolve storage directory path: %w", err))
+	}
+
+	runtimeStorageDir := filepath.Join(absStorageDir, "runtimes")
+	agents, err := runtimesetup.ListAgents(runtimeStorageDir)
+	if err != nil {
+		return outputErrorIfJSON(cmd, i.output, fmt.Errorf("failed to list agents: %w", err))
+	}
+
+	if i.output == "json" {
+		return i.outputJSON(cmd, agents, runtimes)
+	}
+
+	// Text output
+	out := cmd.OutOrStdout()
+	fmt.Fprintf(out, "Version: %s\n", version.Version)
+	fmt.Fprintf(out, "Agents: %s\n", strings.Join(agents, ", "))
+	fmt.Fprintf(out, "Runtimes: %s\n", strings.Join(runtimes, ", "))
+
+	return nil
+}
+
+// outputJSON outputs the info response as JSON
+func (i *infoCmd) outputJSON(cmd *cobra.Command, agents, runtimes []string) error {
+	if agents == nil {
+		agents = []string{}
+	}
+	if runtimes == nil {
+		runtimes = []string{}
+	}
+	response := api.Info{
+		Version:  version.Version,
+		Agents:   agents,
+		Runtimes: runtimes,
+	}
+
+	jsonData, err := json.MarshalIndent(response, "", "  ")
+	if err != nil {
+		return outputErrorIfJSON(cmd, i.output, fmt.Errorf("failed to marshal info to JSON: %w", err))
+	}
+
+	fmt.Fprintln(cmd.OutOrStdout(), string(jsonData))
+	return nil
+}
+
+func NewInfoCmd() *cobra.Command {
+	c := &infoCmd{}
+
+	cmd := &cobra.Command{
+		Use:   "info",
+		Short: "Display information about kortex-cli",
+		Example: `# Show info
+kortex-cli info
+
+# Show info in JSON format
+kortex-cli info --output json
+
+# Show info using short flag
+kortex-cli info -o json`,
+		Args:    cobra.NoArgs,
+		PreRunE: c.preRun,
+		RunE:    c.run,
+	}
+
+	cmd.Flags().StringVarP(&c.output, "output", "o", "", "Output format (supported: json)")
+	cmd.RegisterFlagCompletionFunc("output", newOutputFlagCompletion([]string{"json"}))
+
+	return cmd
+}