id          = "s-search"
name        = "s"
homepage    = "https://github.com/zquestz/s"
description = "Web search from the terminal."
executables      = ["s"]

[dotfiles]

# https://github.com/zquestz/s#configuration — the official README says the
# default UCL configuration is ~/.config/s/config and documents keys such as
# provider, json, binary, and customProviders.
paths = ["~/.config/s/config"]
secret = []

[commands]
format = 1
label = "Web search"
description = "Open a web search in the browser through a chosen provider or tag. The built-in web server mode and TLS options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/zquestz/s"
revision = "2026-10-27"
evidence = """
Usage:
  s <query> [flags]

Flags:
  -b, --binary string       binary to launch search URI
  -j, --json                json output for --list-providers and --list-tags
  -l, --list-providers      list supported providers
      --list-tags           list available tags
  -o, --output              output only mode
  -p, --provider string     search provider (default "brave")
  -t, --tag string          search tag
  -v, --verbose             verbose mode
"""

[[commands.field]]
id = "query"
label = "Query"
type = "string"
position = 0
multiple = true
sources = ["help"]

[[commands.field]]
id = "provider"
label = "Provider"
description = "Search provider; defaults to brave."
type = "string"
option = ["--provider", "-p"]
suggestions = [{ value = "google", label = "Google" }, { value = "wikipedia", label = "Wikipedia" }, { value = "amazon", label = "Amazon" }, { value = "reddit", label = "Reddit" }]
sources = ["help"]

[[commands.field]]
id = "tag"
label = "Tag"
type = "string"
option = ["--tag", "-t"]
suggestions = [{ value = "video", label = "Video" }]
sources = ["help"]

[[commands.field]]
id = "binary"
label = "Browser binary"
description = "Program used to open the search URL."
type = "string"
option = ["--binary", "-b"]
sources = ["help"]

[[commands.field]]
id = "output"
label = "Print URL only"
type = "boolean"
option = ["--output", "-o"]
sources = ["help"]

[[commands.field]]
id = "list_providers"
label = "List providers"
type = "boolean"
option = ["--list-providers", "-l"]
sources = ["help"]

[[commands.field]]
id = "list_tags"
label = "List tags"
type = "boolean"
option = ["--list-tags"]
sources = ["help"]

[[commands.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json", "-j"]
sources = ["help"]

[[commands.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["--verbose", "-v"]
sources = ["help"]

[[commands.task]]
id = "search"
label = "Search"
fields = ["query", "provider", "tag", "binary", "output"]
required = ["query"]

[[commands.task]]
id = "providers"
label = "List providers"
set = { list_providers = [true] }
lock = ["list_providers"]
fields = ["list_providers", "json"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["query", "provider", "tag", "output"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["binary", "list_providers", "list_tags", "json", "verbose"]