id = "s-search"
name = "s"
homepage = "https://github.com/zquestz/s"
description = "Web search from the terminal."
executables = ["s"]
[dotfiles]
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"]
