id          = "amazon-ecs-cli"
name        = "Amazon ECS CLI"
homepage    = "https://github.com/aws/amazon-ecs-cli"
description = "Command line interface for Amazon ECS"
executables = ["ecs-cli"]

[dotfiles]

# AWS's archived upstream ECS CLI guide documents ~/.ecs/config and
# ~/.ecs/credentials on macOS/Linux, and %LOCALAPPDATA%/ecs on Windows.
# The credentials file contains ECS profile access keys; cluster config is
# ordinary user configuration.
# https://github.com/aws/amazon-ecs-cli
# https://aws.amazon.com/blogs/containers/authenticating-with-docker-hub-for-aws-container-services/
paths = [
  "~/.ecs/config",
  "%LOCALAPPDATA%/ecs/config",
]
secret = [
  "~/.ecs/credentials",
  "%LOCALAPPDATA%/ecs/credentials",
]
side_effect = false

[commands]
format = 1
label = "Amazon ECS CLI"
description = "Create an ECS cluster with ecs-cli up. Compose, task and service commands are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["up"]
label = "Create a cluster"
description = "Create an ECS cluster (EC2 or Fargate). Other options such as VPC and subnets are left out."

[[commands.subcommand.source]]
id = "readme"
kind = "help"
url = "https://github.com/aws/amazon-ecs-cli/blob/master/README.md"
revision = "2026-10-27"
evidence = """
ecs-cli up --keypair my-key --capability-iam --size 2
ecs-cli up --cluster myCluster --empty
ecs-cli up --launch-type FARGATE
ecs-cli configure --cluster cluster_name --region region_name --config-name configuration_name
"""

[[commands.subcommand.field]]
id = "cluster"
label = "Cluster name"
type = "string"
option = ["--cluster"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "launch_type"
label = "Launch type"
type = "enum"
choices = [{ value = "EC2", label = "EC2" }, { value = "FARGATE", label = "Fargate" }]
option = ["--launch-type"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "keypair"
label = "EC2 key pair"
type = "string"
option = ["--keypair"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "capability_iam"
label = "Allow IAM resource creation"
type = "boolean"
option = ["--capability-iam"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "size"
label = "Number of instances"
type = "integer"
option = ["--size"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "empty"
label = "Empty cluster"
description = "Create the cluster without container instances."
type = "boolean"
option = ["--empty"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "ec2"
label = "EC2 cluster"
fields = ["cluster", "keypair", "capability_iam", "size", "launch_type"]
required = ["keypair"]
set = { launch_type = ["EC2"], capability_iam = [true] }

[[commands.subcommand.task]]
id = "fargate"
label = "Fargate cluster"
fields = ["cluster", "launch_type"]
set = { launch_type = ["FARGATE"] }

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["cluster", "launch_type", "keypair", "capability_iam", "size", "empty"]