cloudposse
diff --git a/‎.github/workflows/test.yml‎
Lines changed: 1 addition & 0 deletions b/‎.github/workflows/test.yml‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎NOTICE‎
Lines changed: 2 additions & 2 deletions b/‎NOTICE‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎cmd/about/about.go‎
Lines changed: 6 additions & 0 deletions b/‎cmd/about/about.go‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎cmd/internal/command.go‎
Lines changed: 40 additions & 0 deletions b/‎cmd/internal/command.go‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎cmd/internal/registry.go‎
Lines changed: 88 additions & 0 deletions b/‎cmd/internal/registry.go‎
Lines changed: 88 additions & 0 deletions
@@ -418,6 +418,7 @@ jobs:
           # - examples/demo-stack-templating
           # - examples/demo-multi-cloud
           - examples/demo-vendoring
+          - examples/config-profiles
           - tests/fixtures/scenarios/complete
 
     timeout-minutes: 20
 
@@ -287,7 +287,7 @@ APACHE 2.0 LICENSED DEPENDENCIES
 
   - github.com/google/renameio/v2
     License: Apache-2.0
-    URL: https://github.com/google/renameio/blob/v2.0.0/LICENSE
+    URL: https://github.com/google/renameio/blob/v2.0.1/LICENSE
 
   - github.com/google/s2a-go
     License: Apache-2.0
@@ -1214,7 +1214,7 @@ MIT LICENSED DEPENDENCIES
 
   - github.com/getsentry/sentry-go
     License: MIT
-    URL: https://github.com/getsentry/sentry-go/blob/v0.37.0/LICENSE
+    URL: https://github.com/getsentry/sentry-go/blob/v0.38.0/LICENSE
 
   - github.com/go-logfmt/logfmt
     License: MIT
 
@@ -62,3 +62,9 @@ func (a *AboutCommandProvider) GetPositionalArgsBuilder() *flags.PositionalArgsB
 func (a *AboutCommandProvider) GetCompatibilityFlags() map[string]compat.CompatibilityFlag {
 	return nil
 }
+
+// GetAliases returns command aliases.
+// About command has no aliases.
+func (a *AboutCommandProvider) GetAliases() []internal.CommandAlias {
+	return nil
+}
@@ -2,6 +2,29 @@ package internal
 
 import "github.com/spf13/cobra"
 
+// CommandAlias represents an alias for a command or subcommand under a different parent.
+type CommandAlias struct {
+	// Subcommand is the name of the subcommand to alias (empty string for the parent command).
+	// For example, "list" to alias "atmos profile list" as "atmos list profiles".
+	Subcommand string
+
+	// ParentCommand is the name of the parent command to add the alias under.
+	// For example, "list" to create "atmos list profiles" as an alias for "atmos profile list".
+	ParentCommand string
+
+	// Name is the alias command name (e.g., "profiles" for "atmos list profiles").
+	Name string
+
+	// Short is the short description for the alias command.
+	Short string
+
+	// Long is the long description for the alias command.
+	Long string
+
+	// Example is the usage example for the alias command.
+	Example string
+}
+
 // CommandProvider is the interface that built-in command packages implement
 // to register themselves with the Atmos command registry.
 //
@@ -24,6 +47,10 @@ import "github.com/spf13/cobra"
 //	    return "Other Commands"
 //	}
 //
+//	func (a *AboutCommandProvider) GetAliases() []CommandAlias {
+//	    return nil // No aliases
+//	}
+//
 //	func init() {
 //	    internal.Register(&AboutCommandProvider{})
 //	}
@@ -47,4 +74,17 @@ type CommandProvider interface {
 	//   - "Pro Features"             (auth, pro)
 	//   - "Other Commands"           (about, completion, version, support)
 	GetGroup() string
+
+	// GetAliases returns a list of command aliases to register.
+	// Aliases allow the same command to be accessible under different parent commands.
+	// Return nil or an empty slice if the command has no aliases.
+	//
+	// Example: "atmos profile list" can be aliased as "atmos list profiles":
+	//   return []CommandAlias{{
+	//       ParentCommand: "list",
+	//       Name:          "profiles",
+	//       Short:         "List available configuration profiles",
+	//       Long:          `This is an alias for "atmos profile list".`,
+	//   }}
+	GetAliases() []CommandAlias
 }
@@ -5,6 +5,7 @@ import (
 	"sync"
 
 	"github.com/spf13/cobra"
+	"github.com/spf13/pflag"
 
 	errUtils "github.com/cloudposse/atmos/errors"
 )
@@ -63,6 +64,10 @@ func Register(provider CommandProvider) {
 // in cmd/root.go init(). It registers all commands that have been added
 // to the registry via Register().
 //
+// This function performs registration in two phases:
+// 1. Register all primary commands to the root command
+// 2. Register command aliases to their respective parent commands
+//
 // Custom commands from atmos.yaml are processed AFTER this function
 // via processCustomCommands(), allowing custom commands to extend or
 // override built-in commands.
@@ -79,6 +84,7 @@ func RegisterAll(root *cobra.Command) error {
 	registry.mu.RLock()
 	defer registry.mu.RUnlock()
 
+	// Phase 1: Register all primary commands.
 	for name, provider := range registry.providers {
 		cmd := provider.GetCommand()
 		if cmd == nil {
@@ -88,6 +94,88 @@ func RegisterAll(root *cobra.Command) error {
 		root.AddCommand(cmd)
 	}
 
+	// Phase 2: Register command aliases.
+	// This must happen after phase 1 to ensure parent commands exist.
+	for name, provider := range registry.providers {
+		aliases := provider.GetAliases()
+		if len(aliases) == 0 {
+			continue
+		}
+
+		// Get the original command to access subcommands.
+		originalCmd := provider.GetCommand()
+		if originalCmd == nil {
+			return fmt.Errorf("%w: provider %s", errUtils.ErrCommandNil, name)
+		}
+
+		for _, alias := range aliases {
+			// Find the parent command to add the alias under.
+			parentCmd, _, err := root.Find([]string{alias.ParentCommand})
+			if err != nil {
+				return fmt.Errorf("failed to find parent command %q for alias %q: %w", alias.ParentCommand, alias.Name, err)
+			}
+
+			// Determine which command to alias (parent or subcommand).
+			var sourceCmd *cobra.Command
+			if alias.Subcommand == "" {
+				// Alias the parent command itself.
+				sourceCmd = originalCmd
+			} else {
+				// Alias a specific subcommand.
+				sourceCmd, _, err = originalCmd.Find([]string{alias.Subcommand})
+				if err != nil {
+					return fmt.Errorf("failed to find subcommand %q for alias %q: %w", alias.Subcommand, alias.Name, err)
+				}
+				// Verify we actually found the subcommand and not just the parent.
+				if sourceCmd == originalCmd {
+					return fmt.Errorf("failed to find subcommand %q for alias %q: subcommand does not exist", alias.Subcommand, alias.Name)
+				}
+			}
+
+			// Create an alias command that delegates to the source command.
+			//
+			// Key delegation mechanisms:
+			// - Args: Enforces the same argument validation as the source
+			// - Run/RunE: Executes the source command's logic (copy whichever is non-nil)
+			// - FParseErrWhitelist: Allows the same flag parsing behavior
+			// - ValidArgsFunction: Provides the same shell completion
+			aliasCmd := &cobra.Command{
+				Use:                alias.Name,
+				Short:              alias.Short,
+				Long:               alias.Long,
+				Example:            alias.Example,
+				Args:               sourceCmd.Args,
+				Run:                sourceCmd.Run,
+				RunE:               sourceCmd.RunE,
+				FParseErrWhitelist: sourceCmd.FParseErrWhitelist,
+				ValidArgsFunction:  sourceCmd.ValidArgsFunction,
+			}
+
+			// Share flags with the source command.
+			// Using AddFlag shares the same flag instance, which means:
+			// 1. Flag values set on the alias are visible to the source RunE
+			// 2. Flag validation happens naturally through shared state
+			// 3. No need to manually copy flag values between commands
+			// This creates true delegation where the alias is just a different
+			// path to the same underlying command implementation.
+			sourceCmd.Flags().VisitAll(func(flag *pflag.Flag) {
+				aliasCmd.Flags().AddFlag(flag)
+			})
+
+			// Share flag completion functions.
+			// This ensures the alias provides the same shell completion
+			// suggestions as the source command for all flags.
+			sourceCmd.Flags().VisitAll(func(flag *pflag.Flag) {
+				if completionFunc, _ := sourceCmd.GetFlagCompletionFunc(flag.Name); completionFunc != nil {
+					_ = aliasCmd.RegisterFlagCompletionFunc(flag.Name, completionFunc)
+				}
+			})
+
+			// Add the alias command to the parent.
+			parentCmd.AddCommand(aliasCmd)
+		}
+	}
+
 	return nil
 }