id          = "pvetui"
name        = "pvetui"
homepage    = "https://github.com/devnullvoid/pvetui"
description = "Terminal UI for Proxmox VE"
executables      = ["pvetui"]

[dotfiles]

# The project's official README documents ~/.config/pvetui/config.yml on
# Linux/macOS, %APPDATA%/pvetui/config.yml on Windows, and the former Unix path
# as a Windows legacy fallback. The YAML profiles can contain passwords or API
# token secrets, so the whole file is protected.
# https://github.com/devnullvoid/pvetui#configuration
paths  = []
secret = [
  "[configHome]/pvetui/config.yml",
  "%APPDATA%/pvetui/config.yml",
]

[commands]
format = 1
label = "Launch pvetui"
description = "Start the Proxmox VE terminal UI with a chosen config file and profile. Connection credentials and CLI subcommands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/devnullvoid/pvetui#command-line-flags"
revision = "2026-10-27"
evidence = """
| `--config` | `-c` | n/a | Path to YAML config file |
| `--profile` | `-p` | n/a | Connection profile to use (overrides default_profile) |
| `--no-cache` | `-n` | n/a | Disable caching |
| `--config-wizard` | `-w` | n/a | Launch interactive config wizard and exit |
| `--list-profiles` | | n/a | List available connection profiles/groups and exit |
pvetui --startup-page guests
"""

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

[[commands.field]]
id = "profile"
label = "Profile"
description = "Connection profile or group name; overrides default_profile."
type = "string"
option = ["--profile", "-p"]
sources = ["readme"]

[[commands.field]]
id = "no_cache"
label = "Disable caching"
type = "boolean"
option = ["--no-cache", "-n"]
sources = ["readme"]

[[commands.field]]
id = "startup_page"
label = "Startup page"
type = "string"
option = ["--startup-page"]
suggestions = [{ value = "nodes", label = "Nodes" }, { value = "guests", label = "Guests" }, { value = "tasks", label = "Tasks" }, { value = "storage", label = "Storage" }]
sources = ["readme"]

[[commands.field]]
id = "config_wizard"
label = "Run config wizard and exit"
type = "boolean"
option = ["--config-wizard", "-w"]
sources = ["readme"]

[[commands.field]]
id = "list_profiles"
label = "List profiles and exit"
type = "boolean"
option = ["--list-profiles"]
sources = ["readme"]

[[commands.task]]
id = "launch"
label = "Launch with a profile"
fields = ["profile", "config", "startup_page", "no_cache"]
required = []

[[commands.task]]
id = "list"
label = "List profiles"
set = { list_profiles = [true] }
lock = ["list_profiles"]
fields = ["list_profiles", "config"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["profile", "config", "startup_page", "no_cache", "config_wizard", "list_profiles"]