id = "pvetui"
name = "pvetui"
homepage = "https://github.com/devnullvoid/pvetui"
description = "Terminal UI for Proxmox VE"
executables = ["pvetui"]
[dotfiles]
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"]
