id          = "assh"
name        = "assh"
homepage    = "https://github.com/moul/assh"
description = "Advanced SSH configuration wrapper with aliases, gateways, and includes."
executables      = ["assh"]

[dotfiles]

# The upstream README documents ~/.ssh/assh.yml as the default YAML config;
# assh generates the separate OpenSSH ~/.ssh/config from it.
# https://github.com/moul/assh#configuration
paths = ["~/.ssh/assh.yml"]

exclude = []
secret  = []

[commands]
format = 1
label = "assh"
description = "Inspect an assh configuration. Only the global config-file and debug options and the config search subcommand are covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/moul/assh/blob/master/README.md"
revision = "2.8.0"
evidence = """
   assh [global options] command [command options] [arguments...]
  --config value, -c value       Location of config file (default: "~/.ssh/assh.yml") [$ASSH_CONFIG]
  --debug, -D                    Enable debug mode [$ASSH_DEBUG]
  --verbose, -V                  Enable verbose mode
#### `assh config search <keyword>`
"""

[[commands.field]]
id = "config"
label = "Config file"
type = "path"
path = { kind = "file", role = "input" }
option = ["--config", "-c"]
sources = ["readme"]

[[commands.field]]
id = "debug"
label = "Debug mode"
type = "boolean"
option = ["--debug", "-D"]
sources = ["readme"]

[[commands.field]]
id = "verbose"
label = "Verbose mode"
type = "boolean"
option = ["--verbose", "-V"]
sources = ["readme"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["config", "debug", "verbose"]

[[commands.subcommand]]
path = ["config", "search"]
label = "Search hosts"
description = "Search the assh configuration for a keyword."

[[commands.subcommand.source]]
id = "readme"
kind = "help"
url = "https://github.com/moul/assh/blob/master/README.md"
revision = "2.8.0"
evidence = """
#### `assh config search <keyword>`
"""

[[commands.subcommand.field]]
id = "keyword"
label = "Keyword"
type = "string"
position = 0
sources = ["readme"]

[[commands.subcommand.task]]
id = "search"
label = "Search hosts"
fields = ["keyword"]
required = ["keyword"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["keyword"]