{
  "id": "e1s",
  "name": "e1s",
  "homepage": "https://github.com/keidarcy/e1s",
  "description": "Terminal application to browse and manage AWS ECS resources",
  "executables": [
    "e1s"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/e1s/config.yml"
    ],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Browse ECS resources",
    "description": "Start the e1s terminal UI against an AWS profile, region, cluster and service. Theme, SSM custom command and startup splash options are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/keidarcy/e1s#usage",
        "revision": "2026-10-27",
        "evidence": "Usage:\n  e1s [flags]\n\nFlags:\n      --cluster string         specify the default cluster\n  -c, --config-file string     config file (default \"$HOME/.config/e1s/config.yml\")\n  -d, --debug                  sets debug mode\n      --exec-mode string       execution mode for ECS containers: ecs or ssm (default \"ecs\")\n  -j, --json                   log output json format\n  -l, --log-file string        specify the log file path (default \"${TMPDIR}e1s.log\")\n      --profile string         specify the AWS profile\n      --read-only              sets read only mode\n  -r, --refresh int            specify the default refresh rate as an integer, sets -1 to stop auto refresh (sec) (default 30)\n      --region string          specify the AWS region\n      --service string         specify the default service (requires --cluster)\n  -s, --shell string           specify interactive ecs exec shell (default \"/bin/sh\")\n"
      }
    ],
    "field": [
      {
        "id": "profile",
        "label": "AWS profile",
        "type": "string",
        "option": [
          "--profile"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "region",
        "label": "AWS region",
        "type": "string",
        "option": [
          "--region"
        ],
        "suggestions": [
          {
            "value": "us-east-1",
            "label": "us-east-1"
          },
          {
            "value": "us-east-2",
            "label": "us-east-2"
          },
          {
            "value": "us-west-2",
            "label": "us-west-2"
          },
          {
            "value": "eu-west-1",
            "label": "eu-west-1"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "cluster",
        "label": "Default cluster",
        "type": "string",
        "option": [
          "--cluster"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "service",
        "label": "Default service",
        "description": "Requires a default cluster.",
        "type": "string",
        "option": [
          "--service"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "read_only",
        "label": "Read-only mode",
        "type": "boolean",
        "option": [
          "--read-only"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "refresh",
        "label": "Refresh rate (seconds)",
        "description": "Use -1 to stop auto refresh.",
        "type": "integer",
        "option": [
          "--refresh",
          "-r"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "exec_mode",
        "label": "Exec mode",
        "type": "enum",
        "option": [
          "--exec-mode"
        ],
        "choices": [
          {
            "value": "ecs",
            "label": "ECS Exec"
          },
          {
            "value": "ssm",
            "label": "SSM"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "shell",
        "label": "Exec shell",
        "type": "string",
        "option": [
          "--shell",
          "-s"
        ],
        "suggestions": [
          {
            "value": "/bin/sh",
            "label": "/bin/sh"
          },
          {
            "value": "/bin/bash",
            "label": "/bin/bash"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "config_file",
        "label": "Config file",
        "type": "path",
        "option": [
          "--config-file",
          "-c"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "debug",
        "label": "Debug mode",
        "type": "boolean",
        "option": [
          "--debug",
          "-d"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "log_file",
        "label": "Log file",
        "type": "path",
        "option": [
          "--log-file",
          "-l"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "help"
        ]
      },
      {
        "id": "json",
        "label": "JSON log output",
        "type": "boolean",
        "option": [
          "--json",
          "-j"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "browse",
        "label": "Browse a cluster",
        "fields": [
          "profile",
          "region",
          "cluster",
          "service"
        ],
        "required": [
          "profile",
          "region"
        ]
      },
      {
        "id": "read_only",
        "label": "Browse read-only",
        "fields": [
          "profile",
          "region",
          "read_only"
        ],
        "required": [
          "read_only"
        ],
        "set": {
          "read_only": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "profile",
          "region",
          "cluster",
          "service",
          "read_only",
          "refresh"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "exec_mode",
          "shell",
          "config_file",
          "debug",
          "log_file",
          "json"
        ]
      }
    ]
  }
}