id          = "viddy"
name        = "Viddy"
homepage    = "https://github.com/sachaos/viddy"
description = "Modern watch command."
executables      = ["viddy"]

[dotfiles]

# https://github.com/sachaos/viddy#configuration — the project documents
# $XDG_CONFIG_HOME/viddy.toml and, on macOS, ~/Library/Application Support/
# viddy.toml. The first is the XDG [configHome] spelling; the second is the
# platform-native [appData] spelling.
paths = ["[configHome]/viddy.toml", "[appData]/viddy.toml"]
exclude = []
secret = []
side_effect = false

[commands]
format = 1
label = "Watch a command"
description = "Run a command periodically and browse its output history with diff highlighting. Save/load of history, shell selection and mouse options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/sachaos/viddy/blob/master/src/cli.rs"
revision = "master 2026-10-27"
evidence = """-n, --interval  Seconds to wait between updates (>= 100ms)
-d, --differences  Highlight changes between updates
-D, --deletion-differences  Highlight deletion changes between updates
-p, --precise  Attempt run command in precise intervals
-t, --no-title  Turn off header
-w, --unfold  Turn off line wrapping
-s, --skip-empty-diffs  Skip snapshots with no changes in history
-b, --bell  Ring terminal bell changes between updates
-x, --exec  Pass command to exec instead of sh -c
[COMMAND]...  Command to run"""

[[commands.field]]
id = "interval"
label = "Interval"
description = "Wait between updates, e.g. 2s or 500ms (minimum 100ms)."
type = "string"
option = ["--interval", "-n"]
sources = ["help"]

[[commands.field]]
id = "differences"
label = "Highlight changes"
type = "boolean"
option = ["--differences", "-d"]
sources = ["help"]

[[commands.field]]
id = "deletion_differences"
label = "Highlight deletions"
type = "boolean"
option = ["--deletion-differences", "-D"]
sources = ["help"]

[[commands.field]]
id = "precise"
label = "Precise intervals"
type = "boolean"
option = ["--precise", "-p"]
sources = ["help"]

[[commands.field]]
id = "no_title"
label = "Hide header"
type = "boolean"
option = ["--no-title", "-t"]
sources = ["help"]

[[commands.field]]
id = "unfold"
label = "No line wrapping"
type = "boolean"
option = ["--unfold", "-w"]
sources = ["help"]

[[commands.field]]
id = "skip_empty"
label = "Skip unchanged snapshots"
type = "boolean"
option = ["--skip-empty-diffs", "-s"]
sources = ["help"]

[[commands.field]]
id = "bell"
label = "Ring bell on change"
type = "boolean"
option = ["--bell", "-b"]
sources = ["help"]

[[commands.field]]
id = "exec"
label = "Exec directly (no shell)"
type = "boolean"
option = ["--exec", "-x"]
sources = ["help"]

[[commands.field]]
id = "command"
label = "Command"
type = "string"
position = 0
multiple = true
min = 1
sources = ["help"]

[[commands.task]]
id = "watch"
label = "Watch with diff highlighting"
fields = ["interval", "differences", "command"]
required = ["command"]
set = { differences = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["command", "interval", "differences", "deletion_differences"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["precise", "no_title", "unfold", "skip_empty", "bell", "exec"]