id       = "kubie"
name     = "kubie"
homepage = "https://github.com/sbstp/kubie"
description = "Much more powerful alternative to kubectx and kubens."
executables   = ["kubie"]

[dotfiles]

# https://github.com/kubie-org/kubie — the Settings section documents the
# user configuration file ~/.kube/kubie.yaml.
paths = ["~/.kube/kubie.yaml"]
secret = []

[commands]
format = 1
label = "Kubie"
description = "Switch Kubernetes context or namespace in an isolated shell. Exec, export and edit subcommands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["ctx"]
label = "Switch context"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/sbstp/kubie/blob/master/README.md"
revision = "master 2026-10-27"
evidence = """
* `kubie ctx` display a selectable menu of contexts
* `kubie ctx <context>` switch the current shell to the given context (spawns a shell if not a kubie shell)
* `kubie ctx <context> -r` spawn a recursive shell in the given context
* `kubie ctx <context> -n <namespace>` spawn a shell in the given context and namespace
"""

[[commands.subcommand.field]]
id = "context"
label = "Context"
description = "Leave empty for a selectable menu."
type = "string"
position = 0
sources = ["readme"]

[[commands.subcommand.field]]
id = "namespace"
label = "Namespace"
type = "string"
option = ["-n"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "recursive"
label = "Spawn a recursive shell"
type = "boolean"
option = ["-r"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "switch"
label = "Switch context"
fields = ["context", "namespace", "recursive"]
required = ["context"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["context", "namespace", "recursive"]

[[commands.subcommand]]
path = ["ns"]
label = "Switch namespace"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/sbstp/kubie/blob/master/README.md"
revision = "master 2026-10-27"
evidence = """
* `kubie ns` display a selectable menu of namespaces
* `kubie ns <namespace>` switch the current shell to the given namespace
* `kubie ns <namespace> -r` spawn a recursive shell in the given namespace
"""

[[commands.subcommand.field]]
id = "namespace"
label = "Namespace"
description = "Leave empty for a selectable menu."
type = "string"
position = 0
sources = ["readme"]

[[commands.subcommand.field]]
id = "recursive"
label = "Spawn a recursive shell"
type = "boolean"
option = ["-r"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "switch"
label = "Switch namespace"
fields = ["namespace", "recursive"]
required = ["namespace"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["namespace", "recursive"]