id       = "linode-cli"
name     = "Linode CLI"
homepage = "https://github.com/linode/linode-cli"
description = "The official command-line interface for Linode cloud services."
executables   = ["linode"]

[dotfiles]

# Linode's official CLI README documents ~/.linodecli/config and the
# username-suffixed variant written by `linode configure`; the file can hold
# the API key, so both forms are kept secret.
# https://github.com/linode/linode-cli#initial-configuration
paths = []
exclude = []
secret = ["~/.linodecli/config", "~/.linodecli/config_*"]
side_effect = false

[commands]
format = 1
label = "Linode CLI"
description = "List, create and reboot Linodes. Other API commands, nested arguments and passwords on the command line are left out; --root_pass makes the CLI prompt."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["linodes", "list"]
label = "List Linodes"

[[commands.subcommand.source]]
id = "usage"
kind = "help"
url = "https://raw.githubusercontent.com/wiki/linode/linode-cli/Usage.md"
revision = "2026-10-27"
evidence = """
linode-cli linodes list
linode-cli linodes list --region us-east
"""

[[commands.subcommand.field]]
id = "region"
label = "Region"
type = "string"
option = ["--region"]
suggestions = [{ value = "us-east", label = "us-east" }]
sources = ["usage"]

[[commands.subcommand.task]]
id = "list"
label = "List Linodes"
fields = ["region"]

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

[[commands.subcommand]]
path = ["linodes", "create"]
label = "Create a Linode"
description = "Creates a billable resource. The root password is prompted for by the CLI."

[[commands.subcommand.source]]
id = "usage"
kind = "help"
url = "https://raw.githubusercontent.com/wiki/linode/linode-cli/Usage.md"
revision = "2026-10-27"
evidence = """
linode-cli linodes create --type g5-standard-2 --region us-east --image linode/debian9 --label cli-1 --root_pass
linode-cli linodes create --label cli-2 --root_pass
linode-cli linodes create --region us-east --type g6-nanode-1 --tags tag1 --tags tag2
"""

[[commands.subcommand.field]]
id = "label"
label = "Label"
type = "string"
option = ["--label"]
sources = ["usage"]

[[commands.subcommand.field]]
id = "type"
label = "Plan type"
type = "string"
option = ["--type"]
suggestions = [{ value = "g6-nanode-1", label = "g6-nanode-1" }, { value = "g5-standard-2", label = "g5-standard-2" }]
sources = ["usage"]

[[commands.subcommand.field]]
id = "region"
label = "Region"
type = "string"
option = ["--region"]
suggestions = [{ value = "us-east", label = "us-east" }]
sources = ["usage"]

[[commands.subcommand.field]]
id = "image"
label = "Image"
type = "string"
option = ["--image"]
suggestions = [{ value = "linode/debian9", label = "linode/debian9" }]
sources = ["usage"]

[[commands.subcommand.field]]
id = "tags"
label = "Tags"
type = "string"
option = ["--tags"]
multiple = true
sources = ["usage"]

[[commands.subcommand.field]]
id = "root_pass"
label = "Prompt for root password"
type = "boolean"
option = ["--root_pass"]
sources = ["usage"]

[[commands.subcommand.task]]
id = "create"
label = "Create"
fields = ["label", "type", "region", "image", "tags", "root_pass"]
required = ["label"]
set = { root_pass = [true] }

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["label", "type", "region", "image", "root_pass"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["tags"]

[[commands.subcommand]]
path = ["linodes", "reboot"]
label = "Reboot a Linode"

[[commands.subcommand.source]]
id = "usage"
kind = "help"
url = "https://raw.githubusercontent.com/wiki/linode/linode-cli/Usage.md"
revision = "2026-10-27"
evidence = """
linode-cli linodes reboot 12345
"""

[[commands.subcommand.field]]
id = "linode_id"
label = "Linode ID"
type = "integer"
position = 0
sources = ["usage"]

[[commands.subcommand.task]]
id = "reboot"
label = "Reboot"
fields = ["linode_id"]
required = ["linode_id"]

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