Move pull and push under cagent share (breaking change)

Signed-off-by: David Gageot <david.gageot@docker.com>

Author: dgageot

AGENTS.md

@@ -23,8 +23,8 @@
 - `./bin/cagent run --exec <config.yaml>` - Execute agent without TUI (non-interactive)
 - `./bin/cagent new` - Generate new agent configuration interactively
 - `./bin/cagent new --model openai/gpt-5` - Generate with specific model
-- `./bin/cagent push ./agent.yaml namespace/repo` - Push agent to OCI registry
-- `./bin/cagent pull namespace/repo` - Pull agent from OCI registry
+- `./bin/cagent share push ./agent.yaml namespace/repo` - Push agent to OCI registry
+- `./bin/cagent share pull namespace/repo` - Pull agent from OCI registry
 - `./bin/cagent serve mcp ./agent.yaml` - Expose agents as MCP tools
 - `./bin/cagent serve a2a <config.yaml>` - Start agent as A2A server
 - `./bin/cagent serve api` - Start Docker `cagent` API server

cmd/root/pull.go

@@ -22,12 +22,11 @@ func newPullCmd() *cobra.Command {
 	var flags pullFlags
 
 	cmd := &cobra.Command{
-		Use:     "pull <registry-ref>",
-		Short:   "Pull an agent from an OCI registry",
-		Long:    "Pull an agent configuration file from an OCI registry",
-		GroupID: "core",
-		Args:    cobra.ExactArgs(1),
-		RunE:    flags.runPullCommand,
+		Use:   "pull <registry-ref>",
+		Short: "Pull an agent from an OCI registry",
+		Long:  "Pull an agent configuration file from an OCI registry",
+		Args:  cobra.ExactArgs(1),
+		RunE:  flags.runPullCommand,
 	}
 
 	cmd.PersistentFlags().BoolVar(&flags.force, "force", false, "Force pull even if the configuration already exists locally")
@@ -36,7 +35,7 @@ func newPullCmd() *cobra.Command {
 }
 
 func (f *pullFlags) runPullCommand(cmd *cobra.Command, args []string) error {
-	telemetry.TrackCommand("pull", args)
+	telemetry.TrackCommand("share", append([]string{"pull"}, args...))
 
 	ctx := cmd.Context()
 	out := cli.NewPrinter(cmd.OutOrStdout())

cmd/root/push.go

@@ -16,17 +16,16 @@ import (
 
 func newPushCmd() *cobra.Command {
 	return &cobra.Command{
-		Use:     "push <agent-file> <registry-ref>",
-		Short:   "Push an agent to an OCI registry",
-		Long:    "Push an agent configuration file to an OCI registry",
-		GroupID: "core",
-		Args:    cobra.ExactArgs(2),
-		RunE:    runPushCommand,
+		Use:   "push <agent-file> <registry-ref>",
+		Short: "Push an agent to an OCI registry",
+		Long:  "Push an agent configuration file to an OCI registry",
+		Args:  cobra.ExactArgs(2),
+		RunE:  runPushCommand,
 	}
 }
 
 func runPushCommand(cmd *cobra.Command, args []string) error {
-	telemetry.TrackCommand("push", args)
+	telemetry.TrackCommand("share", append([]string{"push"}, args...))
 
 	ctx := cmd.Context()
 	agentFilename := args[0]

cmd/root/root.go

@@ -101,8 +101,7 @@ func NewRootCmd() *cobra.Command {
 	cmd.AddCommand(newRunCmd())
 	cmd.AddCommand(newNewCmd())
 	cmd.AddCommand(newEvalCmd())
-	cmd.AddCommand(newPushCmd())
-	cmd.AddCommand(newPullCmd())
+	cmd.AddCommand(newShareCmd())
 	cmd.AddCommand(newDebugCmd())
 	cmd.AddCommand(newAliasCmd())
 	cmd.AddCommand(newServeCmd())

cmd/root/share.go

@@ -0,0 +1,16 @@
+package root
+
+import "github.com/spf13/cobra"
+
+func newShareCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:     "share",
+		Short:   "Share agents",
+		GroupID: "core",
+	}
+
+	cmd.AddCommand(newPushCmd())
+	cmd.AddCommand(newPullCmd())
+
+	return cmd
+}

docs/pages/concepts/distribution.html

@@ -7,16 +7,16 @@ <h2>Overview</h2>
 
 <div class="callout callout-tip">
   <div class="callout-title">💡 Tip</div>
-  <p>For CLI commands related to distribution, see <a href="#features/cli" onclick="event.preventDefault(); navigate('features/cli')">CLI Reference</a> (<code>cagent push</code>, <code>cagent pull</code>, <code>cagent alias</code>).</p>
+  <p>For CLI commands related to distribution, see <a href="#features/cli" onclick="event.preventDefault(); navigate('features/cli')">CLI Reference</a> (<code>cagent share push</code>, <code>cagent share pull</code>, <code>cagent alias</code>).</p>
 </div>
 
 <h2>Pushing Agents</h2>
 
 <pre><code class="language-bash"># Push to Docker Hub
-$ cagent push ./agent.yaml docker.io/username/my-agent:latest
+$ cagent share push ./agent.yaml docker.io/username/my-agent:latest
 
 # Push to GitHub Container Registry
-$ cagent push ./agent.yaml ghcr.io/username/my-agent:v1.0</code></pre>
+$ cagent share push ./agent.yaml ghcr.io/username/my-agent:v1.0</code></pre>
 
 <h2>Pulling Agents</h2>
 
@@ -74,7 +74,7 @@ <h2>Private Repositories</h2>
 $ docker login docker.io
 
 # Now push/pull works with private repos
-$ cagent push ./agent.yaml docker.io/myorg/private-agent:latest
+$ cagent share push ./agent.yaml docker.io/myorg/private-agent:latest
 $ cagent run docker.io/myorg/private-agent:latest</code></pre>
 
 <div class="callout callout-info">

docs/pages/features/cli.html

@@ -106,14 +106,14 @@ <h3><code>cagent acp</code></h3>
 
 <p>See <a href="#features/acp" onclick="event.preventDefault(); navigate('features/acp')">ACP</a> for details on the Agent Client Protocol.</p>
 
-<h3><code>cagent push</code> / <code>cagent pull</code></h3>
-<p>Distribute agents via OCI registries.</p>
+<h3><code>cagent share push</code> / <code>cagent pull</code></h3>
+<p>Share agents via OCI registries.</p>
 
 <pre><code class="language-bash"># Push an agent
-$ cagent push ./agent.yaml docker.io/username/my-agent:latest
+$ cagent share push ./agent.yaml docker.io/username/my-agent:latest
 
 # Pull an agent
-$ cagent pull docker.io/username/my-agent:latest</code></pre>
+$ cagent share pull docker.io/username/my-agent:latest</code></pre>
 
 <p>See <a href="#concepts/distribution" onclick="event.preventDefault(); navigate('concepts/distribution')">Agent Distribution</a> for full registry workflow details.</p>
 

pkg/remote/pull.go

@@ -34,7 +34,7 @@ func Pull(ctx context.Context, registryRef string, force bool, opts ...crane.Opt
 		if meta, metaErr := store.GetArtifactMetadata(localRef); metaErr == nil {
 			if meta.Digest == remoteDigest {
 				if !hasCagentAnnotation(meta.Annotations) {
-					return "", fmt.Errorf("artifact %s found in store wasn't created by `cagent push`\nTry to push again with `cagent push` (cagent >= v1.10.0)", localRef)
+					return "", fmt.Errorf("artifact %s found in store wasn't created by `cagent share push`\nTry to push again with `cagent share push` (cagent >= v1.10.0)", localRef)
 				}
 				return meta.Digest, nil
 			}
@@ -51,7 +51,7 @@ func Pull(ctx context.Context, registryRef string, force bool, opts ...crane.Opt
 		return "", fmt.Errorf("getting manifest from pulled image: %w", err)
 	}
 	if !hasCagentAnnotation(manifest.Annotations) {
-		return "", fmt.Errorf("artifact %s wasn't created by `cagent push`\nTry to push again with `cagent push` (cagent >= v1.10.0)", localRef)
+		return "", fmt.Errorf("artifact %s wasn't created by `cagent share push`\nTry to push again with `cagent share push` (cagent >= v1.10.0)", localRef)
 	}
 
 	digest, err := store.StoreArtifact(img, localRef)